gbranden pushed a commit to branch master
in repository groff.
commit a4125a105ccd24feb37f03a7940f3000684ea915
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Sun Feb 23 19:07:14 2025 -0600
[doc,man]: Document file name arg diff from AT&T.
---
doc/groff.texi.in | 23 +++++++++++++++++++++++
man/groff_diff.7.man | 22 ++++++++++++++++++++++
2 files changed, 45 insertions(+)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 78e0239eb..fdbab280f 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -18221,6 +18221,29 @@ one.@footnote{Thus,
@endExample
produces different results with each of the three formatters.}
+@cindex file name arguments to requests, in other implementations
+@cindex arguments, file name, to requests, in other implementations
+@cindex requests handling file name arguments, in other implementations
+GNU
+@command{troff}
+interprets request arguments representing file names
+in the same way it does the
+@var{contents}
+argument to the
+@code{ds}
+and
+@code{as}
+requests:@:
+by stripping any leading neutral double quote
+@samp{"}
+and reading to the end of the input line in copy mode.
+This difference permits the formatter to handle files
+with spaces in their names,
+but requires more care with trailing comments,
+and doubling of an initial neutral double quote
+@samp{"}
+if the file name contains one.
+
@cindex output device name string (@code{.T}), in other implementations
GNU @code{troff} predefines a string @code{.T} containing the argument
given to the @option{-T} command-line option, namely the current output
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 5001cf4b3..b109daba9 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -5947,6 +5947,28 @@ after a word-initial one.
.
.
.P
+GNU
+.I troff \" GNU
+interprets request arguments representing file names
+in the same way it does the
+.I contents
+argument to the
+.B ds
+and
+.RB \[lq] as \[rq]
+requests:
+by stripping any leading neutral double quote
+.RB \[lq] \[dq] \[rq]
+and reading to the end of the input line in copy mode.
+This difference permits the formatter to handle files
+with spaces in their names,
+but requires more care with trailing comments,
+and doubling of an initial neutral double quote
+.RB \[lq] \[dq] \[rq]
+if the file name contains one.
+.
+.
+.P
The existence of the
.B .T
string is a common feature of post-CSTR\~#97
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
