gbranden pushed a commit to branch master
in repository groff.
commit 4b8ccb73bee62e62d9e69f5e5ccbed7ce227c499
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Aug 9 05:33:45 2026 -0500
[doc,man]: Slightly reorganize.
Separate discussion of GNU troff extension requests from extension
escape sequences. One's means of dealing with them when composing
portable documents are pretty different, and there's no straightforward
way to query whether an escape sequence is supported. (Should there
be?)
---
doc/groff.texi.in | 7 ++++---
man/groff_diff.7.man | 25 ++++++++++++++++---------
2 files changed, 20 insertions(+), 12 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 04a1daa12..0867cc29b 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -24264,13 +24264,14 @@ Formatters that don't implement
GNU
@command{troff} @c GNU
extension request names
-tend to ignore them,
+tend to ignore them.
@c "Tend" because a macro of a matching name is possible.
-and if they don't support a
+
+If a formatter doesn't support a
GNU
@command{troff} @c GNU
extension escape sequence,
-they are liable to format its function selector character as text.
+it is 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).
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 859af5334..3d770fb06 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -6883,13 +6883,26 @@ Formatters that don't implement
GNU
.I troff \" GNU
extension request names
-tend to ignore them,
+tend to ignore them.
.\" "Tend" because a macro of a matching name is possible.
-and if they don't support a
+.
+The
+.B \[rs]A
+escape sequence
+(see subsection \[lq]Escape sequences\[rq] above)
+or
+.B d
+conditional expression operator
+(see subsection \[lq]Conditional expressions\[rq] above)
+may be helpful in avoiding their use.
+.
+.
+.P
+If a formatter doesn't support a
GNU
.I troff \" GNU
extension escape sequence,
-they are liable to format its function selector character as text.
+it is liable to format its function selector character as text.
.
For example,
.\" NESTED BEGIN Keep in sync with groff_man_style(7).
@@ -6916,12 +6929,6 @@ which both render it as
.\" as of this writing, 2022-08-13
.\" NESTED END Keep in sync with groff_man_style(7).
.
-The
-.B \[rs]A
-escape sequence
-(see subsection \[lq]Escape sequences\[rq] above)
-may be helpful in avoiding their use.
-.
.
.P
AT&T
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
