]> git.ipfire.org Git - thirdparty/util-linux.git/commit
misc: update --help content again
authorRuediger Meier <ruediger.meier@ga-group.nl>
Sun, 25 Jun 2017 20:01:12 +0000 (22:01 +0200)
committerRuediger Meier <ruediger.meier@ga-group.nl>
Tue, 27 Jun 2017 10:29:37 +0000 (12:29 +0200)
commit551b9cd3f9ca3a84c2a8a4aec0c22bb82cbf8abf
tree2df83f99f267a615777cb01235d1d84b2772c2f8
parent62cd916f1e43812cb66e614ddcad7ebbc0713639
misc: update --help content again

We change

 -h, --help     display this help and exit
 -V, --version  output version information and exit

to

 -h, --help     display this help
 -V, --version  print version

Some thoughts about this:

  * use "display" for --help because it matches better if we
    would add pager support (like git --help)
  * "print" for --version to be different
  * "this" for --help is important to make clear that running
    --help would not give you any better information than the
    one you see already
  * remove "information and exit" because it's bloat for the
    short-help, everybody knows what it does if it exists

In the manpages we should use the old, longer but more correct
descriptions, inclusive a reminder if --help/--version are only
working when used as the only option. Note the term "version
information" indicates that we don't only print a single version
number.

CC: J William Piggott <elseifthen@gmx.com>
Signed-off-by: Ruediger Meier <ruediger.meier@ga-group.nl>
include/c.h