gbranden pushed a commit to branch master
in repository groff.
commit 4c5ec9f39506b7df52d2bffecfd95a6e6550aa54
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Dec 26 00:01:29 2025 -0600
[doc,man]: Document a portability caveat.
C0 controls are not portable in identifiers. Only GNU troff diagnoses
this phenomenon, though.
Also add poor man's keep to groff_diff(7).
---
doc/groff.texi.in | 19 +++++++++++++++++++
man/groff_diff.7.man | 24 ++++++++++++++++++++++++
2 files changed, 43 insertions(+)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 3c9ac41d7..313a4e569 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -20658,6 +20658,25 @@ to behave in ways difficult to predict.
@subsection Other Differences
@c BEGIN Keep in sync with groff_diff(7).
+Use of C0 control characters in identifiers is not portable;
+Solaris,
+Plan@tie{}9,
+and Heirloom Doctools
+@command{troff}s @c Solaris, Plan 9, Heirloom
+accept
+@key{Control+B},
+@key{Control+C},
+@key{Control+E},
+@key{Control+F},
+and
+@key{Control+G} (only),
+DWB@tie{}3.3
+@command{troff} @c DWB
+does not.
+GNU
+@command{troff} @c GNU
+rejects C0 controls in identifiers with an error diagnostic.
+
Formatters that don't implement request names that are
GNU
@command{troff} @c GNU
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 506dede4f..6e9e0346a 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -6389,6 +6389,28 @@ McIlroy referred to it as a \[lq]living fossil\[rq].]
.\" ====================================================================
.
.\" BEGIN Keep in sync with groff.texi node "Other Differences".
+Use of C0 control characters in identifiers is not portable;
+Solaris,
+Plan\~9,
+and Heirloom Doctools
+.IR troff s \" Solaris, Plan 9, Heirloom
+accept
+Control+B,
+Control+C,
+Control+E,
+Control+F,
+and
+Control+G (only),
+DWB\~3.3
+.I troff \" DWB
+does not.
+.
+GNU
+.I troff \" GNU
+rejects C0 controls in identifiers with an error diagnostic.
+.
+.
+.P
Formatters that don't implement request names that are
GNU
.I troff \" GNU
@@ -6462,6 +6484,8 @@ in this adjustment mode
to prevent \[lq]rivers\[rq] in the text.
.
.
+.br
+.ne 2v
.P
GNU
.I troff \" GNU
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
