[groff] 03/03: doc/groff.texi, groff(7): Fix recent error.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit ba4c88e5741d05e7edd265c09b0073e7220cc71c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jan 26 03:00:59 2021 +1100

    doc/groff.texi, groff(7): Fix recent error.
    
    I was wrong to document .na and ".ad l" as synonymous in commits
    0f7e6a8b and e79f5314 on 24 January; they have the same visible effect
    on text, but they alter the .j register (which encodes both adjustment
    mode and adjustment enablement status) differently.
    
    Thanks to Bjarni Ingi Gislason for the close review.
---
 ChangeLog       |  4 ++--
 doc/groff.texi  | 11 ++++-------
 man/groff.7.man | 14 ++------------
 3 files changed, 8 insertions(+), 21 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 75f6ee3..cf80715 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -17,10 +17,10 @@
 
        * doc/groff.texi (Manipulating Filling and Adjustment):
        * man/groff.7 (Requests/Request short reference): Clarify
-       synonymy of ".na" and ".ad l".
+       behavior of ".na" and ".ad l".
 
        Thanks to Bjarni Ingi Gislason for pointing out the potential
-       for confusion.
+       for confusion and for his careful review of the new text.
 
        Fixes <https://savannah.gnu.org/bugs/?59795>.
 
diff --git a/doc/groff.texi b/doc/groff.texi
index 1241a96..c496272 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -6871,10 +6871,7 @@ text without filling.
 @item l
 @cindex ragged-right text
 Adjust text to the left margin, producing what is sometimes called
-ragged-right text.  Due to the way @code{roff} systems traditionally
-implement adjustment, it can be helpful to think of @w{@samp{.ad l}} as
-``no adjustment'', or as a synonym for the @code{na} request (see
-below).
+ragged-right text.
 
 @item r
 @cindex ragged-left text
@@ -6938,9 +6935,9 @@ detail and should not be relied upon as a programmer's 
interface.
 @endDefreq
 
 @Defreq {na, }
-Disable adjustment.  This is synonymous with the request
-@w{@samp{.ad l}}; the value of the adjustment mode register @code{.j}
-is not changed.
+Disable adjustment.  This looks the same as adjustment to the left
+margin, but the value of the adjustment mode register @code{.j} is not
+changed.
 
 The adjustment mode and enablement status are associated with the
 current environment (@pxref{Environments}).
diff --git a/man/groff.7.man b/man/groff.7.man
index d531a65..3d925d6 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1185,19 +1185,13 @@ Enable output line adjustment in current mode
 Adjust output lines in mode
 .I c
 .RI ( c =\c
-.BR b , c , n , r ).
+.BR b , c , l , n , r ).
 .
 Sets
 .BR \[rs]n[.j] .
 .
 .
 .TPx
-.REQ ".ad l"
-Same as
-.RB \[lq] ".na" \[rq].
-.
-.
-.TPx
 .REQ .af "register c"
 Assign format
 .I c
@@ -2203,11 +2197,7 @@ is searched in the tmac directories.
 .
 .TPx
 .REQ .na
-No adjustment.
-.
-Do not adjust output lines;
-same as
-.RB \[lq] ".ad l" \[rq].
+Disable line adjustment.
 .
 .
 .TPx