[groff] 35/44: [doc,man]: Clarify and sync `.lsm` meaning.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 192e0f51ed97080c616c3109a79f44c6539a1df5
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Sep 3 04:35:04 2024 -0500

    [doc,man]: Clarify and sync `.lsm` meaning.
---
 doc/groff.texi.in    | 18 ++++++++++--------
 man/groff_diff.7.man | 44 ++++++++++++++++++++++++++++----------------
 2 files changed, 38 insertions(+), 24 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 887c97506..c057d031e 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -15249,16 +15249,18 @@ the default blank line behavior is (re-)established.
 @DefregListEndx {lss}
 @cindex leading spaces macro (@code{lsm})
 Set a leading space trap, calling the macro @var{name} when GNU
-@code{troff} encounters leading spaces in an input line; the implicit
-line break that normally happens in this case is suppressed.  If no
-argument is supplied, the default leading space behavior is
-(re-)established (@pxref{Breaking}).
-
-The count of leading spaces on an input line is stored in register
+@command{troff} encounters leading spaces on a text line; the implicit
+line break that normally happens in this case is suppressed.  The
+formatter stores the count of leading spaces on text line in register
 @code{lsn}, and the amount of corresponding horizontal motion in
 register @code{lss}, irrespective of whether a leading space trap is
-set.  When it is, the leading spaces are removed from the input line,
-and no motion is produced before calling @var{name}.
+set.  When it is, GNU @command{troff} removes the leading spaces from
+the input line and produces no motion before calling @var{name}.
+
+If no argument is supplied, GNU @command{troff} re�stablishes the
+default handling of leading spaces on text lines (breaking the line when
+filling, and formatting a horizontal motion of @samp{\n[lsn]} word
+spaces).
 
 @c XXX The following discussion does not seem to be correct; leading
 @c space traps don't "see" _any_ tokens.  Nothing on the line is
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index dcd5ae914..3ee014e83 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3091,29 +3091,41 @@ line.
 .TP
 .BR .lsm\~ [\c
 .IR name ]
-Set the leading space macro (trap) to
-.IR name .
-.
-If there are leading space characters on an input line,
+Set a leading space trap,
+calling the macro
 .I name
-is invoked in lieu of the usual
-.I roff
-behavior;
-the leading spaces are removed.
-.
-The count of leading spaces on an input line is stored in
-.BR \[rs]n[lsn] ,
-and the amount of corresponding horizontal motion in
-.BR \[rs]n[lss] ,
+when GNU
+.I troff \" GNU
+encounters leading spaces on a text line;
+the implicit line break that normally happens in this case
+is suppressed.
+.
+The formatter stores the count of leading spaces on text line
+in register
+.BR lsn ,
+and the amount of corresponding horizontal motion
+in register
+in register
+.BR lss ,
 irrespective of whether a leading space trap is set.
 .
 When it is,
-the leading spaces are removed from the input line,
-and no motion is produced before calling
+GNU
+.I troff \" GNU
+removes the leading spaces from the input line
+and produces no motion before calling
 .IR name .
 .
+.
+.IP
 If no argument is supplied,
-the default leading space behavior is (re-)established.
+GNU
+.I troff \" GNU
+re\[e ad]stablishes the default handling of leading spaces on text lines
+(breaking the line when filling,
+and formatting a horizontal motion of
+.B \[rs]n[lsn]
+word spaces).
 .
 .
 .TP