From 93a08f4dc12693179ec86f2e81d3f8852b737cc7 Mon Sep 17 00:00:00 2001
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Date: Wed, 5 Apr 2023 07:08:16 -0500
Subject: [docs]: Update discussion of ms page titles.

* Mention the special behavior of the % character in titles.
* Characterize traps as a formatter feature.
---
 doc/ms.ms | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

(limited to 'doc/ms.ms')

diff --git a/doc/ms.ms b/doc/ms.ms
index a3573e6b4..fd55fabbe 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -36,8 +36,8 @@
 .nr TC-MARGIN \w'00' \" expect 2-digit page numbers at most
 .ie t .nr PI 3.5n
 .el   .nr PI 4n
-.ND February 2023
-.EH '%''February 2023'
+.ND April 2023
+.EH '%''April 2023'
 .EF ''''
 .OH 'Using \f[I]groff\f[] with the \f[I]ms\f[] macros''%'
 .OF ''''
@@ -3197,9 +3197,14 @@ T}
 .
 .
 .PP
+With either method,
+a percent sign
+.B %
+in header or footer text is replaced by the current page number.
+.
 By default,
 .I ms
-places no header on any page numbered \[lq]1\[rq]
+places no header on a page numbered \[lq]1\[rq]
 (regardless of its number format).
 .
 .
@@ -3246,7 +3251,9 @@ and
 (\[lq]bottom trap\[rq])
 when the footer is to be.
 .
-The page location trap that
+The
+.I groff
+page location trap that
 .I ms
 sets up to format the header also calls the
 (normally undefined)
-- 
cgit v1.2.1