[groff] 11/24: groff_mm(7): Fix style, content, and markup nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 0e8dd2e76dad6b7fbc33d8148ee0a6618ce71290
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Aug 22 23:21:40 2023 -0500

    groff_mm(7): Fix style, content, and markup nits.
    
    Content:
    * Be clearer that `FC` and `SG` can be used both with letters (`LT`) and
      memoranda (`MT`).  Add cross references.
    * Stop implying that the GNU mm generic "locale" file is still shipped
      (albeit empty); we no longer ship it at all, but the package still
      loads it if present.
    
    Style:
    * Stop presenting "0" with a scaling unit.
    * (SG) Recast.
    
    Markup:
    * Migrate from font selection escape sequences to font style alternation
      macros and `\c`.
---
 contrib/mm/groff_mm.7.man | 49 ++++++++++++++++++++++++++++++-----------------
 1 file changed, 31 insertions(+), 18 deletions(-)

diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 6c8a39cb5..3059a5f4d 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -1529,7 +1529,12 @@ Output the string
 .BR Letfc ,
 or the specified
 .I closing-text,
-as the formal closing of a letter.
+as the formal closing of a letter or memorandum.
+.
+See
+.B LT
+and
+.BR MT .
 .
 .
 .TP
@@ -2355,7 +2360,7 @@ register
 Each item's mark is indented by
 .I mark-indent;
 the default is
-.BR 0n .
+.BR 0 .
 .
 The mark is normally left-aligned.
 .
@@ -3377,25 +3382,34 @@ See
 .BR INITR .
 .
 .TP
-.BI SG\  \fR[\fParg\  \fR[\fP1\fR]]\fP
-Signature line.
-.
-Prints the authors name(s) after the formal closing.
+.BR SG\~ [\c
+.IR arg \~[\c
+.BR 1 ]]
+Write a signature line.
 .
-The argument is appended to the reference data, printed at either the
-first or last author.
+Authors' name(s) are placed after the formal closing;
+see
+.B LT
+and
+.BR MT .
 .
-The reference data is the location, department, and initials specified
-with
-.BR AU .
+Reference data
+(the location,
+department,
+and initials specified in an
+.B AU
+call),
+followed by any
+.IR arg ,
+are written at the left margin preceding the last author's name,
+or preceding the first if a second argument is present and the
+memorandum or letter type supports it.
 .
-It is printed at the first author if the second argument is given,
-otherwise at the last.
+See section \[lq]Internals\[rq] below.
 .
-No reference data is printed if the author(s) is specified through
+No reference data are written for author(s) specified by
 .BR WA / WE .
-.
-See section \[lq]Internals\[rq] below.
+.\" XXX: This has tension with our advice to use only WA/WE with LT.
 .
 .
 .TP
@@ -5373,8 +5387,7 @@ implements memorandum type 5.
 .
 .TP
 .I @TMAC_MDIR@/locale
-performs any (further) desired necessary localization;
-empty by default.
+performs any (further) desired necessary localization if present.
 .
 .
 .\" ====================================================================