Browse Source

man pages: unify output of --help and --version

pull/1589/head
Mario Blättermann 5 months ago
parent
commit
2b2d317242
  1. 2
      disk-utils/addpart.8.adoc
  2. 6
      disk-utils/blockdev.8.adoc
  3. 6
      disk-utils/cfdisk.8.adoc
  4. 4
      disk-utils/delpart.8.adoc
  5. 6
      disk-utils/fdformat.8.adoc
  6. 3
      disk-utils/fdisk.8.adoc
  7. 6
      disk-utils/fsck.cramfs.8.adoc
  8. 6
      disk-utils/fsck.minix.8.adoc
  9. 2
      disk-utils/isosize.8.adoc
  10. 7
      disk-utils/mkfs.8.adoc
  11. 7
      disk-utils/mkfs.bfs.8.adoc
  12. 6
      disk-utils/mkfs.cramfs.8.adoc
  13. 7
      disk-utils/mkfs.minix.8.adoc
  14. 6
      disk-utils/mkswap.8.adoc
  15. 6
      disk-utils/partx.8.adoc
  16. 6
      disk-utils/raw.8.adoc
  17. 2
      disk-utils/resizepart.8.adoc
  18. 3
      disk-utils/swaplabel.8.adoc
  19. 6
      login-utils/chfn.1.adoc
  20. 6
      login-utils/chsh.1.adoc
  21. 2
      login-utils/last.1.adoc
  22. 8
      login-utils/login.1.adoc
  23. 6
      login-utils/lslogins.1.adoc
  24. 4
      login-utils/newgrp.1.adoc
  25. 6
      login-utils/nologin.8.adoc
  26. 6
      login-utils/runuser.1.adoc
  27. 6
      login-utils/su.1.adoc
  28. 6
      login-utils/sulogin.8.adoc
  29. 6
      login-utils/utmpdump.1.adoc
  30. 4
      login-utils/vipw.8.adoc
  31. 5
      man-common/help-version.adoc
  32. 6
      man-common/manpage-stub.adoc
  33. 6
      misc-utils/blkid.8.adoc
  34. 6
      misc-utils/cal.1.adoc
  35. 6
      misc-utils/fincore.1.adoc
  36. 2
      misc-utils/findfs.8.adoc
  37. 5
      misc-utils/findmnt.8.adoc
  38. 6
      misc-utils/getopt.1.adoc
  39. 7
      misc-utils/hardlink.1.adoc
  40. 6
      misc-utils/logger.1.adoc
  41. 6
      misc-utils/look.1.adoc
  42. 6
      misc-utils/lsblk.8.adoc
  43. 6
      misc-utils/lsfd.1.adoc
  44. 6
      misc-utils/lslocks.8.adoc
  45. 6
      misc-utils/mcookie.1.adoc
  46. 6
      misc-utils/namei.1.adoc
  47. 6
      misc-utils/rename.1.adoc
  48. 6
      misc-utils/uuidd.8.adoc
  49. 6
      misc-utils/uuidgen.1.adoc
  50. 6
      misc-utils/uuidparse.1.adoc
  51. 6
      misc-utils/whereis.1.adoc
  52. 6
      misc-utils/wipefs.8.adoc
  53. 6
      schedutils/chrt.1.adoc
  54. 6
      schedutils/ionice.1.adoc
  55. 6
      schedutils/taskset.1.adoc
  56. 6
      schedutils/uclampset.1.adoc
  57. 6
      sys-utils/blkdiscard.8.adoc
  58. 6
      sys-utils/blkzone.8.adoc
  59. 6
      sys-utils/chcpu.8.adoc
  60. 6
      sys-utils/chmem.8.adoc
  61. 6
      sys-utils/choom.1.adoc
  62. 6
      sys-utils/ctrlaltdel.8.adoc
  63. 6
      sys-utils/dmesg.1.adoc
  64. 6
      sys-utils/eject.1.adoc
  65. 6
      sys-utils/fallocate.1.adoc
  66. 6
      sys-utils/flock.1.adoc
  67. 6
      sys-utils/fsfreeze.8.adoc
  68. 6
      sys-utils/fstrim.8.adoc
  69. 6
      sys-utils/hwclock.8.adoc
  70. 6
      sys-utils/ipcmk.1.adoc
  71. 6
      sys-utils/ipcrm.1.adoc
  72. 6
      sys-utils/ipcs.1.adoc
  73. 6
      sys-utils/irqtop.1.adoc
  74. 10
      sys-utils/ldattach.8.adoc
  75. 6
      sys-utils/losetup.8.adoc
  76. 6
      sys-utils/lscpu.1.adoc
  77. 6
      sys-utils/lsipc.1.adoc
  78. 6
      sys-utils/lsirq.1.adoc
  79. 6
      sys-utils/lsmem.1.adoc
  80. 7
      sys-utils/lsns.8.adoc
  81. 6
      sys-utils/mount.8.adoc
  82. 6
      sys-utils/mountpoint.1.adoc
  83. 6
      sys-utils/nsenter.1.adoc
  84. 6
      sys-utils/pivot_root.8.adoc
  85. 6
      sys-utils/prlimit.1.adoc
  86. 6
      sys-utils/readprofile.8.adoc
  87. 6
      sys-utils/renice.1.adoc
  88. 6
      sys-utils/rfkill.8.adoc
  89. 6
      sys-utils/rtcwake.8.adoc
  90. 6
      sys-utils/setarch.8.adoc
  91. 6
      sys-utils/setpriv.1.adoc
  92. 6
      sys-utils/swapon.8.adoc
  93. 6
      sys-utils/switch_root.8.adoc
  94. 6
      sys-utils/umount.8.adoc
  95. 6
      sys-utils/unshare.1.adoc
  96. 6
      sys-utils/wdctl.8.adoc
  97. 6
      sys-utils/zramctl.8.adoc
  98. 6
      term-utils/agetty.8.adoc
  99. 6
      term-utils/mesg.1.adoc
  100. 6
      term-utils/script.1.adoc
  101. 6
      term-utils/scriptlive.1.adoc
  102. 6
      term-utils/scriptreplay.1.adoc
  103. 6
      term-utils/setterm.1.adoc
  104. 6
      term-utils/wall.1.adoc
  105. 6
      term-utils/write.1.adoc
  106. 6
      text-utils/col.1.adoc
  107. 6
      text-utils/colcrt.1.adoc
  108. 6
      text-utils/colrm.1.adoc
  109. 6
      text-utils/column.1.adoc
  110. 8
      text-utils/hexdump.1.adoc
  111. 6
      text-utils/more.1.adoc
  112. 6
      text-utils/pg.1.adoc
  113. 6
      text-utils/rev.1.adoc
  114. 6
      text-utils/ul.1.adoc

