[groff] 02/09: doc/groff.texi: Fix content and style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 75b4128edc1009b3d6f0c41e482cba5611251ae8
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun May 21 02:13:18 2023 -0500

    doc/groff.texi: Fix content and style nits.
    
    Content:
    * Improve parallelism between `ce` and `rj` request descriptions,
      documenting the former's behavior when the argument is omitted.
    * Comment out claim dating back to commit e9b0d52dec, 16 May 2000, that
      temporary indentation is ignored when `ce` centering is enabled.  It
      might have been true then, but it was not in groff 1.22.4 nor now.
    * Give `rj` an example.
    
    Style:
    * Fix wordo; thanks to Dave Kemper for catching it.
---
 doc/groff.texi | 44 +++++++++++++++++++++++++++++---------------
 1 file changed, 29 insertions(+), 15 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 46a15a8cc..9b225783d 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -8157,18 +8157,20 @@ Went the day well?
   @result{} Went the day well?
 @endExample
 
-@DefreqList {ce, [@Var{nnn}]}
+@DefreqList {ce, [@Var{n}]}
 @DefregListEndx {.ce}
 @cindex centered text (unfilled)
 @cindex centering lines (@code{ce})
 @cindex lines, centering (@code{ce})
 Break (unless the no-break control character is used), center the output
-of the next @var{nnn} productive input lines with respect to the line
-length and indentation, then break again regarding of the invoking
-control character.  Temporary indentation is ignored.  The count of
-lines remaining to be centered is stored in the read-only register
-@code{.ce} and is associated with the environment
-(@pxref{Environments}).
+of the next @var{n} productive input lines with respect to the line
+length and indentation without filling, then break again regardless of
+the invoking control character.
+@c Temporary indentation is ignored.
+If the argument is not positive, centering is disabled.  Omitting the
+argument implies an @var{n} of @samp{1}.  The count of lines remaining
+to be centered is stored in the read-only register @code{.ce} and is
+associated with the environment (@pxref{Environments}).
 
 @cindex @code{ce} request, difference from @w{@samp{.ad c}}
 While the @w{@samp{.ad c}} request also centers text, it fills the text
@@ -8203,19 +8205,31 @@ counting lines for requests that take a count of input 
lines as an
 argument.
 @endDefreq
 
-@DefreqList {rj, [@Var{nnn}]}
+@DefreqList {rj, [@Var{n}]}
 @DefregListEndx {.rj}
 @cindex justifying text (@code{rj})
 @cindex text, justifying (@code{rj})
 @cindex right-justifying (@code{rj})
 Break (unless the no-break control character is used), align the output
-of the next @var{nnn} productive input lines to the right margin without
-filling, then break again (regardless of the control character).  The
-count of lines remaining to be right-aligned is stored in the read-only
-register @code{.rj} and is associated with the environment
-(@pxref{Environments}).  @var{nnn} specifies the number of lines to
-right-align.  If the argument is not positive, right-alignment is
-disabled.  Omitting the argument implies an @var{nnn} of @samp{1}.
+of the next @var{n} productive input lines to the right margin without
+filling, then break again regardless of the control character.
+@c Temporary indentation is ignored.
+If the argument is not positive, right-alignment is disabled.  Omitting
+the argument implies an @var{n} of @samp{1}.  The count of lines
+remaining to be right-aligned is stored in the read-only register
+@code{.rj} and is associated with the environment
+(@pxref{Environments}).
+
+@Example
+.ll 49n
+.rj 3
+At first I hoped that such a technically unsound
+project would collapse but I soon realized it was
+doomed to success. \[em] C. A. R. Hoare
+    @result{}  At first I hoped that such a technically unsound
+    @result{} project would collapse but I soon realized it was
+    @result{}              doomed to success. -- C. A. R. Hoare
+@endExample
 @endDefreq
 
 @need 2000