[groff] 07/09: man pages: Fix content nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit cc18fc3cc856a4db1d688465b260e79932a1f04e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Apr 29 20:22:48 2021 +1000

    man pages: Fix content nits.
    
    * man/groff.7.man (Registers/Read-only registers) <.j>: Replace list of
      values with counsel not to interpret or perform arithmetic on
      interpolated value, to aid portability to roff implementations.
    * man/groff_diff.7.man (Implementation Differences): Sync with our
      Texinfo manual.
---
 man/groff.7.man      | 10 +++++++---
 man/groff_diff.7.man | 31 +++++++++++++++++++++++++++++--
 2 files changed, 36 insertions(+), 5 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index dc83b9c..3b99a04 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4460,16 +4460,20 @@ The indentation that applies to the current output line.
 Positive if last output line contains
 .esc c .
 .
+.
 .TPx
 .REG .j
-The current adjustment mode.
-It can be stored and used to set adjustment.
-(n\ =\ 1, b\ =\ 1, l\ =\ 0, r\ =\ 5, c\ =\ 3).
+Adjustment mode encoded as an integer.
+.
+Do not interpret or perform arithmetic on its value.
+.
 .
 .TPx
 .REG .k
 The current horizontal output position (relative to the current
 indentation).
+.
+.
 .TPx
 .REG .kern
 1\~if pairwise kerning is enabled, 0\~otherwise.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 90c3ed0..dc8a79d 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -4539,6 +4539,19 @@ have become supported by other implementations.
 .
 .
 .P
+When adjusting to both margins,
+AT&T
+.I troff \" AT&T
+at first stretches spaces starting from the right;
+.I \%@g@troff
+begins from the left.
+.
+Both implementations stretch spaces from opposite ends on alternating
+output lines in this adjustment mode to prevent \[lq]rivers\[rq] in the
+text.
+.
+.
+.P
 .I groff
 does not always hyphenate words as
 .RI AT&T\~ troff
@@ -4584,7 +4597,7 @@ also interprets
 .B \[rs]*[
 and
 .B \[rs]n[
-as a reference to a string or number register,
+as an interpolation of a string or number register,
 respectively,
 called
 .RB \[lq] [ \[rq].
@@ -4690,7 +4703,7 @@ at the beginning of your file,
 followed by
 .RS
 .EX
-\&.cp _my_saved_C
+\&.cp \[rs]n[_my_saved_C]
 .EE
 .RE
 at the end.
@@ -4855,6 +4868,20 @@ above.
 .
 .
 .P
+The
+.B .bp
+request differs from AT&T
+.IR troff : \" AT&T
+GNU
+.I troff \" GNU
+does not accept a scaling indicator on the argument,
+a page number;
+the former
+(somewhat uselessly)
+does.
+.
+.
+.P
 In
 .RI AT&T\~ troff
 the