[PATCH 26/31] docs: revise man page footers

"G. Branden Robinson" <[email protected]> Thu, 23 Apr 2026 18:01:09 -0500
Newsgroups	gmane.editors.nano.devel
Message-ID	<20260423230109.sbvx2zsbefmhazwz@illithid>
* Swap order of third (footer-middle) and fourth (footer-inside)
  arguments to align better with preponderant practice.
* Say "nano" instead of "version" in (what is now) the footer-inside
  argument.  While one might infer the provenance of the nano(1) page
  itself from "version 9.0", doing so is more challenging to the novice
  for the nanorc(5) and rnano(1) documents.  Naming the project removes
  all doubt.

groff_man_style(7):
   Document structure macros
     Document structure macros organize a man page’s content.  All break
     the output line.  TH (title heading) initializes the package,
     identifies the document as a man page, and configures the page
     headers and footers.
...
     .TH identifier section [footer‐middle [footer‐inside [header‐
     middle]]]
...
            Do not redefine TH.  Call it prior to any other man macros.
            By convention, footer‐middle is the date of the most recent
            modification to the source document, in ISO 8601 format
            (YYYY‐MM‐DD), and footer‐inside is the name and version or
            release of the project providing it.
---
 doc/nano.1   | 2 +-
 doc/nanorc.5 | 2 +-
 doc/rnano.1  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/nano.1 b/doc/nano.1
index 04a8e0ad..e91487fb 100644
--- a/doc/nano.1
+++ b/doc/nano.1
@@ -16,7 +16,7 @@
 .\"   Documentation License along with this program.  If not, see
 .\"   <https://www.gnu.org/licenses/>.
 .\"
-.TH NANO 1 "version 9.0" "April 2026"
+.TH NANO 1 "April 2026" "nano 9.0"
 .
 .SH NAME
 nano \- Nano's ANOther text editor, inspired by Pico
diff --git a/doc/nanorc.5 b/doc/nanorc.5
index fcebd7f0..4ef5581e 100644
--- a/doc/nanorc.5
+++ b/doc/nanorc.5
@@ -16,7 +16,7 @@
 .\"   Documentation License along with this program.  If not, see
 .\"   <https://www.gnu.org/licenses/>.
 .\"
-.TH NANORC 5 "version 9.0" "April 2026"
+.TH NANORC 5 "April 2026" "nano 9.0"
 .
 .SH NAME
 nanorc \- GNU nano's configuration file
diff --git a/doc/rnano.1 b/doc/rnano.1
index 5dd6bf21..3d2ddab8 100644
--- a/doc/rnano.1
+++ b/doc/rnano.1
@@ -16,7 +16,7 @@
 .\"   Documentation License along with this program.  If not, see
 .\"   <https://www.gnu.org/licenses/>.
 .\"
-.TH RNANO 1 "version 9.0" "April 2026"
+.TH RNANO 1 "April 2026" "nano 9.0"
 .
 .SH NAME
 rnano \- a restricted nano
-- 
2.30.2
signature.asc (application/pgp-signature, 833 B)