diff options
author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2023-05-06 20:07:48 -0500 |
---|---|---|
committer | G. Branden Robinson <g.branden.robinson@gmail.com> | 2023-05-06 20:07:48 -0500 |
commit | 4cacb755346c2a4159a42e987b26ff8b20dfae7c (patch) | |
tree | 0c93d345af0cf3be6ca1a348b06f3c1731c4b404 | |
parent | 80075a1de360ade655341f87e09ef5e2cda08ec5 (diff) | |
download | groff-git-4cacb755346c2a4159a42e987b26ff8b20dfae7c.tar.gz |
[man pages]: Revise some syntax synopses.
Use ellipsis more idiomatically, favoring it over plurals, and including
it within instead of outside option brackets for clarity.
The construction:
foo bar [baz] ...
is ambiguous. If I specify no "baz", can "bar"s be repeated?
Also say "argument" when we mean an option OR an operand.
-rw-r--r-- | contrib/eqn2graph/eqn2graph.1.man | 2 | ||||
-rw-r--r-- | contrib/grap2graph/grap2graph.1.man | 2 | ||||
-rw-r--r-- | contrib/mm/mmroff.1.man | 2 | ||||
-rw-r--r-- | contrib/pic2graph/pic2graph.1.man | 2 | ||||
-rw-r--r-- | man/groff_out.5.man | 2 | ||||
-rw-r--r-- | src/preproc/eqn/neqn.1.man | 2 |
6 files changed, 6 insertions, 6 deletions
diff --git a/contrib/eqn2graph/eqn2graph.1.man b/contrib/eqn2graph/eqn2graph.1.man index 472a91671..c05919082 100644 --- a/contrib/eqn2graph/eqn2graph.1.man +++ b/contrib/eqn2graph/eqn2graph.1.man @@ -39,7 +39,7 @@ equation into a cropped image .SY eqn2graph .RB [ \-format\~\c .IR output-format ] -.RI [ convert-arguments ] +.RI [ convert-argument \~.\|.\|.] .YS . . diff --git a/contrib/grap2graph/grap2graph.1.man b/contrib/grap2graph/grap2graph.1.man index 5914a846c..e7e87f3d7 100644 --- a/contrib/grap2graph/grap2graph.1.man +++ b/contrib/grap2graph/grap2graph.1.man @@ -40,7 +40,7 @@ diagram into a cropped image .RB [ \-unsafe ] .RB [ \-format\~\c .IR output-format ] -.RI [ convert-arguments ] +.RI [ convert-argument \~.\|.\|.] .YS . . diff --git a/contrib/mm/mmroff.1.man b/contrib/mm/mmroff.1.man index 0a34b3a4c..0a7031aa4 100644 --- a/contrib/mm/mmroff.1.man +++ b/contrib/mm/mmroff.1.man @@ -53,7 +53,7 @@ macro package . .SY mmroff .RB [ \-x ] -.I groff-arguments +.IR groff-argument \~.\|.\|. .YS . . diff --git a/contrib/pic2graph/pic2graph.1.man b/contrib/pic2graph/pic2graph.1.man index 84a906baf..f3c1c1eb3 100644 --- a/contrib/pic2graph/pic2graph.1.man +++ b/contrib/pic2graph/pic2graph.1.man @@ -42,7 +42,7 @@ diagram into a cropped image .IR output-format ] .RB [ \-eqn\~\c .IR delimiters ] -.RI [ convert-arguments ] +.RI [ convert-argument \~.\|.\|.] .YS . . diff --git a/man/groff_out.5.man b/man/groff_out.5.man index 672f56c7d..bc5662fb9 100644 --- a/man/groff_out.5.man +++ b/man/groff_out.5.man @@ -581,7 +581,7 @@ output driver library handles them. . . .TP -.command m "scheme \f[R][\f[]component\f[R]] .\|.\|." +.command m "scheme \f[R][\f[]component\f[R] .\|.\|.]" Select the stroke color using the .IR component s in the color space diff --git a/src/preproc/eqn/neqn.1.man b/src/preproc/eqn/neqn.1.man index 539afd018..758a150cd 100644 --- a/src/preproc/eqn/neqn.1.man +++ b/src/preproc/eqn/neqn.1.man @@ -50,7 +50,7 @@ .\" ==================================================================== . .SY @g@neqn -.RI [ @g@eqn-options ] +.RI [ @g@eqn-argument \~.\|.\|.] .YS . . |