NEWS.adoc, UPGRADING.adoc: report man page section reorganization [networkupstools#2977]

Signed-off-by: Jim Klimov <[email protected]>

Author: jimklimov

NEWS.adoc

@@ -201,6 +201,10 @@ https://github.com/networkupstools/nut/milestone/9
    * Option to `configure --enable-docs-man-for-progs-built-only` was added,
      to differentiate NUT builds that deliver man pages for only built programs
      (legacy default) or for all of them (as needed for docs sites). [#2976]
+   * Several man page sources revised to tack the correct section code (e.g.
+     `upsc`, `upscmd`, `upsrw` and `NUT-Monitor` are clients that end-users
+     can interact with (section 1), while `upsmon` and `upssched` are rather
+     system services (section 8). [#2977]
 
  - The `BUILD_TYPE=default-all-errors ci_build.sh` script handling was
    revised to simplify code, and to default in CI builds to a quicker

UPGRADING.adoc

@@ -40,6 +40,11 @@ Changes from 2.8.3 to 2.8.4
   to differentiate NUT builds that deliver man pages for only built programs
   (legacy default) or for all of them (as needed for docs sites). [#2976]
 
+- Man pages for `upsc`, `upscmd`, `upsrw` and `NUT-Monitor` were consistently
+  assigned to man page section 1 (end-user programs).  This may require some
+  changes in packaging recipes to deliver built pages with a different filename
+  extension and/or into different directories. [#2977]
+
 - Added APC BVKxxxM2 to list of devices where `lbrb_log_delay_sec=N` may be
   necessary to address spurious LOWBATT and REPLACEBATT events. [issue #2942]