gbranden pushed a commit to branch master
in repository groff.
commit 8f0505db56aecfd7727e1df80ca2651ba44bd9e2
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Mar 27 05:32:50 2025 -0500
[doc,man]: Cohere discussion of syntax revision.
...applying to requests taking file names and system commands as
arguments.
---
doc/groff.texi.in | 56 ++++++++++++++++++++++++----------------------------
man/groff_diff.7.man | 43 +++++++++++++++++-----------------------
2 files changed, 44 insertions(+), 55 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 1d039e82c..99de5d6ba 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -18546,9 +18546,17 @@ 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
+
+@cindex @code{cf} request, incompatibilities with @acronym{AT&T} @code{troff}
+@cindex @code{lf} request, incompatibilities with @acronym{AT&T} @code{troff}
+@cindex @code{nx} request, incompatibilities with @acronym{AT&T} @code{troff}
+@cindex @code{pi} request, incompatibilities with @acronym{AT&T} @code{troff}
+@cindex @code{so} request, incompatibilities with @acronym{AT&T} @code{troff}
+@cindex @code{sy} request, incompatibilities with @acronym{AT&T} @code{troff}
GNU
-@command{troff}
+@command{troff} @c GNU
interprets request arguments representing file names
+and system commands
in the same way it does the
@var{contents}
argument to the
@@ -18556,9 +18564,24 @@ argument to the
and
@code{as}
requests:@:
-by stripping any leading neutral double quote
+it removes a leading neutral double quote
@samp{"}
-and reading to the end of the input line in copy mode.
+from the argument to the
+@code{cf},
+@code{nx},
+@code{pi},
+@code{so},
+and
+@code{sy}
+requests,
+and the second argument
+(if present)
+to the
+@code{lf}
+request,
+permitting initial embedded spaces in it,
+and reads it to the end of the input line in copy mode.
+Recall @ref{Copy Mode}.
This difference permits the formatter to handle files
with spaces in their names,
but requires more care with trailing comments,
@@ -18648,33 +18671,6 @@ Unlike @acronym{AT&T} @code{troff}, GNU @code{troff}
does not ignore the
values of minimum inter-word and additional inter-sentence space are
each rounded down to the nearest multiple of@tie{}12.
-@cindex @code{cf} request, incompatibilities with @acronym{AT&T} @code{troff}
-@cindex @code{lf} request, incompatibilities with @acronym{AT&T} @code{troff}
-@cindex @code{nx} request, incompatibilities with @acronym{AT&T} @code{troff}
-@cindex @code{pi} request, incompatibilities with @acronym{AT&T} @code{troff}
-@cindex @code{so} request, incompatibilities with @acronym{AT&T} @code{troff}
-@cindex @code{sy} request, incompatibilities with @acronym{AT&T} @code{troff}
-GNU
-@command{troff}
-removes a leading neutral double quote
-@samp{"}
-from the argument to the
-@code{cf},
-@code{nx},
-@code{pi},
-@code{so},
-and
-@code{sy}
-requests,
-and the second argument
-(if present)
-to the
-@code{lf}
-request,
-permitting initial embedded spaces in it,
-and reads it to the end of the input line in copy mode.
-Recall @ref{Copy Mode}.
-
@cindex @code{bd} request, incompatibilities with @acronym{AT&T} @code{troff}
@cindex @code{cs} request, incompatibilities with @acronym{AT&T} @code{troff}
@cindex @code{tr} request, incompatibilities with @acronym{AT&T} @code{troff}
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 82aaa6792..b87f891cd 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -6048,6 +6048,7 @@ after a word-initial one.
GNU
.I troff \" GNU
interprets request arguments representing file names
+and system commands
in the same way it does the
.I contents
argument to the
@@ -6055,9 +6056,23 @@ argument to the
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.
+it removes a leading neutral double quote
+.RB \[oq] \[dq] \[cq]
+from the argument to the
+.BR cf ,
+.BR nx ,
+.BR pi ,
+.RB \[lq] so \[rq],
+and
+.B sy
+requests,
+and the second argument
+(if present)
+to the
+.B lf
+request,
+permitting initial embedded spaces in it,
+and reads it 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,
@@ -6344,28 +6359,6 @@ inter-sentence space each to the nearest multiple of\~12.
.
.
.P
-GNU
-.I troff \" GNU
-removes a leading neutral double quote
-.RB \[oq] \[dq] \[cq]
-from the argument to the
-.BR cf ,
-.BR nx ,
-.BR pi ,
-.RB \[lq] so \[rq],
-and
-.B sy
-requests,
-and the second argument
-(if present)
-to the
-.B lf
-request,
-permitting initial embedded spaces in it,
-and reads it to the end of the input line in copy mode.
-.
-.
-.P
In GNU
.I troff \" GNU
there is a fundamental difference between (unformatted) characters and
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
