groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 04/06: groff_man*(7): Fix content nits.


From: G. Branden Robinson
Subject: [groff] 04/06: groff_man*(7): Fix content nits.
Date: Wed, 6 Oct 2021 16:19:16 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit d7749b6819818a152c90fdc0aa8d710226b41da7
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Oct 7 03:56:12 2021 +1100

    groff_man*(7): Fix content nits.
    
    * Rename "page-section" `MR` parameter to "manual-section", to try to
      avoid confusion with within-page sectioning.
    * [style] In `MR` example, use the manual section name that grops(1)
      actually gets (since it's ./configure-able).
    * Refer to the shipped man.local file as "site-local"; tighten wording.
---
 tmac/groff_man.7.man.in | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 9e182ab..0b8c773 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1176,10 +1176,10 @@ implements
 .
 .
 .TP
-.BI .MR "\~page-title page-section"\c
+.BI .MR "\~page-title manual-section"\c
 .RI \~[ trailing-text ]
 Set a man page cross reference as
-.RI \[lq] page-title ( page-section )\[rq].
+.RI \[lq] page-title ( manual-section )\[rq].
 .
 If
 .I trailing-text
@@ -1196,7 +1196,7 @@ string.
 .
 The cross reference hyperlinks to a URI of the form
 .RB \[lq] man:\c
-.IR page-title ( page-section )\[rq].
+.IR page-title ( manual-section )\[rq].
 .
 .
 _ifstyle()dnl
@@ -1204,7 +1204,7 @@ _ifstyle()dnl
 .IP
 .EX
 The output driver
-\&.MR grops 1
+\&.MR grops @MAN1EXT@
 produces Postscript from
 \&.I troff
 output.
@@ -3427,7 +3427,7 @@ This is a wrapper that loads
 .
 .TP
 .I \%@LOCALMACRODIR@/\:\%man\:\%.local
-Put local changes and customizations into this file.
+Put site-local changes and customizations into this file.
 _ifstyle()dnl
 .
 .
@@ -3456,8 +3456,8 @@ or to permit their override with a user-specific
 .I man.local
 file.
 .
-This can be done by placing one or both of following at the end of
-.IR \%@LOCALMACRODIR@/\:\%man\:\%.local .
+This can be achieved by placing one or both of following requests at the
+end of the site-local file.
 .
 .RS
 .RS



reply via email to

[Prev in Thread] Current Thread [Next in Thread]