[groff] 07/30: groff_mm(7): Revise `AL`, `RL` macro descriptions.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 0600a2aab6f9bc37f02d6deef1e10192dc59c3bb
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Oct 11 01:34:40 2024 -0500

    groff_mm(7): Revise `AL`, `RL` macro descriptions.
---
 contrib/mm/groff_mm.7.man | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 6c4ad8b97..baa5c7670 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -750,9 +750,8 @@ and
 .BR AL \~[\c
 .IR number-format \~[ text-indent \~[\c
 .BR 1 ]]]
-Begin an auto-incrementing numbered list.
-.
-Item numbers start at one.
+Begin an auto-incrementing numbered list,
+where item numbers start at one and are followed by a dot.
 .
 .I number-format
 assigns the register format
@@ -3367,15 +3366,13 @@ without space between the arguments.
 .BR RL \~[\c
 .IR text-indent \~[\c
 .BR 1 ]]
-Begin reference list.
-.
-Each item is preceded by an automatically incremented number between
-square brackets;
-compare
-.BR AL .
+Begin an auto-incrementing numbered list,
+where item numbers start at one and set between square brackets.
 .
+A
 .I text-indent
-changes the default indentation.
+argument overrides register
+.BR Li .
 .
 A second argument suppresses the vertical space that normally precedes
 each list item;
@@ -3395,6 +3392,11 @@ and
 .B LE
 to end the list.
 .
+\[lq]RL\[rq] is a mnemonic for \[lq]reference list\[rq],
+but this macro has no relationship with
+.IR mm 's
+bibliographic reference list facilities.
+.
 .
 .TP
 .BR RP \~\c \" space in roman; we must use 2-font macro with \c