gbranden pushed a commit to branch master
in repository groff.
commit 1765e7b45d259f31bb6511406f05a8790b3a336f
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Jan 4 03:36:16 2026 -0600
[doc,man]: Revise `.output` description.
Migrate from (variously) "contents" and "anything" to
"character-sequence".
Sync language between our Texinfo manual and man pages.
Also break input lines consistently between Texinfo and man pages.
Continues the long process of fixing Savannah #65976.
---
doc/groff.texi.in | 17 ++++++++++++-----
man/groff_diff.7.man | 14 ++++++--------
2 files changed, 18 insertions(+), 13 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index b48c6ee45..84a1e8ee6 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -18163,16 +18163,23 @@ its argument is simply ignored.
@cindex @code{output} request, and copy mode
@cindex copy mode, and @code{output} request
@cindex mode, copy, and @code{output} request
-@Defreq {output, [@code{"}]@Var{contents}}
-Emit @var{contents} directly to GNU @command{troff}'s output; this usage
-is similar to that of @code{\!} in the top-level diversion.
+@Defreq {output, [@code{"}]@Var{character-sequence}}
+Emit
+@var{character-sequence}
+directly to
+GNU
+@command{troff}'s @c GNU
+output;
+this usage is similar to that of
+@code{\!}
+when it occurs in the top-level diversion.
GNU
@command{troff} @c GNU
removes a leading neutral double quote
@samp{"}
from
-@var{anything}, @c TODO: -> character-sequence
+@var{character-sequence},
permitting initial embedded spaces in it,
and reads it to the end of the input line in copy mode.
Recall @ref{Copy Mode}.
@@ -18189,7 +18196,7 @@ and of
@code{\!}
from the top-level diversion is to pass instructions
to a postprocessor that interprets
-@var{anything}
+@var{character-sequence}
and filters it out
before sending it to the output device.
@c TODO: Once the dust settles from Savannah #63074, document how these
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index f52d369ee..f676e08ab 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3794,15 +3794,13 @@ if it already exists instead of overwriting it.
.I character-sequence
Emit
.IR character-sequence ,
-a sequence of ordinary characters and spaces read in copy mode,
-\[lq]transparently\[rq]
-(directly) to
-.IR @g@troff 's
-output.
-.
-This usage is similar to that of
+transparently to
+GNU
+.I troff \" GNU
+output;
+this usage is similar to that of
.B \[rs]!\&
-in the top-level diversion.
+when it occurs in the top-level diversion.
.
.
.TP
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
