gbranden pushed a commit to branch master
in repository groff.
commit 814bab6f9bbbf7a028784fbb7a27de459dda1e87
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Jan 4 03:36:16 2026 -0600
[doc,man]: Revise `.device` description.
Migrate from "contents" to "character-sequence".
Sync language between our Texinfo manual and man pages.
Also break input lines consistently between Texinfo and man pages.
---
doc/groff.texi.in | 17 ++++++++++++-----
man/groff.7.man | 20 ++++++++++++++------
man/groff_diff.7.man | 21 ++++++++++++++-------
3 files changed, 40 insertions(+), 18 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 84a1e8ee6..ed6334c29 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -19241,12 +19241,19 @@ such as
or
@cite{grotty@r{(1)}}.
-@DefreqList {device, [@code{"}]@Var{contents}}
+@DefreqList {device, [@code{"}]@Var{character-sequence}}
@DefescListEndx {\\X, @code{'}, contents @r{@dots{}}, @code{'}}
-Embed @var{contents} into GNU @command{troff} output as parameters to an
-@w{@samp{x X}} device extension command.@footnote{@xref{gtroff Output}.}
-The interpretation of such parameters is determined by the output driver
-or other postprocessor.
+Embed
+@var{character-sequence}
+into
+GNU
+@command{troff}
+output as parameters to an
+@w{@samp{x X}}
+device extension command.@footnote{@xref{gtroff 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
diff --git a/man/groff.7.man b/man/groff.7.man
index 24a69b1a8..3cd9c8362 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3470,12 +3470,20 @@ with compatibility mode disabled when the macro is
interpreted.
.
.TPx
.REQ .device character-sequence
-Write
-.IR character-sequence ,
-a sequence of ordinary or special characters and spaces,
-to
-.I @g@troff
-output as the argument to a device extension command.
+Embed
+.I character-sequence
+into
+GNU
+.I troff \" GNU
+output as parameters to an
+.RB \[lq]x X\[rq]
+device extension command;
+see
+.MR groff_out @MAN5EXT@ .
+.
+The output driver or other postprocessor interprets
+.I character-sequence
+as it sees fit.
.
.TPx
.REQ .devicem name
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index f676e08ab..490a0d961 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -2872,13 +2872,20 @@ above.
.BR .device\~ [\c
.RB [ \[dq] ]\c
.IR character-sequence ]
-Write
-.IR character-sequence ,
-a sequence of ordinary or special characters and spaces
-read in copy mode,
-to
-.I @g@troff
-output as the argument to a device extension command.
+Embed
+.I character-sequence
+into
+GNU
+.I troff \" GNU
+output as parameters to an
+.RB \[lq]x X\[rq]
+device extension command;
+see
+.MR groff_out @MAN5EXT@ .
+.
+The output driver or other postprocessor interprets
+.I character-sequence
+as it sees fit.
.
.
.TP
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
