gbranden pushed a commit to branch master
in repository groff.

commit d29b3a3b07686ae5bffcba61321d393440a29253
Author: G. Branden Robinson <[email protected]>
AuthorDate: Mon Jan 12 09:32:45 2026 -0600

    [doc,man]: Document an AT&T/GNU troff difference.
    
    ...another one of long standing.
---
 doc/groff.texi.in    | 15 +++++++++++++++
 man/groff_diff.7.man | 19 +++++++++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index a00250aba..d1376a36a 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -21556,6 +21556,21 @@ to behave in ways difficult to predict.
 @subsection Other Differences
 
 @c BEGIN Keep in sync with groff_diff(7).
+GNU
+@command{troff} @c GNU
+does not emit output if it has nothing to format.
+For example,
+it treats an input document consisting solely of
+@code{nr}
+and
+@code{tm}
+requests as empty,
+and produces nothing on its standard output stream.
+@acronym{AT&T}
+@code{troff} @c AT&T
+does,
+creating a blank page.
+
 Use of C0 control characters in identifiers is not portable;
 Solaris,
 Plan@tie{}9,
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 80eb77dbc..0269fc64b 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -6438,6 +6438,25 @@ McIlroy referred to it as a \[lq]living fossil\[rq].]
 .\" ====================================================================
 .
 .\" BEGIN Keep in sync with groff.texi node "Other Differences".
+GNU
+.I troff \" GNU
+does not emit output if it has nothing to format.
+.
+For example,
+it treats an input document consisting solely of
+.B nr
+and
+.B tm
+requests as empty,
+and produces nothing on its standard output stream.
+.
+AT&T
+.I troff \" AT&T
+does,
+creating a blank page.
+.
+.
+.P
 Use of C0 control characters in identifiers is not portable;
 Solaris,
 Plan\~9,

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

Reply via email to