gbranden pushed a commit to branch master
in repository groff.

commit 14829adb8699cdf7a9fe95cafa2896033347f929
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Mar 16 23:02:31 2022 +1100

    [ms]: Fix documentation content nit.
    
    Be a little more clear about traps; since we have to mention one, might
    as well be more forthcoming about what it's for.
    
    Drop comment complaining of bug; my rage has abated now that Savannah
    ticket #62191 is fixed.
---
 doc/groff.texi      | 2 +-
 doc/ms.ms           | 7 ++-----
 tmac/groff_ms.7.man | 6 ++----
 3 files changed, 5 insertions(+), 10 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 839da282..c6c29d9f 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -4087,7 +4087,7 @@ redefinition of the macros that are called when the 
@code{groff} traps
 that ordinarily cause the headers and footers to be output are sprung.
 @code{PT} (``page trap'') is called by @file{ms} when the header is to
 be written, and @code{BT} (``bottom trap'') when the footer is to be.
-The @code{groff} trap that @file{ms} sets up to process the header also
+The page location trap that @file{ms} sets up to format the header also
 calls the (normally undefined) @code{HD} macro after @code{PT}; you can
 define @code{HD} if you need additional processing after setting the
 header (for example, to draw a line below it).  The @code{HD} hook is a
diff --git a/doc/ms.ms b/doc/ms.ms
index 8fdc6b58..dca514e0 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -2679,11 +2679,9 @@ and
 (\[lq]bottom trap\[rq])
 when the footer is to be.
 .
-The
-.I roff
-trap that
+The page location trap that
 .I ms
-sets up to process the header also calls the
+sets up to format the header also calls the
 (normally undefined)
 .CW HD
 macro after
@@ -2894,7 +2892,6 @@ resets the page number
 .B i "" to\~
 (Roman numeral one),
 and then calls
-.\" XXX ".BR PX ." here throws diagnostic with WRONG LINE NUMBER
 .CW PX .
 .
 .
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index c44b757a..827d97dd 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1789,11 +1789,9 @@ and
 (\[lq]bottom trap\[rq])
 when the footer is to be.
 .
-The
-.I roff
-trap that
+The page location trap that
 .I ms
-sets up to process the header also calls the
+sets up to format the header also calls the
 (normally undefined)
 .B HD
 macro after

_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit

Reply via email to