[groff] 15/17: [docs]: Parallelize language.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit a5c9a3d54134e830c3750ce35bbc386e8944ddd0
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Jan 18 11:26:26 2024 -0600

    [docs]: Parallelize language.
    
    Say "leading neutral quote" instead of "initial neutral quote", just for
    consistency.
    
    Also:
    
    * man/groff.7.man (Request short reference) <ds>: Document recognition
      of leading neutral double quote.
    
      (Request short reference) <ds, ds1>: Rename metasyntactic variable
      from "anything" to "contents".
---
 doc/groff.texi       |  4 ++--
 man/groff.7.man      | 28 ++++++++++++++++++++--------
 man/groff_diff.7.man |  6 +++---
 3 files changed, 25 insertions(+), 13 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 2c9ad5b95..e029e9bdd 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -12557,7 +12557,7 @@ document maintenance.
 @cindex leading spaces with @code{ds}
 @cindex spaces with @code{ds}
 @cindex @code{ds} request, and leading spaces
-The formatter removes an initial neutral double quote @code{"} in
+The formatter removes a leading neutral double quote @code{"} in
 @var{contents} to permit the embedding of leading spaces.  Any other
 @code{"} is interpreted literally, but it is wise to use the special
 character escape sequence @code{\[dq]} instead if the string might be
@@ -16469,7 +16469,7 @@ Embed @var{contents} into GNU @command{troff} output as 
parameters to an
 The interpretation of such parameters is determined by the output driver
 or other postprocessor.
 
-The @code{device} request strips an initial neutral double quote from
+The @code{device} request strips a leading neutral double quote from
 @var{contents} to allow embedding of leading spaces.
 
 @cindex @code{\&}, in device control commands
diff --git a/man/groff.7.man b/man/groff.7.man
index 4bb0c7bdc..c1c5a5109 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -442,7 +442,7 @@ In the
 and
 .request .as1
 requests,
-an initial neutral double quote in the second argument is stripped off
+a leading neutral double quote in the second argument is stripped off
 to allow embedding of leading spaces.
 .
 To include a double quote inside a quoted argument,
@@ -2774,6 +2774,12 @@ Define ordinary or special character
 as
 .I anything.
 .
+A leading neutral double quote in the second argument is stripped from
+it,
+allowing embedded leading spaces in
+.I contents,
+which is read in copy mode and continues to the end of the input line.
+.
 .TPx
 .REQ .chop name
 Remove the last character from the macro,
@@ -2993,7 +2999,7 @@ to
 .I @g@troff
 output as a device control command.
 .
-An initial neutral double quote is stripped to allow embedding of
+A leading neutral double quote is stripped to allow embedding of
 leading spaces.
 .
 .TPx
@@ -3037,16 +3043,22 @@ Create empty string named
 .IR ident .
 .
 .TPx
-.REQ .ds "ident anything"
+.REQ .ds "ident contents"
 Create a string named
 .I ident
 containing
-.IR anything .
+.I contents.
+.
+A leading neutral double quote in the second argument is stripped from
+it,
+allowing embedded leading spaces in
+.I contents,
+which is read in copy mode and continues to the end of the input line.
 .
 .TPx
 .REQ .ds1 ident
 .TQ
-.REQ .ds1 "ident anything"
+.REQ .ds1 "ident contents"
 As
 .request .ds ,
 with compatibility mode disabled when the string is interpreted.
@@ -3859,7 +3871,7 @@ directly to
 .IR @g@troff 's
 output.
 .
-An initial neutral double quote in the argument is stripped,
+A leading neutral double quote in the argument is stripped,
 allowing embedded leading spaces in
 .IR contents ,
 which is read in copy mode and continues to the end of the input line.
@@ -4629,7 +4641,7 @@ which must previously have been the subject of an
 request,
 followed by a newline.
 .
-An initial neutral double quote in the second argument is stripped,
+A leading neutral double quote in the second argument is stripped,
 allowing embedded leading spaces in
 .IR contents ,
 which is read in copy mode until the end of the line.
@@ -5771,7 +5783,7 @@ see section \[lq]Parameters\[rq] below.
 .
 .
 .P
-The formatter removes an initial neutral double quote
+The formatter removes a leading neutral double quote
 .B \[dq]
 in the string contents to permit the embedding of leading spaces.
 .
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 283f84d13..9f3829dc9 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1901,7 +1901,7 @@ the
 .I groff
 Texinfo manual.)
 .
-An initial neutral double quote in the final argument is stripped from
+A leading neutral double quote in the second argument is stripped from
 it,
 allowing embedded leading spaces in
 .I contents,
@@ -2247,7 +2247,7 @@ to
 .I @g@troff
 output as a device control command.
 .
-An initial neutral double quote in
+A leading neutral double quote in
 .I anything
 is stripped to allow the embedding of
 leading spaces.
@@ -3119,7 +3119,7 @@ this usage is similar to that of
 .B \[rs]!\&
 in the top-level diversion.
 .
-An initial neutral double quote in the argument is stripped,
+A leading neutral double quote in the argument is stripped,
 allowing embedded leading spaces in
 .IR contents ,
 which is read in copy mode and continues to the end of the input line.