[groff] 02/13: [docs]: Update discussion of `cf` and `trf`.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 4eaeccf077c82938fe45b8e7ac74edd267af178e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Dec 19 08:59:57 2023 -0600

    [docs]: Update discussion of `cf` and `trf`.
---
 doc/groff.texi       | 14 +++++++-------
 man/groff_diff.7.man | 26 +++++++++++++++++---------
 2 files changed, 24 insertions(+), 16 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index be297d248..339c33489 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -16113,16 +16113,16 @@ suffix or @file{tmac.} prefix to locate @var{file}.
 @cindex copy mode, and @code{trf} request
 @cindex mode, copy, and @code{trf} request
 Transparently output the contents of @var{file}.  Each line is output as
-if it were preceded by @code{\!}; however, the lines are @emph{not}
-subject to copy mode interpretation.  If the file does not end with a
-newline, @code{trf} adds one.  Both requests cause a break.
+if preceded by @code{\!}, but is not read in copy mode.  If @var{file}
+does not end with a newline, @code{trf} 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, causes the contents of
-@var{file} to be transparently copied to the output.  In @acronym{AT&T}
-@code{troff}, the contents of @var{file} are immediately copied to the
-output regardless of whether there is a current diversion; this
-behaviour is so anomalous that it must be considered a bug.
+@var{file} to be copied to the output.  In @acronym{AT&T} @code{troff},
+@code{cf} does so even if a diversion is in use; this behavior is so
+anomalous that it must be considered a bug.
 
 @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 707899e78..0b85453bc 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3462,23 +3462,31 @@ but does not append a newline.
 .
 .TP
 .BI .trf\~ file
-Transparently output the contents of file
+Transparently output the contents of
 .IR file .
 .
 Each line is output as if preceded by
-.BR \[rs]! ;
-however,
-the lines are not subject to copy-mode interpretation.
+.BR \[rs]! ,
+but is not read in copy mode.
 .
-If the file does not end with a newline,
-then a newline is added.
+If
+.I file
+does not end with a newline,
+.B trf
+appends one.
 .
-Unlike
+Like
 .BR cf ,
+.B trf
+breaks the line unless invoked with the no-break control character.
+.
+Characters in
 .I file
-cannot contain characters
 that are invalid as input to GNU
-.IR troff . \" GNU
+.I troff \" GNU
+are discarded;
+contrast with
+.BR cf .
 .
 .
 .TP