gbranden pushed a commit to branch master
in repository groff.

commit 6bd649ad63ffe9d0dadd34328ca7f88619d68806
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Fri Mar 14 20:26:25 2025 -0500

    [doc,man]: Clarify AT&T/GNU adjustment behavior.
    
    Sync language and line breaks between our Texinfo manual and
    groff_diff(7) man page.
---
 doc/groff.texi.in    | 16 +++++++++++-----
 man/groff_diff.7.man |  8 +++++---
 2 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index dde7e6528..aaf307797 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -18363,11 +18363,17 @@ dummy character escape sequence @code{\&} is more 
portable.
 
 @cindex adjustment to both margins, difference from @acronym{AT&T} @code{troff}
 @cindex rivers
-When adjusting to both margins, @acronym{AT&T} @code{troff} at first
-adjusts spaces starting from the right; GNU @code{troff} begins from
-the left.  Both implementations adjust spaces from opposite ends on
-alternating output lines in this adjustment mode to prevent ``rivers''
-in the text.
+When adjusting output lines to both margins,
+@acronym{AT&T}
+@command{troff} @c AT&T
+at first adjusts spaces starting from the right;
+GNU
+@command{troff} @c GNU
+begins from the left.
+Both implementations adjust spaces
+from opposite ends on alternating output lines
+in this adjustment mode
+to prevent ``rivers'' in the text.
 
 @cindex hyphenation, incompatibilities with @acronym{AT&T} @code{troff}
 GNU @command{troff} does not always hyphenate words as @acronym{AT&T}
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 644fbb259..a9b9fec24 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -5919,7 +5919,7 @@ is more portable.
 .
 .
 .P
-When adjusting to both margins,
+When adjusting output lines to both margins,
 AT&T
 .I troff \" AT&T
 at first adjusts spaces starting from the right;
@@ -5927,8 +5927,10 @@ GNU
 .I troff \" GNU
 begins from the left.
 .
-Both implementations adjust spaces from opposite ends on alternating
-output lines to prevent \[lq]rivers\[rq] in the text.
+Both implementations adjust spaces
+from opposite ends on alternating output lines
+in this adjustment mode
+to prevent \[lq]rivers\[rq] in the text.
 .
 .
 .P

_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit

Reply via email to