[groff] 39/39: groff(7): Clarify several points.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit dbb3a589698484c6b367df516167555ce51f053b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Oct 9 22:06:05 2022 -0500

    groff(7): Clarify several points.
    
    * Define `ll` request more clearly; it does _not_ affect the pending
      output line.
    * Migrate terminology: "scaling indicator" ->  "scaling unit".
    * Document function of `lt` request without argument.
    * <\x, .\n[.in], \n[.ll]>: Speak of "pending", not "current" output
      line.
    * Recast presentation of indentation-related requests and registers.
---
 man/groff.7.man | 44 ++++++++++++++++++++++++--------------------
 1 file changed, 24 insertions(+), 20 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index f9c974b37..a443de5f4 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3177,19 +3177,17 @@ until
 is called at the start of a control line in the current conditional
 block.
 .
-.
 .TPx
 .REQ .in
-Change to previous indentation value.
+Set indentation amount to previous value.
 .
 .TPx
 .REQ .in "\[+-]N"
-Change indentation according to
+Set indentation to
 .I \[+-]N
-(default scaling indicator\~\c
+(default scaling unit\~\c
 .scaleindicator m ).
 .
-.
 .TPx
 .REQ .it "n name"
 Set an input trap,
@@ -3272,18 +3270,17 @@ Ligature mode on if
 .
 .TPx
 .REQ .ll
-Change to previous line length.
+Set length of subsequent output lines to previous value.
 .
 .TPx
 .REQ .ll "\[+-]N"
-Set line length according to
+Set length of subsequent output lines to
 .I \[+-]N
 (default length
 .scalednumber 6.5 i ,
-default scaling indicator\~\c
+default scaling unit\~\c
 .scaleindicator m ).
 .
-.
 .TPx
 .REQ .lsm
 Unset the leading space macro (trap).
@@ -3310,8 +3307,15 @@ i.e.,
 blank lines are inserted after each text output line.
 .
 .TPx
+.REQ .lt
+Set length of title lines to previous value.
+.
+.TPx
 .REQ .lt "\[+-]N"
-Length of title (default scaling indicator\~\c
+Set length of title lines
+(default length
+.scalednumber 6.5 i ,
+default scaling unit\~\c
 .scaleindicator m ).
 .
 .TPx
@@ -3921,10 +3925,10 @@ Set tab repetition glyph
 .RI to\~ c
 (default: none).
 .
-.
 .TPx
 .REQ .ti "\[+-]N"
-Temporary indent next line (default scaling indicator\~\c
+Temporarily indent next output line
+(default scaling unit\~\c
 .scaleindicator m ).
 .
 .TPx
@@ -4964,7 +4968,7 @@ formatted in a dummy environment.
 .
 .TP
 .ESCq x N
-Increase vertical spacing of current output line by
+Increase vertical spacing of pending output line by
 .IR N \~vees
 (or specified units;
 negative before,
@@ -5403,11 +5407,14 @@ The hyphenation space adjustment threshold in the 
current environment.
 .
 .TPx
 .REG .i
-Current indentation.
+Indentation.
 .
 .TPx
 .REG .in
-The indentation that applies to the current output line.
+Indentation applicable to the pending output line;
+see
+.request .ti
+request.
 .
 .TPx
 .REG .int
@@ -5455,14 +5462,11 @@ request).
 .
 .TPx
 .REG .ll
-The line length that applies to the current output line.
+Line length of the pending output line.
 .
 .TPx
 .REG .lt
-The title length (as set by the
-.request .lt
-request).
-.
+Title length.
 .
 .TPx
 .REG .m