2
disk-utils/addpart.8.adoc

@ -40,6 +40,8 @@ The beginning of the partition (in 512-byte sectors).
_length_::
The length of the partition (in 512-byte sectors).
include::man-common/help-version.adoc[]
== SEE ALSO
*delpart*(8),

6
disk-utils/blockdev.8.adoc

@ -39,11 +39,7 @@ Be verbose.
*--report*::
Print a report for the specified device. It is possible to give multiple devices. If none is given, all devices which appear in _/proc/partitions_ are shown. Note that the partition StartSec is in 512-byte sectors.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Print version and exit.
include::man-common/help-version.adoc[]
== COMMANDS

6
disk-utils/cfdisk.8.adoc

@ -44,8 +44,7 @@ If you want to remove an old partition table from a device, use *wipefs*(8).
== OPTIONS
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
*-L*, *--color*[**=**__when__]::
Colorize the output. The optional argument _when_ can be *auto*, *never* or *always*. If the _when_ argument is omitted, it defaults to *auto*. The colors can be disabled, for the current built-in default see *--help* output. See also the *COLORS* section.
@ -56,9 +55,6 @@ Use exclusive BSD lock for device or file it operates. The optional argument _mo
*-r*, *--read-only*::
Forced open in read-only mode.
*-V*, *--version*::
Display version information and exit.
*-z*, *--zero*::
Start with an in-memory zeroed partition table. This option does not zero the partition table on the disk; rather, it simply starts the program without reading the existing partition table. This option allows you to create a new partition table from scratch or from an *sfdisk*(8)-compatible script.

4
disk-utils/delpart.8.adoc

@ -26,6 +26,10 @@ delpart - tell the kernel to forget about a partition
This command doesn't manipulate partitions on a block device.
== OPTIONS
include::man-common/help-version.adoc[]
== SEE ALSO
*addpart*(8),

6
disk-utils/fdformat.8.adoc

@ -61,11 +61,7 @@ Try to repair tracks failed during the verification (max _N_ retries).
*-n*, *--no-verify*::
Skip the verification that is normally performed after the formatting.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== NOTES

3
disk-utils/fdisk.8.adoc

@ -48,8 +48,7 @@ Don't erase the beginning of the first disk sector when creating a new disk labe
*-c*, *--compatibility*[=_mode_]::
Specify the compatibility mode, 'dos' or 'nondos'. The default is non-DOS mode. For backward compatibility, it is possible to use the option without the _mode_ argument -- then the default is used. Note that the optional _mode_ argument cannot be separated from the *-c* option by a space, the correct form is for example *-c*=_dos_.
*-h*, *--help*::
Display a help text and exit.
include::man-common/help-version.adoc[]
*-L*, *--color*[=_when_]::
Colorize the output. The optional argument _when_ can be *auto*, *never* or *always*. If the _when_ argument is omitted, it defaults to *auto*. The colors can be disabled; for the current built-in default see the *--help* output. See also the *COLORS* section.

