[groff] 21/30: [mm]: Add new `Rpfmt` string.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit fe58b231234bc5037f76203f7b24861b1bb347ac
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Oct 10 09:30:55 2024 -0500

    [mm]: Add new `Rpfmt` string.
    
    * contrib/mm/m.tmac: Support new `Rpfmt` string specifying the `LB`
      macro arguments that the package uses to format the items in a
      reference list.
    
      (initialization): Define it.
    
      (ref@start-print): Use it.
    
    * contrib/mm/groff_mm.7.man (Macros) <RS>: Cross reference `Rpfmt`
      register description and recast.
    
      (Strings) <Rpfmt>: Document it.
---
 NEWS                      |  4 ++++
 contrib/mm/ChangeLog      | 12 ++++++++++++
 contrib/mm/groff_mm.7.man | 23 ++++++++++++++++++-----
 contrib/mm/m.tmac         |  4 +++-
 4 files changed, 37 insertions(+), 6 deletions(-)

diff --git a/NEWS b/NEWS
index ff94d0b3b..18aee6696 100644
--- a/NEWS
+++ b/NEWS
@@ -458,6 +458,10 @@ Macro packages
    example, a value of "3 4" more accurately reproduces London &
    Reiser's 1978 paper describing the porting of Unix to the VAX-11/780.
 
+*  The m (mm) macro package now supports an `Rpfmt` string specifying
+   the `LB` macro arguments that the package uses to format the items in
+   a reference list.
+
 *  The m (mm) macro package now supports the `E` register as DWB mm did.
 
 *  The m (mm) macro package now supports AT&T/DWB mm's `Rg` string.
diff --git a/contrib/mm/ChangeLog b/contrib/mm/ChangeLog
index 148d5c686..dd56c1d42 100644
--- a/contrib/mm/ChangeLog
+++ b/contrib/mm/ChangeLog
@@ -1,3 +1,15 @@
+2024-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * m.tmac: Support new `Rpfmt` string specifying the `LB` macro
+       arguments that the package uses to format the items in a
+       reference list.
+       (initialization): Define it.
+       (ref@start-print): Use it.
+
+       * groff_mm.7.man (Macros) <RS>: Cross reference `Rpfmt` register
+       description and recast.
+       (Strings) <Rpfmt>: Document it.
+
 2024-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        Make new `LB`-based approach to reference page work both with
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 84b5d92e4..38a33a31b 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -3420,15 +3420,16 @@ automatically if references have accumulated.
 .
 .
 .IP
-References are list items,
-and thus are vertically separated
-(see
-.BR LB ).
+References are formatted as a list with
+.BR LB ;
+the
+.B Rpfmt
+string configures the list's appearance.
 .
 Setting register
 .B Ls
 .RB to\~ 0
-suppresses this spacing.
+suppresses spacing after the list.
 .
 The string
 .B Rp
@@ -4540,6 +4541,18 @@ call.
 .
 .
 .TP
+.B Rpfmt
+specifies the
+.B LB
+arguments that
+.I "groff mm"
+uses to format the items in a reference list.
+.
+The default is
+.RB \[lq] "\[rs]\[rs]n[Li] 0 1 0 \[rs]& 0 0" \[rq].
+.
+.
+.TP
 .B Rg
 interpolates the registered (trade) mark sign.
 .
diff --git a/contrib/mm/m.tmac b/contrib/mm/m.tmac
index 0d95d411d..6812b00ef 100644
--- a/contrib/mm/m.tmac
+++ b/contrib/mm/m.tmac
@@ -375,6 +375,8 @@ http://savannah.gnu.org/bugs/?group=groff.
 .nr Rfstyle 0
 .\" reference list page ejection policy
 .nr Rpe 0
+.\" reference list format (arguments to `LB`)
+.ds Rpfmt \\n[Li] 0 1 0 \& 0\"
 .\" use section-page page numbering?
 .nr Sectp 0
 .if (\n[N]=3):(\n[N]=5) \{\
@@ -3133,7 +3135,7 @@ exceeds depth of nested lists (\\n[li*lvl])
 .\"------------
 .de ref@start-print
 .di ref*div
-.LB \\n[Li] 0 1 0 \& 0\"
+.LB \\*[Rpfmt]
 .LI "\\$1."
 ..
 .\"------------