gbranden pushed a commit to branch master
in repository groff.
commit 58ec41c7ad72417571630abd70aadbcc68b35a0e
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Sat Jul 5 08:14:58 2025 -0500
doc/*,man/*: Revise description of `cf` request.
* Document that the request (normally) causes a break.
* Favor present tense over future.
* Drop "node" and "object" jargon.
---
doc/groff.texi.in | 12 ++++++------
man/groff_diff.7.man | 17 +++++++++++------
2 files changed, 17 insertions(+), 12 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 65956c700..f2cd91695 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -17310,10 +17310,10 @@ in
@cindex @code{trf} request, and copy mode
@cindex copy mode, and @code{trf} request
@cindex mode, copy, and @code{trf} request
-Copy
+Break and copy the contents of
@var{file}
as ``throughput'' to GNU
-@command{troff}
+@command{troff}'s
output.
Each line of
@var{file}
@@ -17328,10 +17328,10 @@ appends one.
Both requests break the line before reading
@var{file},
unless invoked with the no-break control character.
-
-When used in a diversion, these requests embed a node (@pxref{Gtroff
-Internals}) in it that, when interpolated, copies the contents of
-@var{file} to the output.
+If a diversion is in use,
+GNU
+@command{troff} @c GNU
+performs the copy only when the diversion is emitted.
@cindex @code{trf} request, and invalid characters
@cindex characters, invalid for @code{trf} request
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index a5b260d58..3846eaf62 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -4375,15 +4375,20 @@ not a mounting position.
.TP
.BR .cf\~ [ \[dq] ]\c
.I file
-In a diversion,
-embed an object which,
-when interpolated,
-will cause the contents of
+Break and copy the contents of
.I file
-to be copied verbatim to the output.
+as \[lq]throughput\[rq] to
+GNU
+.IR troff 's \" GNU
+output.
+.
+If a diversion is in use,
+GNU
+.I troff \" GNU
+performs the copy only when the diversion is emitted.
.
In AT&T
-.IR troff ,
+.IR troff , \" AT&T
the contents of
.I file
are immediately copied to the output regardless of whether a diversion
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