6
disk-utils/fsck.cramfs.8.adoc

@ -35,11 +35,7 @@ This option is silently ignored.
*-y*::
This option is silently ignored.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== EXIT STATUS

6
disk-utils/fsck.minix.8.adoc

@ -65,11 +65,7 @@ Activate MINIX-like "mode not cleared" warnings.
*-f*, *--force*::
Force a filesystem check even if the filesystem was marked as valid. Marking is done by the kernel when the filesystem is unmounted.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== DIAGNOSTICS

2
disk-utils/isosize.8.adoc

@ -28,6 +28,8 @@ Only has an effect when *-x* is not given. The value shown (if no errors) is the
+
The size of the file (or block device) holding an iso9660 filesystem can be marginally larger than the actual size of the iso9660 filesystem. One reason for this is that cd writers are allowed to add "run out" sectors at the end of an iso9660 image.
include::man-common/help-version.adoc[]
== EXIT STATUS
*0*::

7
disk-utils/mkfs.8.adoc

@ -35,11 +35,8 @@ Filesystem-specific options to be passed to the real filesystem builder.
*-V*, *--verbose*::
Produce verbose output, including all filesystem-specific commands that are executed. Specifying this option more than once inhibits execution of any filesystem-specific commands. This is really only useful for testing.
*-V*, *--version*::
Display version information and exit. (Option *-V* will display version information only when it is the only parameter, otherwise it will work as *--verbose*.)
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
(Option *-V* will display version information only when it is the only parameter, otherwise it will work as *--verbose*.)
== BUGS

7
disk-utils/mkfs.bfs.8.adoc

@ -44,11 +44,8 @@ This option is silently ignored.
*-l*::
This option is silently ignored.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit. Option *-V* only works as *--version* when it is the only option.
include::man-common/help-version.adoc[]
Option *-V* only works as *--version* when it is the only option.
== EXIT STATUS

6
disk-utils/mkfs.cramfs.8.adoc

@ -62,11 +62,7 @@ This option is ignored. Originally the *-s* turned on directory entry sorting.
*-z*::
Make explicit holes.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== EXIT STATUS

7
disk-utils/mkfs.minix.8.adoc

@ -64,11 +64,8 @@ Make a Minix version 2 filesystem.
*-3*::
Make a Minix version 3 filesystem.
*-V*, *--version*::
Display version information and exit. The long option cannot be combined with other options.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
The long option cannot be combined with other options.
== ENVIRONMENT

6
disk-utils/mkswap.8.adoc

