[groff] 06/36: groff_mm(7): Simplify internal cross references.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 63dcf25193f97986a33ea67b6dbc9ccfd95e851e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Jan 15 01:03:06 2023 -0600

    groff_mm(7): Simplify internal cross references.
    
    Introduce mm's naming convention, which unfortunately is a bit sloppy.
    
    (If you guessed that I'd like to reform mm to be more consistent in this
    regard, you're correct.)
---
 contrib/mm/groff_mm.7.man | 28 +++++++++++++++++++++-------
 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 6e6902639..2f99c7571 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -9,7 +9,7 @@ groff_mm \- memorandum macros for GNU
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2022 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2023 Free Software Foundation, Inc.
 .\"
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
@@ -167,6 +167,20 @@ and
 strings.
 .
 .
+.P
+Macro,
+register,
+and string descriptions in this page frequently mention each other;
+most cross references are to macros.
+.
+Where a register or string is referenced,
+its type is explicitly identified;
+.
+.IR mm 's
+macro names are usually in full capitals;
+registers and strings tend to have mixed-case names.
+.
+.
 .\" ====================================================================
 .SS Localization
 .\" ====================================================================
@@ -1359,7 +1373,7 @@ is 10.
 .TP
 .B FE
 Footnote end;
-see macro
+see
 .BR FS .
 .
 .
@@ -3998,14 +4012,14 @@ is in use
 .TP
 .B :p
 is an auto-incrementing footnote counter;
-see macro
+see
 .BR FS .
 .
 .
 .TP
 .B :R
 is an auto-incrementing reference counter;
-see macro
+see
 .BR RS .
 .
 .
@@ -4155,14 +4169,14 @@ and to the right if 0 (default).
 .TP
 .B Ex
 auto-incrementing exhibit counter;
-see macro
+see
 .B EX
 .
 .
 .TP
 .B Fg
 auto-incrementing figure counter;
-see macro
+see
 .B FG
 .
 .
@@ -4176,7 +4190,7 @@ Default is\~1.
 .TP
 .BR H1 \|.\|.\|.\| H14
 auto-incrementing heading counters;
-see macro
+see
 .B H
 .
 .