NEWS.adoc, UPGRADING.adoc: report recent documentation/recipe improvements [networkupstools#2977]

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

Author: jimklimov

NEWS.adoc

@@ -183,16 +183,24 @@ https://github.com/networkupstools/nut/milestone/9
  - NUT Monitor GUI:
    * Ported Python 3 version to Qt6, now shipped alongside Qt5 for systems
      with either or both, maximizing compatibility with old and new setups.
-
- - Introduced handling (possibly rewriting) for man page section "Overviews,
-   conventions, and miscellaneous" (commonly number 7), to deliver support
-   for `man nut` queries (NUT overview manual page also created). [#2945]
-
- - A new `configure --with-docs-man-dir-as-base` option was introduced so
-   that directories for man page sections can now be automatically named
-   as either "base" number of the section (e.g. `man1`) or by full section
-   name (`man1m`), as different OS distributions have different preferences
-   in this regard. [#2950]
+     [#2946]
+
+ - Manual page recipes and contents:
+   * Introduced handling (possibly rewriting) for man page section "Overviews,
+     conventions, and miscellaneous" (commonly number 7), to deliver support
+     for `man nut` queries (NUT overview manual page also created). [#2945]
+   * A new `configure --with-docs-man-dir-as-base` option was introduced so
+     that directories for man page sections can now be automatically named
+     as either "base" number of the section (e.g. `man1`) or by full section
+     name (`man1m`), as different OS distributions have different preferences
+     in this regard. [#2950]
+   * 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

@@ -36,6 +36,15 @@ Changes from 2.8.3 to 2.8.4
   As a packager, you may have to update the recipes accordingly (especially
   if your platform rewrites section numbers). [#2945, #2950]
 
+- 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]
+
+- 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]