[groff] 03/10: groff_man*(7): Reduce redundancy.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit b0c783e51913add350112b626e9a62c06827df46
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Sep 16 22:25:23 2020 +1000

    groff_man*(7): Reduce redundancy.
    
    Undocument \*(AD and \*(HY in subsection "Strings", since they're
    already documented in section "Options".  Also, they're not part of the
    page authors' interface to the macro package, but rather the page
    _readers'_ interface.  Add internal cross-reference.
    
    Also this makes the page(s) shorter.
    
    Recast description of \n(SN to be less jarring; there's no reason to
    suggest that a page has only one subsection heading (usually there are
    zero or several).
---
 tmac/groff_man.7.man.in | 28 ++++++----------------------
 1 file changed, 6 insertions(+), 22 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index a871b69..3baade9 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1919,7 +1919,11 @@ see section \(lqFiles\(rq below.
 .SS Strings
 .\" ====================================================================
 .
-The following strings are defined.
+The following strings are defined for use in man pages.
+.
+Others are supported for configuration of rendering parameters;
+see section \(lqOptions\(rq below.
+.
 .
 .
 .TP
@@ -1938,26 +1942,6 @@ expands to an escape setting the point size to the 
document default.
 .
 .
 .TP
-.B \e*(AD
-expands to the default adjustment mode;
-see section \(lqOptions\(rq below for the default.
-.
-This string is a GNU extension\" from groff 1.22.5
-to support user customization of man page rendering,
-and should not be used in man page sources.
-.
-.
-.TP
-.B \e*(HF
-expands to the font identifier used to print headings and subheadings;
-see section \(lqOptions\(rq below for the default.
-.
-This string is a GNU extension\" from groff 1.19
-to support user customization of man page rendering,
-and should not be used in man page sources.
-.
-.
-.TP
 .B \e*(lq
 .TQ
 .B \e*(rq
@@ -3050,7 +3034,7 @@ See subsection \(lqFont style macros\(rq above for the 
default.
 .
 .TP
 .BI \-rSN= subsection-indent
-Set indentation of the subsection heading to
+Set indentation of subsection headings to
 .IR subsection-indent .
 .
 See subsection \(lqHorizontal and vertical spacing\(rq above for the