cmdline-docs: use present tense, not future

+ some smaller cleanups

Closes #11821
This commit is contained in:
Daniel Stenberg 2023-09-08 14:32:29 +02:00
parent bfb48e33fb
commit 4600bd3993
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2
113 changed files with 394 additions and 399 deletions

View file

@ -45,19 +45,19 @@ Each file has a set of meta-data and a body of text.
### Body
The body of the description. Only refer to options with their long form option
version, like `--verbose`. The output generator will replace such with the
version, like `--verbose`. The output generator replaces such option with the
correct markup that shows both short and long version.
Text written within `*asterisks*` will get shown using italics. Text within
two `**asterisks**` will get shown using bold.
Text written within `*asterisks*` is shown using italics. Text within two
`**asterisks**` is shown using bold.
Text that is prefixed with a space will be treated like an "example" and will
be output in monospace.
Text that is prefixed with a space is treated like an "example" and gets
output in monospace.
## Header and footer
`page-header` is the file that will be output before the generated options
output for the master man page.
`page-header` is the file that is output before the generated options output
for the master man page.
`page-footer` is appended after all the individual options.