gbranden pushed a commit to branch master
in repository groff.
commit bfefdf96cfb1f72791bb80c775e11b0a59b99a23
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Dec 17 14:17:07 2025 -0600
[doc,man]: Fix Savannah #67380.
* doc/groff.texi.in (Other Differences):
* man/groff_diff.7.man (Other differences): Document difference in
timing of output flushes between AT&T and GNU troffs.
Fixes <https://savannah.gnu.org/bugs/?67380>. Thanks to Dave Kemper for
the discussion.
---
ChangeLog | 9 +++++++++
doc/groff.texi.in | 23 +++++++++++++++++++++++
man/groff_diff.7.man | 19 +++++++++++++++++++
3 files changed, 51 insertions(+)
diff --git a/ChangeLog b/ChangeLog
index c620cdc62..9c2c2ce06 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2025-12-17 G. Branden Robinson <[email protected]>
+
+ * doc/groff.texi.in (Other Differences):
+ * man/groff_diff.7.man (Other differences): Document difference
+ in timing of output flushes between AT&T and GNU troffs.
+
+ Fixes <https://savannah.gnu.org/bugs/?67380>. Thanks to Dave
+ Kemper for the discussion.
+
2025-12-10 G. Branden Robinson <[email protected]>
* src/roff/troff/input.cpp (read_input_until_terminator): Fix
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index adf72db57..4fe38e665 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -21013,6 +21013,29 @@ transparent output facility, or, if this is unsuitable,
the new @code{\?} escape sequence. @xref{Diversions} and @ref{Gtroff
Internals}.
+@cindex timing of output flushes, incompatibilities with @acronym{AT&T}
@command{troff}
+@cindex output flushes, timing of, incompatibilities with @acronym{AT&T}
@command{troff}
+@cindex flushing of output, timing of, incompatibilities with @acronym{AT&T}
@command{troff}
+Like @acronym{AT&T}
+@command{troff}, @c AT&T
+GNU
+@command{troff} @c GNU
+maintains a buffer of device-independent output commands,@footnote{In
+GNU
+@command{troff}, @c GNU
+node objects produce these commands;
+recall @ref{Gtroff Internals}.}
+populating the buffer as input accumulates.
+GNU
+@command{troff} @c GNU
+always flushes this buffer when processing a break;
+@acronym{AT&T}
+@command{troff} @c AT&T
+does so according to no obvious schedule
+(perhaps,
+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
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index fd842a81d..1755ab07d 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -6833,6 +6833,25 @@ Texinfo manual.
.
.
.P
+Like
+AT&T
+.I troff, \" AT&T
+GNU
+.I troff \" GNU
+maintains a buffer of device-independent output commands,
+populating the buffer as input accumulates.
+GNU
+.I troff \" GNU
+always flushes this buffer when processing a break;
+AT&T
+.I troff \" AT&T
+does so according to no obvious schedule
+(perhaps,
+if the buffer is of fixed size,
+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,
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
