gbranden pushed a commit to branch master
in repository groff.
commit 0c7ca99ba7bddaf78acbbaab8066386f08bee8fa
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Apr 14 00:41:13 2026 -0500
groff{,_diff}(7): Parallelize wording.
Also drop redundant statements duplicating earlier description.
---
man/groff.7.man | 57 ++++++++++++++--------------------------------------
man/groff_diff.7.man | 33 ++++++++++--------------------
2 files changed, 26 insertions(+), 64 deletions(-)
diff --git a/man/groff.7.man b/man/groff.7.man
index c0910fda7..b40934981 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2654,29 +2654,17 @@ or indexed.
.
.TPx
.I command
-is an instance of
-.I contents
-(see below)
-to be passed to the system as a command
-(potentially with arguments).
-.\" ...limiting the file names you can express; see Savannah #64071.
-.
-GNU
-.I troff \" GNU
-strips a leading neutral double quote,
-allowing embedded leading spaces.
+is a
+.I character-sequence
+to be passed to the system as a command.
+.\" ...limiting the characters you can express; see Savannah #64071.
.
.TPx
.I contents
-is arbitrary input,
-excluding an unescaped newline,
+is a
+.I character-sequence
read in copy mode.
.
-GNU
-.I troff \" GNU
-strips a leading neutral double quote,
-allowing embedded leading spaces.
-.
.TPx
.I div
is a diversion identifier.
@@ -2687,18 +2675,13 @@ is an environment identifier.
.
.TPx
.I file
-is an instance of
-.I contents
+is a
+.I character-sequence
naming a file on the system.
.\" ...limiting the file names you can express; see Savannah #65108.
.
GNU
.I troff \" GNU
-strips a leading neutral double quote,
-allowing embedded leading spaces.
-.
-GNU
-.I troff \" GNU
does not accept newlines
(line feeds)
in file names supplied as arguments to requests.
@@ -2727,16 +2710,11 @@ is a macro identifier.
.
.TPx
.I message
-is an instance of
-.I contents
+is a
+.I character-sequence
to emit on the standard error stream.
.\" ...limiting the messages you can express; see Savannah #62787.
.
-GNU
-.I troff \" GNU
-strips a leading neutral double quote,
-allowing embedded leading spaces.
-.
.TPx
.I n
is a numeric expression that evaluates to a non-negative integer.
@@ -5036,10 +5014,9 @@ is interpreted in units of scaled points (\c
.
GNU
.I troff \" GNU
-strips a leading neutral double quote from
-.IR s1 ;
-it reads
-each
+removes a leading neutral double quote from
+.I s1
+and reads each
.IR s i
in copy mode.
.\" XXX: ...hinting at an implementation wart. The request handler uses
@@ -5372,9 +5349,7 @@ As
.REQ .tm1 message
As
.request tm ,
-but removes a leading neutral double quote
-.RB \[oq] \[dq] \[cq]
-from
+but removes a leading neutral double quote from
.IR message ,
permitting initial embedded spaces in it,
and reads it to the end of the input line in copy mode.
@@ -6854,9 +6829,7 @@ If
is invoked with only one argument,
the named string becomes empty.
.
-The formatter removes a leading neutral double quote
-.RB \[oq] \[dq] \[cq] \" single quotes around double quote
-from
+The formatter removes a leading neutral double quote from
.I contents
to permit the embedding of leading spaces.
.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 1999ad475..0202e372e 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1833,9 +1833,7 @@ this behavior is so anomalous that we consider it a bug.
.IP
GNU
.I troff \" GNU
-removes a leading neutral double quote
-.RB \[oq] \[dq] \[cq]
-from the argument,
+removes a leading neutral double quote from the argument,
permitting initial embedded spaces in it,
and reads it to the end of the input line in copy mode.
.
@@ -1912,9 +1910,7 @@ the first argument becomes the input line number of the
.I next
line the formatter reads.
It also
-removes a leading neutral double quote
-.RB \[oq] \[dq] \[cq]
-from
+removes a leading neutral double quote from
.I file-identifier,
permitting initial embedded spaces in it,
and reads it to the end of the input line in copy mode.
@@ -1925,10 +1921,7 @@ and reads it to the end of the input line in copy mode.
.IR file ]
GNU
.I troff \" GNU
-removes a leading neutral double quote
-.RB \[oq] \[dq] \[cq]
-from
-.IR file ,
+removes a leading neutral double quote from the argument,
permitting initial embedded spaces in it,
and reads it to the end of the input line in copy mode.
.
@@ -1938,8 +1931,9 @@ and reads it to the end of the input line in copy mode.
.I command
GNU
.I troff \" GNU
-strips a leading neutral double quote from the argument,
-permitting initial embedded spaces in it.
+removes a leading neutral double quote from the argument,
+permitting initial embedded spaces in it,
+and reads it to the end of the input line in copy mode.
.
.
.TP
@@ -1960,10 +1954,7 @@ or diversion
.I file
GNU
.I troff \" GNU
-removes a leading neutral double quote
-.RB \[oq] \[dq] \[cq]
-from
-.IR file ,
+removes a leading neutral double quote from the argument,
permitting initial embedded spaces in it,
and reads it to the end of the input line in copy mode.
.
@@ -2010,8 +2001,9 @@ Negative values are erroneous.
.I command
GNU
.I troff \" GNU
-strips a leading neutral double quote from the argument,
-permitting initial embedded spaces in it.
+removes a leading neutral double quote from the argument,
+permitting initial embedded spaces in it,
+and reads it to the end of the input line in copy mode.
.
.
.TP
@@ -4566,10 +4558,7 @@ the increase in width is a linear function of the type
size.
As
.BR tm ,
but
-removes a leading neutral double quote
-.RB \[oq] \[dq] \[cq]
-from
-.IR message ,
+removes a leading neutral double quote from the argument,
permitting initial embedded spaces in it.
.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
