Denote multiple arguments with 'arg ...' not 'args'
authorkn <kn@openbsd.org>
Thu, 22 Dec 2022 19:53:22 +0000 (19:53 +0000)
committerkn <kn@openbsd.org>
Thu, 22 Dec 2022 19:53:22 +0000 (19:53 +0000)
commit881f6c5ff077fe814539e359736601c57260e2c7
treedc55c964a2c3bd686b79766fb6ed2fbb35b2cef8
parent2f31c0f799d693315c02e9626bf14d90b50461c7
Denote multiple arguments with 'arg ...' not 'args'

A few programs used the plural in their synopsis which doesn't read as
clear as the obvious triple-dot notation.

mdoc(7) .Ar defaults to "file ..." if no arguments are given and consistent
use of 'arg ...' matches that behaviour.

Cleanup a few markups of the same argument so the text keeps reading
naturally;  omit unhelpful parts like 'if optional arguments are given,
they are passed along' for tools like time(1) and timeout(1) that obviously
execute commands with whatever arguments where given -- just like doas(1)
which doesn't mention arguments in its DESCRIPTION in the first place.

For expr(1) the difference between 'expressions' and 'expression ...' is
crucial, as arguments must be passed as individual words.

Feedback millert jmc schwarze deraadt
OK jmc
25 files changed:
bin/expr/expr.1
sbin/route/route.8
sbin/route/route.c
share/man/man4/ddb.4
usr.bin/cdio/cdio.1
usr.bin/cdio/cdio.c
usr.bin/csplit/csplit.1
usr.bin/csplit/csplit.c
usr.bin/doas/doas.1
usr.bin/doas/doas.c
usr.bin/mandoc/mandoc.1
usr.bin/openssl/openssl.1
usr.bin/su/su.1
usr.bin/su/su.c
usr.bin/time/time.1
usr.bin/timeout/timeout.1
usr.bin/timeout/timeout.c
usr.bin/tmux/tmux.1
usr.bin/tput/tput.1
usr.bin/tput/tput.c
usr.sbin/bgpctl/bgpctl.8
usr.sbin/bgpd/bgpd.conf.5
usr.sbin/btrace/btrace.8
usr.sbin/rcctl/rcctl.8
usr.sbin/rcctl/rcctl.sh