gbranden pushed a commit to branch master
in repository groff.

commit 7f5c4dbbe8d43c4a441b7ad72c530c5213e2c3af
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Dec 25 23:50:00 2025 -0600

    [doc,man]: Sync "Other differences" material.
---
 doc/groff.texi.in    | 25 ++++++++++++++++++-------
 man/groff_diff.7.man | 21 +++++++++++----------
 2 files changed, 29 insertions(+), 17 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index b35b853ec..89e6ba8c9 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -20657,6 +20657,7 @@ to behave in ways difficult to predict.
 @node Other Differences, , Compatibility Mode, Implementation Differences
 @subsection Other Differences
 
+@c BEGIN Keep in sync with groff_diff(7).
 Other
 @command{troff} @c generic
 formatters that don't implement request names that are
@@ -20670,10 +20671,10 @@ extension escape sequence,
 they are liable to format its function selector character as text.
 @cindex @code{\~}, incompatibilities with @acronym{AT&T} @code{troff}
 For example,
+@c NESTED BEGIN Keep in sync with groff_man_style(7).
 the adjustable,
 non-breaking space escape sequence
 @code{\~}
-@c BEGIN Keep in sync with groff_diff(7) and groff_man_style(7).
 is also supported by Heirloom Doctools
 @command{troff} @c Heirloom
 050915 (September 2005),
@@ -20691,7 +20692,7 @@ or Documenter's Workbench
 which both render it as
 @samp{~}.
 @c as of this writing, 2022-08-13
-@c END Keep in sync with groff_diff(7) and groff_man_style(7).
+@c NESTED END Keep in sync with groff_man_style(7).
 @xref{Manipulating Filling and Adjustment}.
 GNU
 @command{troff}'s @c GNU
@@ -21129,11 +21130,21 @@ does so according to no obvious schedule
 if the buffer is of fixed size,
 the formatter performs the flush when the buffer runs out of room).
 
-In the somewhat pathological case where a diversion exists containing a
-partially collected line and a partially collected line at the top-level
-diversion has never existed, @acronym{AT&T} @code{troff} outputs a
-partially collected but otherwise empty line (as if @samp{\c} were in
-the top-level diversion) at the end of input; GNU @code{troff} does not.
+In the somewhat pathological case where a diversion exists
+containing a partially collected line
+and a partially collected line at the top-level diversion
+has never existed,
+@acronym{AT&T}
+@command{troff} @c AT&T
+outputs a partially collected but otherwise empty line
+(as if
+@samp{\c}
+were in the top-level diversion)
+at the end of input;
+GNU
+@command{troff} @c GNU
+does not.
+@c END Keep in sync with groff_diff(7).
 
 
 
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 74ab82af9..8ecbab531 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -6388,6 +6388,7 @@ McIlroy referred to it as a \[lq]living fossil\[rq].]
 .SH "Other differences"
 .\" ====================================================================
 .
+.\" BEGIN Keep in sync with groff.texi node "Other Differences".
 Other
 .I troff \" generic
 formatters that don't implement request names that are
@@ -6401,11 +6402,10 @@ extension escape sequence,
 they are liable to format its function selector character as text.
 .
 For example,
+.\" NESTED BEGIN Keep in sync with groff_man_style(7).
 the adjustable,
 non-breaking space escape sequence
 .B \[rs]\[ti]
-.\" BEGIN Keep in sync with groff.texi node "Other Differences" and
-.\" groff_man_style(7).
 is also supported by Heirloom Doctools
 .I troff \" Heirloom
 050915 (September 2005),
@@ -6424,8 +6424,7 @@ or Documenter's Workbench
 which both render it as
 .RB \[lq] \[ti] \[rq].
 .\" as of this writing, 2022-08-13
-.\" END Keep in sync with groff.texi node "Other Differences" and
-.\" groff_man_style(7).
+.\" NESTED END Keep in sync with groff_man_style(7).
 .
 The
 .B \[rs]A
@@ -6892,19 +6891,21 @@ the formatter performs the flush when the buffer runs 
out of room).
 .
 .
 .P
-In the somewhat pathological case where a diversion exists containing a
-partially collected line and a partially collected line at the top-level
-diversion has never existed,
+In the somewhat pathological case where a diversion exists
+containing a partially collected line
+and a partially collected line at the top-level diversion
+has never existed,
 AT&T
-.I troff
-will output a partially collected but otherwise empty line
+.I troff \" AT&T
+outputs a partially collected but otherwise empty line
 (as if
 .RB \[lq] \[rs]c \[rq]
 were in the top-level diversion)
 at the end of input;
 GNU
 .I troff \" GNU
-will not.
+does not.
+.\" END Keep in sync with groff.texi node "Other Differences".
 .
 .
 .\" ====================================================================

_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit

Reply via email to