gbranden pushed a commit to branch master
in repository groff.
commit c5e713a8d6e33987688ffc9ea6936a43f0b33972
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Nov 7 07:01:02 2025 -0600
[doc,man]: Document `asciify` request more.
---
doc/groff.texi.in | 6 ++++++
man/groff.7.man | 6 ++++++
man/groff_diff.7.man | 8 ++++++++
3 files changed, 20 insertions(+)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index bc3c24e56..6f3ac0545 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -17193,6 +17193,12 @@ were formatted and diverted into @var{div} are treated
like ordinary
input characters when @var{div} is interpolated. Doing so can be useful
in conjunction with the @code{writem} request.
+When transforming a glyph node back into an input sequence
+that demands expression as a special character escape sequence,
+GNU
+@command{troff}
+uses the default escape character.
+
@code{asciify} can be also used for gross hacks; for example, the
following sets register@tie{}@code{n} to@tie{}1.
diff --git a/man/groff.7.man b/man/groff.7.man
index 9c27f1857..1bcec358b 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2804,6 +2804,12 @@ and some escape sequences \" XXX: vague
in diversion
.IR div .
.
+When transforming a glyph node back into an input sequence
+that demands expression as a special character escape sequence,
+GNU
+.I troff
+uses the default escape character.
+.
.TPx
.REQ .backtrace
Write the state of the input stack to the standard error stream.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 4f2ed2144..00a81213a 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -2106,6 +2106,14 @@ request.
.
.
.IP
+When transforming a glyph node back into an input sequence
+that demands expression as a special character escape sequence,
+GNU
+.I troff
+uses the default escape character.
+.
+.
+.IP
.B \%asciify
cannot return all nodes in a diversion to their source equivalents:
those produced by indexed characters
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
