gbranden pushed a commit to branch master
in repository groff.
commit 6549b7c3d4db4dd0ee65aada318e32b2b0c057f8
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Nov 12 19:23:59 2025 -0600
[doc,man]: Document delimiter oddities.
---
doc/groff.texi.in | 41 +++++++++++++++++++++++++++++++++++++++++
man/groff_diff.7.man | 47 +++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 88 insertions(+)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index b83d0a2c7..20c2c2d5d 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -19845,6 +19845,47 @@ Thus they work as expected
even if the interpolation context disables compatibility mode.
@c END Keep in sync with groff_diff(7), subsection "Altered requests".
+@c BEGIN Keep in sync with groff_diff(7), subsection "Delimiters".
+@acronym{AT&T}
+@code{troff} @c AT&T
+recognized slightly varying sets of delimiters when expecting
+numerical expressions
+(as with the
+@code{\h}
+escape sequence),
+string expressions
+(as with the
+@code{\w}
+escape sequence),
+and output comparisons
+(as in
+@samp{.if #foo#bar# .tm match}).
+GNU
+@command{troff}, @c GNU
+when not in compatibility mode,
+recognizes a single consistent set of delimiters.
+Compatibility mode
+emulates
+@acronym{AT&T}
+@code{troff} @c AT&T
+only up to a point.
+GNU
+@command{troff} @c GNU
+accepts leaders and tabs as delimiters,
+as well as
+@key{Control+D}
+(EOT or EOF),
+@key{Control+H}
+(BS or backspace),
+and
+@key{Control+L}
+(FF or form feed),
+all of which cause
+@acronym{AT&T}
+@code{troff} @c AT&T
+to behave in ways difficult to predict.
+@c END Keep in sync with groff_diff(7), subsection "Delimiters".
+
@c ---------------------------------------------------------------------
@node Other Differences, , Compatibility Mode, Implementation Differences
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 00a81213a..43433b6e1 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -5318,6 +5318,53 @@ interpolates the Gregorian year minus 1900.
.
.
.\" ====================================================================
+.SS Delimiters
+.\" ====================================================================
+.\" BEGIN Keep (roughly) parallel with relevant material from groff.texi
+.\" node "Compatibility Mode".
+AT&T
+.I troff \" AT&T
+recognized slightly varying sets of delimiters when expecting
+numerical expressions
+(as with the
+.B \[rs]h
+escape sequence),
+string expressions
+(as with the
+.B \[rs]w
+escape sequence),
+and output comparisons
+(as in
+.RB \[lq] ".if #foo#bar# .tm match" \[rq]).
+GNU
+.IR troff , \" GNU
+when not in compatibility mode,
+recognizes a single consistent set of delimiters.
+Compatibility mode
+emulates
+AT&T
+.I troff \" AT&T
+only up to a point.
+GNU
+.IR troff , \" GNU
+accepts leaders and tabs as delimiters,
+as well as
+Control+D
+(EOT or EOF),
+Control+H
+(BS or backspace),
+and
+Control+L
+(FF or form feed),
+all of which cause
+AT&T
+.I troff \" AT&T
+to behave in ways difficult to predict.
+.\" END Keep (roughly) parallel with relevant material from groff.texi
+.\" node "Compatibility Mode".
+.
+.
+.\" ====================================================================
.SS Miscellaneous
.\" ====================================================================
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