@ -76,11 +76,7 @@ Specify the swap-space version. (This option is currently pointless, as the old
*--verbose*::
Verbose execution. With this option *mkswap* will output more details about detected problems during swap area set up.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== ENVIRONMENT

6
disk-utils/partx.8.adoc

@ -96,11 +96,7 @@ Overwrite default sector size.
*-v*, *--verbose*::
Verbose mode.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== ENVIRONMENT

6
disk-utils/raw.8.adoc

@ -42,11 +42,7 @@ Set query mode. *raw* will query an existing binding instead of setting a new on
*-a*, *--all*::
With *-q*, specify that all bound raw devices should be queried.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== NOTES

2
disk-utils/resizepart.8.adoc

@ -37,6 +37,8 @@ The partition number.
_length_::
The new length of the partition (in 512-byte sectors).
include::man-common/help-version.adoc[]
== SEE ALSO
*addpart*(8),

3
disk-utils/swaplabel.8.adoc

@ -28,8 +28,7 @@ If an optional argument is present, then *swaplabel* will change the appropriate
== OPTIONS
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
*-L*, *--label* _label_::
Specify a new _label_ for the device. Swap partition labels can be at most 16 characters long. If _label_ is longer than 16 characters, *swaplabel* will truncate it and print a warning message.

6
login-utils/chfn.1.adoc

@ -46,11 +46,7 @@ Specify your office phone number.
*-h*, *--home-phone* _home-phone_::
Specify your home phone number.
*-u*, *--help*::
Display help text and exit.
*-v*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== CONFIG FILE ITEMS

6
login-utils/chsh.1.adoc

@ -36,11 +36,7 @@ Specify your login shell.
*-l*, *--list-shells*::
Print the list of shells listed in _/etc/shells_ and exit.
*-h*, *--help*::
Display help text and exit.
*-v*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== VALID SHELLS

2
login-utils/last.1.adoc

@ -84,6 +84,8 @@ Display full user names and domain names in the output.
*-x*, *--system*::
Display the system shutdown entries and run level changes.
include::man-common/help-version.adoc[]
== TIME FORMATS
The options that take the _time_ argument understand the following formats:

8
login-utils/login.1.adoc

@ -52,15 +52,11 @@ Note that the *-h* option has an impact on the *PAM service* *name*. The standar
*-H*::
Used by other servers (for example, *telnetd*(8)) to tell *login* that printing the hostname should be suppressed in the login: prompt. See also *LOGIN_PLAIN_PROMPT* below.
*--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== CONFIG FILE ITEMS
*login* reads the _/etc/login.defs_ configuration file (see login.defs(5)). Note that the configuration file could be distributed with another package (usually shadow-utils). The following configuration items are relevant for *login*:
*login* reads the _/etc/login.defs_ configuration file (see *login.defs*(5)). Note that the configuration file could be distributed with another package (usually shadow-utils). The following configuration items are relevant for *login*:
*MOTD_FILE* (string)::
Specifies a ":" delimited list of "message of the day" files and directories to be displayed upon login. If the specified path is a directory then displays all files with .motd file extension in version-sort order from the directory.

6
login-utils/lslogins.1.adoc

@ -51,9 +51,6 @@ Only show data of users belonging to _groups_. More than one group may be specif
+
Note that relation between user and group may be invisible for primary group if the user is not explicitly specify as group member (e.g., in _/etc/group_). If the command *lslogins* scans for groups than it uses groups database only, and user database with primary GID is not used at all.
*-h*, *--help*::
Display help information and exit.
*-L*, *--last*::
Display data containing information about the users' last login sessions.
@ -90,8 +87,7 @@ Display dates in short, full or iso format. The default is short, this time form
*-u*, *--user-accs*::
Show user accounts. These are by default all accounts with UID above 1000 (inclusive), with the exception of either nobody or nfsnobody (UID 65534). This hardcoded default maybe overwritten by parameters UID_MIN and UID_MAX in the file _/etc/login.defs_.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
*--wtmp-file* _path_::
Alternate path for wtmp.

4
login-utils/newgrp.1.adoc

@ -22,6 +22,10 @@ newgrp [_group_]
If no group is specified, the GID is changed to the login GID.
== OPTIONS
include::man-common/help-version.adoc[]
== FILES
_/etc/group_,

6
login-utils/nologin.8.adoc

@ -48,11 +48,7 @@ The exit status returned by *nologin* is always 1.
These shell command-line options are ignored to avoid *nologin* error.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== NOTES

6
login-utils/runuser.1.adoc

@ -76,11 +76,7 @@ Same as *-c*, but do not create a new session. (Discouraged.)
*-w*, *--whitelist-environment*=_list_::
Don't reset the environment variables specified in the comma-separated _list_ when clearing the environment for *--login*. The whitelist is ignored for the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, and *PATH*.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== CONFIG FILES

6
login-utils/su.1.adoc

@ -77,11 +77,7 @@ Same as *-c*, but do not create a new session. (Discouraged.)
*-w*, **--whitelist-environment**=__list__::
Don't reset the environment variables specified in the comma-separated _list_ when clearing the environment for *--login*. The whitelist is ignored for the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, and *PATH*.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== SIGNALS

6
login-utils/sulogin.8.adoc

@ -61,11 +61,7 @@ Specifying this option causes *sulogin* to start the shell process as a login sh
*-t*, *--timeout* _seconds_::
Specify the maximum amount of time to wait for user input. By default, *sulogin* will wait forever.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== ENVIRONMENT

6
login-utils/utmpdump.1.adoc

@ -46,11 +46,7 @@ Write command output to _file_ instead of standard output.
*-r*, *--reverse*::
Undump, write back edited login information into the utmp or wtmp files.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== NOTES

4
login-utils/vipw.8.adoc

@ -54,6 +54,10 @@ vipw, vigr - edit the password or group file
*vipw* edits the password file after setting the appropriate locks, and does any necessary processing after the password file is unlocked. If the password file is already locked for editing by another user, *vipw* will ask you to try again later. The default editor for *vipw* and *vigr* is *vi*(1). *vigr* edits the group file in the same manner as *vipw* does the passwd file.
== OPTIONS
include::man-common/help-version.adoc[]
== ENVIRONMENT
If the following environment variable exists, it will be utilized by *vipw* and *vigr*:

5
man-common/help-version.adoc

@ -0,0 +1,5 @@
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Print version and exit.

6
man-common/manpage-stub.adoc

@ -40,11 +40,7 @@ This option has a value.
For empty lines within a description (to keep the indentation) you can use the "plus" character at the beginning of an otherwise empty line.
//Last but not least, don't forget the common options:
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== NOTES

6
misc-utils/blkid.8.adoc

@ -55,9 +55,6 @@ Don't print information (PART_ENTRY_* tags) from partition table in low-level pr
*-g*, *--garbage-collect*::
Perform a garbage collection pass on the blkid cache to remove devices which no longer exist.
*-h*, *--help*::
Display a usage message and exit.
*-H*, *--hint* _setting_::
Set probing hint. The hints are an optional way to force probing functions to
check, for example, another location. The currently supported is
@ -146,8 +143,7 @@ probes for all supported formats except RAIDs. This option is only useful togeth
*-U*, *--uuid* _uuid_::
Look up the device that uses this filesystem _uuid_. For more details see the *--label* option.
*-V*, *--version*::
Display version number and exit.
include::man-common/help-version.adoc[]
== EXIT STATUS

6
misc-utils/cal.1.adoc

@ -117,11 +117,7 @@ Display week numbers in the calendar (US or ISO-8601). See the *NOTES* section f
*--color*[=_when_]::
Colorize the output. The optional argument _when_ can be *auto*, *never* or *always*. If the _when_ argument is omitted, it defaults to *auto*. The colors can be disabled; for the current built-in default see the *--help* output. See also the *COLORS* section.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== PARAMETERS

6
misc-utils/fincore.1.adoc

@ -44,11 +44,7 @@ Produce output in raw format. All potentially unsafe characters are hex-escaped
*-J*, *--json*::
Use JSON output format.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== AUTHORS

2
misc-utils/findfs.8.adoc

@ -44,6 +44,8 @@ ____
*blkid*
____
include::man-common/help-version.adoc[]
== EXIT STATUS
*0*::

5
misc-utils/findmnt.8.adoc

@ -66,9 +66,6 @@ Search in an alternative file. If used with *--fstab*, *--mtab* or *--kernel*, t
*-f*, *--first-only*::
Print the first matching filesystem only.
*-h*, *--help*::
Display help text and exit.
*-i*, *--invert*::
Invert the sense of matching.
@ -177,6 +174,8 @@ Force *findmnt* to print more information (*--verify* only for now).
*--vfs-all*::
When used with *VFS-OPTIONS* column, print all VFS (fs-independent) flags. This option is designed for auditing purposes to list also default VFS kernel mount options which are normally not listed.
include::man-common/help-version.adoc[]
== EXIT STATUS
The exit value is 0 if there is something to display, or 1 on any error

6
misc-utils/getopt.1.adoc

@ -32,9 +32,6 @@ Traditional implementations of *getopt*(1) are unable to cope with whitespace an
*-a*, *--alternative*::
Allow long options to start with a single '*-*'.
*-h*, *--help*::
Display help text and exit. No other output is generated.
*-l*, *--longoptions* _longopts_::
The long (multi-character) options to be recognized. More than one option name may be specified at once, by separating the names with commas. This option may be given more than once, the _longopts_ are cumulative. Each long option name in _longopts_ may be followed by one colon to indicate it has a required argument, and by two colons to indicate it has an optional argument.
@ -60,8 +57,7 @@ Test if your *getopt*(1) is this enhanced version or an old version. This genera
*-u*, *--unquoted*::
Do not quote the output. Note that whitespace and special (shell-dependent) characters can cause havoc in this mode (like they do with other *getopt*(1) implementations).
*-V*, *--version*::
Display version information and exit. No other output is generated.
include::man-common/help-version.adoc[]
== PARSING

7
misc-utils/hardlink.1.adoc

@ -28,11 +28,8 @@ hardlink - link multiple copies of a file
== OPTIONS
*-h*, *--help*::
print quick usage details to the screen.
*-v*, *--verbose*::
More verbose output. If specified once, every hardlinked file is displayed, if specified twice, it also shows every comparison.
include::man-common/help-version.adoc[]
If specified once, every hardlinked file is displayed, if specified twice, it also shows every comparison.
*-q*, *--quiet*::
Quiet mode, don't print anything.

6
misc-utils/logger.1.adoc

@ -180,11 +180,7 @@ Write to the specified _socket_ instead of to the system log socket.
*--*::
End the argument list. This allows the _message_ to start with a hyphen (-).
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== EXIT STATUS

6
misc-utils/look.1.adoc

@ -70,11 +70,7 @@ Ignore the case of alphabetic characters. This is on by default if no file is sp
*-t*, *--terminate* _character_::
Specify a string termination character, i.e., only the characters in _string_ up to and including the first occurrence of _character_ are compared.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
The *look* utility exits 0 if one or more lines were found and displayed, 1 if no lines were found, and >1 if an error occurred.

6
misc-utils/lsblk.8.adoc

@ -54,9 +54,6 @@ Exclude the devices specified by the comma-separated _list_ of major device numb
*-f*, *--fs*::
Output info about filesystems. This option is equivalent to *-o NAME,FSTYPE,FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS*. The authoritative information about filesystems and raids is provided by the *blkid*(8) command.
*-h*, *--help*::
Display help text and exit.
*-I*, *--include* _list_::
Include devices specified by the comma-separated _list_ of major device numbers. The filter is applied to the top-level devices only. This may be confusing for *--list* output format where hierarchy of the devices is not obvious.
@ -109,8 +106,7 @@ Output info about block-device topology. This option is equivalent to
+
*-o NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME*.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
*-w*, *--width* _number_::
Specifies output width as a number of characters. The default is the number of the terminal columns, and if not executed on a terminal, then output width is not restricted at all by default. This option also forces *lsblk* to assume that terminal control characters and unsafe characters are not allowed. The expected use-case is for example when *lsblk* is used by the *watch*(1) command.

6
misc-utils/lsfd.1.adoc

@ -102,11 +102,7 @@ only for *lsfd* developers.
*--dump-counters*::
Dump the definition of counters used in *--summary* output.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== OUTPUT COLUMNS

6
misc-utils/lslocks.8.adoc

@ -63,11 +63,7 @@ Use the raw output format.
*-u*, *--notruncate*::
Do not truncate text in columns.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== OUTPUT

6
misc-utils/mcookie.1.adoc

@ -39,11 +39,7 @@ The _number_ argument may be followed by the multiplicative suffixes KiB=1024, M
*-v*, *--verbose*::
Inform where randomness originated, with amount of entropy read from each source.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== FILES

6
misc-utils/namei.1.adoc

@ -56,11 +56,7 @@ Vertically align the modes and owners.
*-x*, *--mountpoints*::
Show mountpoint directories with a 'D' rather than a 'd'.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== BUGS

6
misc-utils/rename.1.adoc

@ -43,11 +43,7 @@ Do not overwrite existing files. When *--symlink* is active, do not overwrite sy
*-i*, *--interactive*::
Ask before overwriting existing files.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== WARNING

6
misc-utils/uuidd.8.adoc

@ -62,11 +62,7 @@ Make *uuidd* exit after _number_ seconds of inactivity.
*-t*, *--time*::
Test *uuidd* by trying to connect to a running uuidd daemon and request it to return a time-based UUID.
*-V*, *--version*::
Output version information and exit.
*-h*, *--help*::
Display help screen and exit.
include::man-common/help-version.adoc[]
== EXAMPLE

6
misc-utils/uuidgen.1.adoc

@ -34,11 +34,7 @@ Generate a random-based UUID. This method creates a UUID consisting mostly of ra
*-t*, *--time*::
Generate a time-based UUID. This method creates a UUID based on the system clock plus the system's ethernet hardware address, if present.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
*-m*, *--md5*::
Use MD5 as the hash algorithm.

6
misc-utils/uuidparse.1.adoc

@ -59,11 +59,7 @@ Specify which output columns to print. Use *--help* to get a list of all support
*-r*, *--raw*::
Use the raw output format.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== AUTHORS

6
misc-utils/whereis.1.adoc

@ -97,11 +97,7 @@ Terminates the directory list and signals the start of filenames. It _must_ be u
*-l*::
Output the list of effective lookup paths that *whereis* is using. When none of *-B*, *-M*, or *-S* is specified, the option will output the hard-coded paths that the command was able to find on the system.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== FILE SEARCH PATHS

6
misc-utils/wipefs.8.adoc

@ -46,9 +46,6 @@ Create a signature backup to the file _$HOME/wipefs-<devname>-<offset>.bak_. For
*-f*, *--force*::
Force erasure, even if the filesystem is mounted. This is required in order to erase a partition-table signature on a block device.
*-h*, *--help*::
Display help text and exit.
*-J*, *--json*::
Use JSON output format.
@ -78,8 +75,7 @@ Suppress any messages after a successful signature wipe.
*-t*, *--types* _list_::
Limit the set of printed or erased signatures. More than one type may be specified in a comma-separated list. The list or individual types can be prefixed with 'no' to specify the types on which no action should be taken. For more details see *mount*(8).
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== ENVIRONMENT

6
schedutils/chrt.1.adoc

@ -101,11 +101,7 @@ Operate on an existing PID and do not launch a new task.
*-v*, *--verbose*::
Show status information.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== USAGE

6
schedutils/ionice.1.adoc

@ -60,14 +60,10 @@ Specify the process group IDs of running processes for which to get or set the s
*-t*, *--ignore*::
Ignore failure to set the requested priority. If _command_ was specified, run it even in case it was not possible to set the desired scheduling priority, which can happen due to insufficient privileges or an old kernel version.
*-h*, *--help*::
Display help text and exit.
*-u*, *--uid* _UID_...::
Specify the user IDs of running processes for which to get or set the scheduling parameters.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== NOTES

6
schedutils/taskset.1.adoc

@ -77,11 +77,7 @@ Interpret _mask_ as numerical list of processors instead of a bitmask. Numbers a
*-p*, *--pid*::
Operate on an existing PID and do not launch a new task.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== USAGE

6
schedutils/uclampset.1.adoc

@ -83,11 +83,7 @@ Set *SCHED_FLAG_RESET_ON_FORK* flag.
*-v*, *--verbose*::
Show status information.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== USAGE

6
sys-utils/blkdiscard.8.adoc

@ -49,11 +49,7 @@ Zero-fill rather than discard.
*-v*, *--verbose*::
Display the aligned values of _offset_ and _length_. If the *--step* option is specified, it prints the discard progress every second.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== AUTHORS

6
sys-utils/blkzone.8.adoc

@ -98,11 +98,7 @@ Enforce commands to change zone status on block devices used by the system.
*-v*, *--verbose*::
Display the number of zones returned in the report or the range of sectors reset.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== AUTHORS

6
sys-utils/chcpu.8.adoc

@ -50,11 +50,7 @@ The workload is concentrated on few CPUs.
*-r*, *--rescan*::
Trigger a rescan of CPUs. After a rescan, the Linux kernel recognizes the new CPUs. Use this option on systems that do not automatically detect newly attached CPUs.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== EXIT STATUS

6
sys-utils/chmem.8.adoc

@ -46,14 +46,10 @@ Set the specified _RANGE_, _SIZE_, or _BLOCKRANGE_ of memory online.
*-z*, *--zone*::
Select the memory _ZONE_ where to set the specified _RANGE_, _SIZE_, or _BLOCKRANGE_ of memory online or offline. By default, memory will be set online to the zone Movable, if possible.
*-h*, *--help*::
Print a short help text, then exit.
*-v*, *--verbose*::
Verbose mode. Causes *chmem* to print debugging messages about it's progress.
*-V*, *--version*::
Print the version number, then exit.
include::man-common/help-version.adoc[]
== EXIT STATUS

6
sys-utils/choom.1.adoc

@ -28,11 +28,7 @@ Specifies process ID.
*-n*, *--adjust* _value_::
Specify the adjust score value.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
== NOTES

6
sys-utils/ctrlaltdel.8.adoc

@ -34,11 +34,7 @@ The function of *ctrlaltdel* is usually set in the _/etc/rc.local_ file.
== OPTIONS
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== FILES

6
sys-utils/dmesg.1.adoc

@ -141,11 +141,7 @@ Wait and print only new messages.
*-x*, *--decode*::
Decode facility and level (priority) numbers to human-readable prefixes.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== COLORS

6
sys-utils/eject.1.adoc

@ -49,9 +49,6 @@ Force eject, don't check device type, don't open device with exclusive lock. The
*-f*, *--floppy*::
This option specifies that the drive should be ejected using a removable floppy disk eject command.
*-h*, *--help*::
Display help text and exit.
*-i*, **--manualeject on**|*off*::
This option controls locking of the hardware eject button. When enabled, the drive will not be ejected when the button is pressed. This is useful when you are carrying a laptop in a bag or case and don't want it to eject if the button is inadvertently pressed.
@ -82,8 +79,7 @@ With this option the drive is given a CD-ROM tray close command if it's opened,
*-t*, *--trayclose*::
With this option the drive is given a CD-ROM tray close command. Not all devices support this command.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
*-v*, *--verbose*::
Run in verbose mode; more information is displayed about what the command is doing.

6
sys-utils/fallocate.1.adoc

@ -76,11 +76,7 @@ Option *--keep-size* can be specified to prevent file length modification.
+
Available since Linux 3.14 for ext4 (only for extent-based files) and XFS.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== AUTHORS

6
sys-utils/flock.1.adoc

@ -83,11 +83,7 @@ Fail if the lock cannot be acquired within _seconds_. Decimal fractional values
*--verbose*::
Report how long it took to acquire the lock, or why the lock could not be obtained.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== EXIT STATUS

6
sys-utils/fsfreeze.8.adoc

@ -36,11 +36,7 @@ Note that even after freezing, the on-disk filesystem can contain information on
*-u*, *--unfreeze*::
This option is used to un-freeze the filesystem and allow operations to continue. Any filesystem modifications that were blocked by the freeze are unblocked and allowed to complete.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== FILESYSTEM SUPPORT

6
sys-utils/fstrim.8.adoc

@ -61,11 +61,7 @@ Verbose execution. With this option *fstrim* will output the number of bytes pas
*--quiet-unsupported*::
Suppress error messages if trim operation (ioctl) is unsupported. This option is meant to be used in *systemd* service file or in *cron*(8) scripts to hide warnings that are result of known problems, such as NTFS driver reporting _Bad file descriptor_ when device is mounted read-only, or lack of file system support for ioctl _FITRIM_ call. This option also cleans exit status when unsupported filesystem specified on *fstrim* command line.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== EXIT STATUS

6
sys-utils/hwclock.8.adoc

@ -101,11 +101,7 @@ The first two are only available on the first call of *settimeofday*(2) after bo
*-w*, *--systohc*::
Set the Hardware Clock from the System Clock, and update the timestamps in _{ADJTIME_PATH}_. With the *--update-drift* option also (re)calculate the drift factor. Try it without the option if *--systohc* fails. See *--update-drift* below.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== OPTIONS

6
sys-utils/ipcmk.1.adoc

@ -40,11 +40,7 @@ Other options are:
*-p*, *--mode* _mode_::
Access permissions for the resource. Default is 0644.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== AUTHORS

6
sys-utils/ipcrm.1.adoc

@ -58,11 +58,7 @@ Remove the semaphore created with _semkey_.
*-s*, *--semaphore-id* _semid_::
Remove the semaphore identified by _semid_.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== NOTES

6
sys-utils/ipcs.1.adoc

@ -27,11 +27,7 @@ ipcs - show information on IPC facilities
*-i*, *--id* _id_::
Show full details on just the one resource element identified by _id_. This option needs to be combined with one of the three resource options: *-m*, *-q* or *-s*.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
=== Resource options

6
sys-utils/irqtop.1.adoc

@ -37,11 +37,7 @@ Specify sort criteria by column name. See *--help* output to get column names. T
*-S*, *--softirq*::
Show softirqs information.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== INTERACTIVE MODE KEY COMMANDS

10
sys-utils/ldattach.8.adoc

@ -104,16 +104,10 @@ Set the parity of the serial line to odd.
Set the speed (the baud rate) of the serial line to the specified _value_.
*-c*, *--intro-command* _string_::
Define an intro command that is sent through the serial line before the invocation of ldattach. E.g. in conjunction with line discipline GSM0710, the command 'AT+CMUX=0\r' is commonly suitable to switch the modem into the CMUX mode.
Define an intro command that is sent through the serial line before the invocation of *ldattach*. E.g. in conjunction with line discipline GSM0710, the command 'AT+CMUX=0\r' is commonly suitable to switch the modem into the CMUX mode.
*-p*, *--pause* _value_::
Sleep for _value_ seconds before the invocation of ldattach. Default is one second.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
Sleep for _value_ seconds before the invocation of *ldattach*. Default is one second.
== AUTHORS

6
sys-utils/losetup.8.adoc

@ -113,12 +113,6 @@ Use the raw *--list* output format.
*-J*, *--json*::
Use JSON format for *--list* output.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
== ENCRYPTION
*Cryptoloop is no longer supported in favor of dm-crypt.* For more details see *cryptsetup*(8).

6
sys-utils/lscpu.1.adoc

@ -60,9 +60,6 @@ When specifying the _list_ argument, the string of option, equal sign (=), and _
+
The default list of columns may be extended if list is specified in the format +list (e.g., lscpu -e=+MHZ).
*-h*, *--help*::
Display help text and exit.
*-J*, *--json*::
Use JSON output format for the default summary or extended output (see *--extended*).
@ -86,9 +83,6 @@ Display physical IDs for all columns with topology elements (core, socket, etc.)
+
The CPU logical numbers are not affected by this option.
*-V*, *--version*::
Display version information and exit.
*--output-all*::
Output all available columns. This option must be combined with either *--extended*, *--parse* or *--caches*.

6
sys-utils/lsipc.1.adoc

@ -26,11 +26,7 @@ Show full details on just the one resource element identified by _id_. This opti
*-g*, *--global*::
Show system-wide usage and limits of IPC resources. This option may be combined with one of the three resource options: *-m*, *-q* or *-s*. The default is to show information about all resources.
*-h*, *--help*::
Display help text and exit.
*-V*, *--version*::
Display version information and exit.
include::man-common/help-version.adoc[]
=== Resource options

6
sys-utils/lsirq.1.adoc

@ -40,11 +40,7 @@ Produce output in the form of key="value" pairs. All potentially unsafe characte
*-S*, *--softirq*::
Show softirqs information.
*-V*, *--version*::
Display version information and exit.
*-h*, *--help*::
Display help text and exit.
include::man-common/help-version.adoc[]
== AUTHORS

6
sys-utils/lsmem.1.adoc