21504: Rewrite arv-mount help for more consistent style
authorBrett Smith <brett.smith@curii.com>
Sun, 25 Feb 2024 22:00:48 +0000 (17:00 -0500)
committerBrett Smith <brett.smith@curii.com>
Sun, 25 Feb 2024 22:13:04 +0000 (17:13 -0500)
commit404d326a66c0f83e2278a2cc012b4b6b87de6459
tree45e9da614d22c6903e69865ba861c0f34bfb1182
parent7675c71cff927a677c9f3366962800469fa502b5
21504: Rewrite arv-mount help for more consistent style

Some key points:

* Prefer describing the effect with a phrase over a sentence
* Only use periods when there are multiple sentences
* Defaults in parentheses
* Consistent text where needed (particularly across --by-* and
  --mount-by-* options and different --unmount options)

We don't really have a style guide for documentation like this. I'm not
trying to establish one by fiat. I'd be open to discussing basically all
these points. But until that discussion happens, consistency is
valuable, so I'm using the rules that I tend to follow naturally.

Arvados-DCO-1.1-Signed-off-by: Brett Smith <brett.smith@curii.com>
services/fuse/arvados_fuse/command.py