gbranden pushed a commit to branch master
in repository groff.
commit 6749b2387a98d38b097551a9b37d1db68b266cbd
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Jul 27 15:23:08 2025 -0500
doc/*,man/*: Paralellize compatibility mode stuff.
Our Texinfo manual was missing some content.
---
doc/groff.texi.in | 32 +++++++++++++++++++++++++++++++-
man/groff_diff.7.man | 9 +++++----
2 files changed, 36 insertions(+), 5 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 65f5c4717..16dd5b2fa 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -19616,7 +19616,6 @@ Hello!
@result{} Hello! @r{(compatibility mode)}
@endExample
-@need 1000
@cindex @code{\s}, incompatibilities with @acronym{AT&T} @code{troff}
Normally, the syntax form @code{\s}@var{n} accepts only a single
character (a digit) for @var{n}, consistently with other forms that
@@ -19632,6 +19631,37 @@ the 1992 revision of CSTR@tie{}#54 (
referred to it as a ``living fossil''.} should migrate to another
@code{\s} form.
+@c BEGIN Keep in sync with groff_diff(7), subsection "Altered requests".
+In compatibility mode,
+the
+@code{de},
+@code{am},
+@code{ds},
+and
+@code{as}
+requests behave as
+@code{de1},
+@code{am1},
+@code{ds1},
+and
+@code{as1},
+respectively:
+GNU
+@command{troff} @c GNU
+inserts a
+@slanted{compatibility save}
+token at the beginning of the macro,
+string,
+or appendment thereto as applicable
+and a
+@slanted{compatibility restore}
+token at its end,
+enabling compatibility mode during its interpolation.@footnote{Recall
+@ref{Strings}.}}
+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 ---------------------------------------------------------------------
@node Other Differences, , Compatibility Mode, Implementation Differences
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index d8d1a397f..603081cdb 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1679,6 +1679,7 @@ is emitted
and the request has no other effect.
.
.
+.\" BEGIN Keep in sync with groff.texi node "Compatibility Mode".
.br
.ne 6v
.TP
@@ -1696,7 +1697,7 @@ and the request has no other effect.
.RB [[ \[dq] ]\c
.IR contents ]
In compatibility mode,
-these requests behave similarly to
+these requests behave as
.BR de1 ,
.BR am1 ,
.BR ds1 ,
@@ -1707,7 +1708,7 @@ GNU
.I troff \" GNU
inserts a
.I "compatibility save"
-token at its beginning of the macro,
+token at the beginning of the macro,
string,
or appendment thereto as applicable
and a
@@ -1716,8 +1717,8 @@ token at its end,
enabling compatibility mode during its interpolation.
.
Thus they work as expected
-even if the surrounding interpretation context
-disables compatibility mode.
+even if the interpolation context disables compatibility mode.
+.\" END Keep in sync with groff.texi node "Compatibility Mode".
.
.
.TP
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
