gbranden pushed a commit to branch master
in repository groff.
commit 488e57f659afe4e56df0fc7498e70088c64a9b25
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Apr 15 13:11:23 2026 -0500
[doc,man]: Clean up after Savannah #63074 fix.
It landed without exploding; see commit da13fecf22, 2024-10-18.
Offer advice to help user distinguish scenarios calling for
`output`/`\!` from those better served by `device`/`\X`.
Also drop obsolete/unnecessary code annotations.
---
doc/groff.texi.in | 34 ++++++++++++++++++++++++++++------
man/groff_font.5.man | 1 +
src/roff/troff/div.cpp | 4 +---
3 files changed, 30 insertions(+), 9 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index cfe962c13..953ef5f31 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -19518,9 +19518,18 @@ to a postprocessor that interprets
@var{character-sequence}
and filters it out
before sending it to the output driver.
-@c TODO: Once the dust settles from Savannah #63074, document how these
-@c can be used to construct device extension commands without special
-@c character processing.
+If all you require is to encode character code points
+that are not meaningful in
+@code{roff}
+device-independent output but are to an output driver,
+such as Unicode characters in document metadata,
+bookmarks,
+or URLs,
+consider the
+@code{device}
+request or
+@code{\X}
+escape sequence.@footnote{@xref{Postprocessor Access}.}
@endDefreq
@Defreq {asciify, div}
@@ -20815,9 +20824,6 @@ GNU
output as parameters to an
@w{@samp{x X}}
device extension command.@footnote{@xref{GNU @command{troff} Output}.}
-The output driver or other postprocessor interprets
-@var{character-sequence}
-as it sees fit.
@cindex @code{device} request, and copy mode
@cindex copy mode, and @code{device} request
@@ -20904,6 +20910,21 @@ as arguments to device extension
commands.@footnote{When encountered,
these produce warnings in category
@samp{char}.
@xref{Warnings}.}
+
+To avoid the transformations
+@code{device}
+and
+@code{\X}
+perform,
+employ the
+@code{output}
+or
+@code{\!}
+or
+@code{\?}
+escape sequences;
+recall
+@xref{Diversions}.
@endDefesc
GNU
@@ -23415,6 +23436,7 @@ Make the font handling module always return unscaled
character widths.
The @code{grohtml} driver uses this directive.
@c XXX: Savannah #63074 is trying to make this obsolescent.
+@c TODO: That bug is fixed. Can we get rid of this?
@item use_charnames_in_special
@kindex use_charnames_in_special
GNU
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 3ada6e291..a6c04565f 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -475,6 +475,7 @@ driver uses this directive.
.
.
.\" XXX: Savannah #63074 is trying to make this obsolescent.
+.\" TODO: That bug is fixed. Can we get rid of this?
.TP
.B use_charnames_in_special
GNU
diff --git a/src/roff/troff/div.cpp b/src/roff/troff/div.cpp
index 55e6d3998..1562c8b85 100644
--- a/src/roff/troff/div.cpp
+++ b/src/roff/troff/div.cpp
@@ -515,10 +515,8 @@ void top_level_diversion::transparent_output(unsigned char
c)
the_output->transparent_char(*s++);
}
-void top_level_diversion::transparent_output(node * /*n*/)
+void top_level_diversion::transparent_output(node *)
{
- // TODO: When Savannah #63074 is fixed, the user will have a way to
- // avoid this error.
error("cannot write a node to device-independent output");
}
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
