gbranden pushed a commit to branch master
in repository groff.
commit 959c4f38d2388a00d31e3015e857c2c87acafa97
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Feb 8 02:56:45 2026 -0600
[doc,man]: Fix Savannah #67992.
Note a pitfall with using a device extension command as the first thing
in a document, and a workaround.
Fixes <https://savannah.gnu.org/bugs/?67992>.
---
doc/groff.texi.in | 8 ++++++++
man/groff.7.man | 10 ++++++++++
2 files changed, 18 insertions(+)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 39aed1e50..279f60dd6 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -20519,6 +20519,14 @@ and their presence confuses drivers
that do not know about it.@footnote{@xref{Device Control Commands}.}
@endDefesc
+Use of device extension commands early in a document
+(before the first text is formatted)
+can interfere with processing of page location traps.
+If you experience problems when placing them early,
+precede the first with a dummy character escape sequence
+@samp{\&};
+recall @ref{Dummy Characters}.
+
@DefreqList {tag, name}
@DefreqListEndx {taga, name}
Reserved for internal use.
diff --git a/man/groff.7.man b/man/groff.7.man
index 6f43376d4..da316da11 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -9512,6 +9512,16 @@ and their presence confuses drivers that do not know
about it
.
.
.P
+Use of device extension commands early in a document
+(before the first text is formatted)
+can interfere with processing of page location traps.
+If you experience problems when placing them early,
+precede the first with a dummy character escape sequence
+.RB \[lq] \[rs]& \[rq];
+recall section \[lq]Dummy Characters\[rq] above.
+.
+.
+.P
The
.B tag
and
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
