From: Mario Blättermann Date: Tue, 1 Feb 2022 19:49:24 +0000 (+0100) Subject: man pages: unify output of --help and --version X-Git-Tag: v2.38-rc2~50^2~1 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=2b2d317242;p=thirdparty%2Futil-linux.git man pages: unify output of --help and --version --- diff --git a/disk-utils/addpart.8.adoc b/disk-utils/addpart.8.adoc index 7f9fae6bf9..1c1a9dc04d 100644 --- a/disk-utils/addpart.8.adoc +++ b/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), diff --git a/disk-utils/blockdev.8.adoc b/disk-utils/blockdev.8.adoc index 3ac83d44d5..8e8c3326c5 100644 --- a/disk-utils/blockdev.8.adoc +++ b/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 diff --git a/disk-utils/cfdisk.8.adoc b/disk-utils/cfdisk.8.adoc index 45f5d72e20..59fb80269c 100644 --- a/disk-utils/cfdisk.8.adoc +++ b/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. diff --git a/disk-utils/delpart.8.adoc b/disk-utils/delpart.8.adoc index 56a5e8fcae..e52e254196 100644 --- a/disk-utils/delpart.8.adoc +++ b/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), diff --git a/disk-utils/fdformat.8.adoc b/disk-utils/fdformat.8.adoc index b3ee22cadb..d57f49d04a 100644 --- a/disk-utils/fdformat.8.adoc +++ b/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 diff --git a/disk-utils/fdisk.8.adoc b/disk-utils/fdisk.8.adoc index e033585ab8..a9933c3f59 100644 --- a/disk-utils/fdisk.8.adoc +++ b/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. diff --git a/disk-utils/fsck.cramfs.8.adoc b/disk-utils/fsck.cramfs.8.adoc index 5b35d06c9f..ec75262594 100644 --- a/disk-utils/fsck.cramfs.8.adoc +++ b/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 diff --git a/disk-utils/fsck.minix.8.adoc b/disk-utils/fsck.minix.8.adoc index 95ca47ee6c..37baaced55 100644 --- a/disk-utils/fsck.minix.8.adoc +++ b/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 diff --git a/disk-utils/isosize.8.adoc b/disk-utils/isosize.8.adoc index 5472f3e9aa..2142aaa13f 100644 --- a/disk-utils/isosize.8.adoc +++ b/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*:: diff --git a/disk-utils/mkfs.8.adoc b/disk-utils/mkfs.8.adoc index 2c5e5c0fed..45f100f4e1 100644 --- a/disk-utils/mkfs.8.adoc +++ b/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 diff --git a/disk-utils/mkfs.bfs.8.adoc b/disk-utils/mkfs.bfs.8.adoc index 45a6f2f07b..6b04b105f0 100644 --- a/disk-utils/mkfs.bfs.8.adoc +++ b/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 diff --git a/disk-utils/mkfs.cramfs.8.adoc b/disk-utils/mkfs.cramfs.8.adoc index af0b889bf8..67f0e629d9 100644 --- a/disk-utils/mkfs.cramfs.8.adoc +++ b/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 diff --git a/disk-utils/mkfs.minix.8.adoc b/disk-utils/mkfs.minix.8.adoc index 57ee8ef39c..713cf2fe0d 100644 --- a/disk-utils/mkfs.minix.8.adoc +++ b/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 diff --git a/disk-utils/mkswap.8.adoc b/disk-utils/mkswap.8.adoc index 45aa2975a4..e3c66e217c 100644 --- a/disk-utils/mkswap.8.adoc +++ b/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 diff --git a/disk-utils/partx.8.adoc b/disk-utils/partx.8.adoc index dc0335ed94..bfc0c5a26e 100644 --- a/disk-utils/partx.8.adoc +++ b/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 diff --git a/disk-utils/raw.8.adoc b/disk-utils/raw.8.adoc index fb2232433d..3c570eb3e4 100644 --- a/disk-utils/raw.8.adoc +++ b/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 diff --git a/disk-utils/resizepart.8.adoc b/disk-utils/resizepart.8.adoc index b0666b7c57..b07680b619 100644 --- a/disk-utils/resizepart.8.adoc +++ b/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), diff --git a/disk-utils/swaplabel.8.adoc b/disk-utils/swaplabel.8.adoc index 5223f33960..14ab6c438d 100644 --- a/disk-utils/swaplabel.8.adoc +++ b/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. diff --git a/login-utils/chfn.1.adoc b/login-utils/chfn.1.adoc index 8b7e5e031a..6377e2644b 100644 --- a/login-utils/chfn.1.adoc +++ b/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 diff --git a/login-utils/chsh.1.adoc b/login-utils/chsh.1.adoc index 4d4c545574..939674ad50 100644 --- a/login-utils/chsh.1.adoc +++ b/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 diff --git a/login-utils/last.1.adoc b/login-utils/last.1.adoc index 3ea72fb69b..6c7017cdd2 100644 --- a/login-utils/last.1.adoc +++ b/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: diff --git a/login-utils/login.1.adoc b/login-utils/login.1.adoc index 9ccbfdb3b8..a3404f365b 100644 --- a/login-utils/login.1.adoc +++ b/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. diff --git a/login-utils/lslogins.1.adoc b/login-utils/lslogins.1.adoc index 1a92b1258d..01c0f9839a 100644 --- a/login-utils/lslogins.1.adoc +++ b/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. diff --git a/login-utils/newgrp.1.adoc b/login-utils/newgrp.1.adoc index b50b0d5f3f..4d9d9072d6 100644 --- a/login-utils/newgrp.1.adoc +++ b/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_, diff --git a/login-utils/nologin.8.adoc b/login-utils/nologin.8.adoc index d96dff6e62..6be978b22a 100644 --- a/login-utils/nologin.8.adoc +++ b/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 diff --git a/login-utils/runuser.1.adoc b/login-utils/runuser.1.adoc index fdce60300e..474990e341 100644 --- a/login-utils/runuser.1.adoc +++ b/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 diff --git a/login-utils/su.1.adoc b/login-utils/su.1.adoc index b06adf948c..70c1e0cc48 100644 --- a/login-utils/su.1.adoc +++ b/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 diff --git a/login-utils/sulogin.8.adoc b/login-utils/sulogin.8.adoc index ce76edd898..3165d61959 100644 --- a/login-utils/sulogin.8.adoc +++ b/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 diff --git a/login-utils/utmpdump.1.adoc b/login-utils/utmpdump.1.adoc index 1a821f9e22..a7672d3d49 100644 --- a/login-utils/utmpdump.1.adoc +++ b/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 diff --git a/login-utils/vipw.8.adoc b/login-utils/vipw.8.adoc index 4be0453c5f..58acb9c4f6 100644 --- a/login-utils/vipw.8.adoc +++ b/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*: diff --git a/man-common/help-version.adoc b/man-common/help-version.adoc new file mode 100644 index 0000000000..7a3c04fb9d --- /dev/null +++ b/man-common/help-version.adoc @@ -0,0 +1,5 @@ +*-h*, *--help*:: +Display help text and exit. + +*-V*, *--version*:: +Print version and exit. diff --git a/man-common/manpage-stub.adoc b/man-common/manpage-stub.adoc index ec4fc50f46..833f785777 100644 --- a/man-common/manpage-stub.adoc +++ b/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 diff --git a/misc-utils/blkid.8.adoc b/misc-utils/blkid.8.adoc index 1c81465ca6..5e8002d73d 100644 --- a/misc-utils/blkid.8.adoc +++ b/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 diff --git a/misc-utils/cal.1.adoc b/misc-utils/cal.1.adoc index 885c099016..67a0d84028 100644 --- a/misc-utils/cal.1.adoc +++ b/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 diff --git a/misc-utils/fincore.1.adoc b/misc-utils/fincore.1.adoc index b67f171eab..54ed23677d 100644 --- a/misc-utils/fincore.1.adoc +++ b/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 diff --git a/misc-utils/findfs.8.adoc b/misc-utils/findfs.8.adoc index 2818b243b7..560a5bada7 100644 --- a/misc-utils/findfs.8.adoc +++ b/misc-utils/findfs.8.adoc @@ -44,6 +44,8 @@ ____ *blkid* ____ +include::man-common/help-version.adoc[] + == EXIT STATUS *0*:: diff --git a/misc-utils/findmnt.8.adoc b/misc-utils/findmnt.8.adoc index 3dbf467073..a92fbe6b4b 100644 --- a/misc-utils/findmnt.8.adoc +++ b/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 diff --git a/misc-utils/getopt.1.adoc b/misc-utils/getopt.1.adoc index 6cbdd51748..434d069269 100644 --- a/misc-utils/getopt.1.adoc +++ b/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 diff --git a/misc-utils/hardlink.1.adoc b/misc-utils/hardlink.1.adoc index 37b6c2924c..2a0321a8b8 100644 --- a/misc-utils/hardlink.1.adoc +++ b/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. diff --git a/misc-utils/logger.1.adoc b/misc-utils/logger.1.adoc index 0509a8f357..2d7b830b52 100644 --- a/misc-utils/logger.1.adoc +++ b/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 diff --git a/misc-utils/look.1.adoc b/misc-utils/look.1.adoc index 5e2b172f0f..35b8978bcc 100644 --- a/misc-utils/look.1.adoc +++ b/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. diff --git a/misc-utils/lsblk.8.adoc b/misc-utils/lsblk.8.adoc index 63e96e7b7b..7568f2a7e0 100644 --- a/misc-utils/lsblk.8.adoc +++ b/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. diff --git a/misc-utils/lsfd.1.adoc b/misc-utils/lsfd.1.adoc index ae5b9b01d0..72a7c10a43 100644 --- a/misc-utils/lsfd.1.adoc +++ b/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 diff --git a/misc-utils/lslocks.8.adoc b/misc-utils/lslocks.8.adoc index f46a56f626..21ad643e53 100644 --- a/misc-utils/lslocks.8.adoc +++ b/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 diff --git a/misc-utils/mcookie.1.adoc b/misc-utils/mcookie.1.adoc index 0997d34c16..9a77e4266e 100644 --- a/misc-utils/mcookie.1.adoc +++ b/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 diff --git a/misc-utils/namei.1.adoc b/misc-utils/namei.1.adoc index bc5636ba33..c8a317d7f0 100644 --- a/misc-utils/namei.1.adoc +++ b/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 diff --git a/misc-utils/rename.1.adoc b/misc-utils/rename.1.adoc index 6cc881e344..5eb1959573 100644 --- a/misc-utils/rename.1.adoc +++ b/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 diff --git a/misc-utils/uuidd.8.adoc b/misc-utils/uuidd.8.adoc index d199f730b0..49e7b63591 100644 --- a/misc-utils/uuidd.8.adoc +++ b/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 diff --git a/misc-utils/uuidgen.1.adoc b/misc-utils/uuidgen.1.adoc index a1469b0680..3f71aa9a89 100644 --- a/misc-utils/uuidgen.1.adoc +++ b/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. diff --git a/misc-utils/uuidparse.1.adoc b/misc-utils/uuidparse.1.adoc index 0668066749..d517c19232 100644 --- a/misc-utils/uuidparse.1.adoc +++ b/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 diff --git a/misc-utils/whereis.1.adoc b/misc-utils/whereis.1.adoc index e2b22dcd01..2b07a967d8 100644 --- a/misc-utils/whereis.1.adoc +++ b/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 diff --git a/misc-utils/wipefs.8.adoc b/misc-utils/wipefs.8.adoc index a3840b0952..d53b7681d9 100644 --- a/misc-utils/wipefs.8.adoc +++ b/misc-utils/wipefs.8.adoc @@ -46,9 +46,6 @@ Create a signature backup to the file _$HOME/wipefs--.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 diff --git a/schedutils/chrt.1.adoc b/schedutils/chrt.1.adoc index f6a23cc387..6ccba7dfb0 100644 --- a/schedutils/chrt.1.adoc +++ b/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 diff --git a/schedutils/ionice.1.adoc b/schedutils/ionice.1.adoc index d9c3319d41..622c62ea97 100644 --- a/schedutils/ionice.1.adoc +++ b/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 diff --git a/schedutils/taskset.1.adoc b/schedutils/taskset.1.adoc index a469f574ae..c10cc62a2c 100644 --- a/schedutils/taskset.1.adoc +++ b/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 diff --git a/schedutils/uclampset.1.adoc b/schedutils/uclampset.1.adoc index 71e9f61005..62295d3da0 100644 --- a/schedutils/uclampset.1.adoc +++ b/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 diff --git a/sys-utils/blkdiscard.8.adoc b/sys-utils/blkdiscard.8.adoc index 195137400e..8368743579 100644 --- a/sys-utils/blkdiscard.8.adoc +++ b/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 diff --git a/sys-utils/blkzone.8.adoc b/sys-utils/blkzone.8.adoc index f69430018e..8456b5e42a 100644 --- a/sys-utils/blkzone.8.adoc +++ b/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 diff --git a/sys-utils/chcpu.8.adoc b/sys-utils/chcpu.8.adoc index d4b4ed0b9e..c5797dfb37 100644 --- a/sys-utils/chcpu.8.adoc +++ b/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 diff --git a/sys-utils/chmem.8.adoc b/sys-utils/chmem.8.adoc index 7a1d7577fd..de628aa438 100644 --- a/sys-utils/chmem.8.adoc +++ b/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 diff --git a/sys-utils/choom.1.adoc b/sys-utils/choom.1.adoc index 1de3beb52e..51d43e7b97 100644 --- a/sys-utils/choom.1.adoc +++ b/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 diff --git a/sys-utils/ctrlaltdel.8.adoc b/sys-utils/ctrlaltdel.8.adoc index 9ccf4c92da..57842400ce 100644 --- a/sys-utils/ctrlaltdel.8.adoc +++ b/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 diff --git a/sys-utils/dmesg.1.adoc b/sys-utils/dmesg.1.adoc index aa689ee0ac..64b9146d66 100644 --- a/sys-utils/dmesg.1.adoc +++ b/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 diff --git a/sys-utils/eject.1.adoc b/sys-utils/eject.1.adoc index a4686c3a37..8dd075731e 100644 --- a/sys-utils/eject.1.adoc +++ b/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. diff --git a/sys-utils/fallocate.1.adoc b/sys-utils/fallocate.1.adoc index 9cc30c2759..edcca8e0af 100644 --- a/sys-utils/fallocate.1.adoc +++ b/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 diff --git a/sys-utils/flock.1.adoc b/sys-utils/flock.1.adoc index ced4bf15e6..3cfe5aca71 100644 --- a/sys-utils/flock.1.adoc +++ b/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 diff --git a/sys-utils/fsfreeze.8.adoc b/sys-utils/fsfreeze.8.adoc index aeea58eece..e21df5b012 100644 --- a/sys-utils/fsfreeze.8.adoc +++ b/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 diff --git a/sys-utils/fstrim.8.adoc b/sys-utils/fstrim.8.adoc index b5c9eb3062..7accc42730 100644 --- a/sys-utils/fstrim.8.adoc +++ b/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 diff --git a/sys-utils/hwclock.8.adoc b/sys-utils/hwclock.8.adoc index aa9f3337bd..0d32b0a642 100644 --- a/sys-utils/hwclock.8.adoc +++ b/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 diff --git a/sys-utils/ipcmk.1.adoc b/sys-utils/ipcmk.1.adoc index f8d0f002a6..605b9286ca 100644 --- a/sys-utils/ipcmk.1.adoc +++ b/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 diff --git a/sys-utils/ipcrm.1.adoc b/sys-utils/ipcrm.1.adoc index b577adb2e6..98e3638921 100644 --- a/sys-utils/ipcrm.1.adoc +++ b/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 diff --git a/sys-utils/ipcs.1.adoc b/sys-utils/ipcs.1.adoc index eb19a91ceb..0234232b46 100644 --- a/sys-utils/ipcs.1.adoc +++ b/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 diff --git a/sys-utils/irqtop.1.adoc b/sys-utils/irqtop.1.adoc index 987efba6aa..3f215d2f0e 100644 --- a/sys-utils/irqtop.1.adoc +++ b/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 diff --git a/sys-utils/ldattach.8.adoc b/sys-utils/ldattach.8.adoc index 22619325d7..a67b23626d 100644 --- a/sys-utils/ldattach.8.adoc +++ b/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 diff --git a/sys-utils/losetup.8.adoc b/sys-utils/losetup.8.adoc index 52df95bd67..075d079fd1 100644 --- a/sys-utils/losetup.8.adoc +++ b/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). diff --git a/sys-utils/lscpu.1.adoc b/sys-utils/lscpu.1.adoc index 1ab78f3efd..639ee166fc 100644 --- a/sys-utils/lscpu.1.adoc +++ b/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*. diff --git a/sys-utils/lsipc.1.adoc b/sys-utils/lsipc.1.adoc index dea014d8ed..fdf29ec27a 100644 --- a/sys-utils/lsipc.1.adoc +++ b/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 diff --git a/sys-utils/lsirq.1.adoc b/sys-utils/lsirq.1.adoc index 30e5912704..67bd69023b 100644 --- a/sys-utils/lsirq.1.adoc +++ b/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 diff --git a/sys-utils/lsmem.1.adoc b/sys-utils/lsmem.1.adoc index 5d224c77aa..10460a86e2 100644 --- a/sys-utils/lsmem.1.adoc +++ b/sys-utils/lsmem.1.adoc @@ -36,9 +36,6 @@ List each individual memory block, instead of combining memory blocks with simil *-b*, *--bytes*:: include::man-common/in-bytes.adoc[] -*-h*, *--help*:: -Display help text and exit. - *-J*, *--json*:: Use JSON output format. @@ -63,8 +60,7 @@ Specify which columns (attributes) use to split memory blocks to ranges. The sup *-s*, *--sysroot* _directory_:: Gather memory data for a Linux instance other than the instance from which the *lsmem* command is issued. The specified _directory_ is the system root of the Linux instance to be inspected. -*-V*, *--version*:: -Display version information and exit. +include::man-common/help-version.adoc[] *--summary*[=_when_]:: This option controls summary lines output. The optional argument _when_ can be *never*, *always* or *only*. If the _when_ argument is omitted, it defaults to *"only"*. The summary output is suppressed for *--raw*, *--pairs* and *--json*. diff --git a/sys-utils/lsns.8.adoc b/sys-utils/lsns.8.adoc index d853f0656b..e4114b716c 100644 --- a/sys-utils/lsns.8.adoc +++ b/sys-utils/lsns.8.adoc @@ -67,12 +67,7 @@ Do not use multi-line text in columns. Use tree-like output format. If *process* is given as _rel_, print process tree(s) in each name space. This is default when *--tree* is not specified. If *parent* is given, print tree(s) constructed by the parent/child relationship. If *owner* is given, print tree(s) constructed by the owner/owned relationship. *owner* is used as default when _rel_ is omitted. - -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == AUTHORS diff --git a/sys-utils/mount.8.adoc b/sys-utils/mount.8.adoc index 6f4465d0d4..a308be7671 100644 --- a/sys-utils/mount.8.adoc +++ b/sys-utils/mount.8.adoc @@ -443,11 +443,7 @@ A synonym is *-o rw*. + Note that specifying *-w* on the command line forces *mount* to never try read-only mount on write-protected devices or already mounted read-only filesystems. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == FILESYSTEM-INDEPENDENT MOUNT OPTIONS diff --git a/sys-utils/mountpoint.1.adoc b/sys-utils/mountpoint.1.adoc index bdcb160905..bc8a2e9ed6 100644 --- a/sys-utils/mountpoint.1.adoc +++ b/sys-utils/mountpoint.1.adoc @@ -34,11 +34,7 @@ Do not follow symbolic link if it the last element of the _directory_ path. *-x*, *--devno*:: Show the major/minor numbers of the given blockdevice on standard output. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == EXIT STATUS diff --git a/sys-utils/nsenter.1.adoc b/sys-utils/nsenter.1.adoc index df92fc2608..2500ff2071 100644 --- a/sys-utils/nsenter.1.adoc +++ b/sys-utils/nsenter.1.adoc @@ -127,11 +127,7 @@ Do not fork before exec'ing the specified program. By default, when entering a P *-Z*, *--follow-context*:: Set the SELinux security context used for executing a new process according to already running process specified by *--target* PID. (The util-linux has to be compiled with SELinux support otherwise the option is unavailable.) -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == AUTHORS diff --git a/sys-utils/pivot_root.8.adoc b/sys-utils/pivot_root.8.adoc index c486d34ec1..9eba2902c8 100644 --- a/sys-utils/pivot_root.8.adoc +++ b/sys-utils/pivot_root.8.adoc @@ -32,11 +32,7 @@ Note that *exec chroot* changes the running executable, which is necessary if th == OPTIONS -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == EXAMPLE diff --git a/sys-utils/prlimit.1.adoc b/sys-utils/prlimit.1.adoc index 0a471954bd..bc8c9a12d4 100644 --- a/sys-utils/prlimit.1.adoc +++ b/sys-utils/prlimit.1.adoc @@ -40,9 +40,6 @@ Because of the nature of limits, the soft limit must be lower or equal to the hi == GENERAL OPTIONS -*-h, --help*:: -Display help text and exit. - *--noheadings*:: Do not print a header line. @@ -58,8 +55,7 @@ Use the raw output format. *--verbose*:: Verbose mode. -*-V, --version*:: -Display version information and exit. +include::man-common/help-version.adoc[] == RESOURCE OPTIONS diff --git a/sys-utils/readprofile.8.adoc b/sys-utils/readprofile.8.adoc index a334d0eade..62613c3519 100644 --- a/sys-utils/readprofile.8.adoc +++ b/sys-utils/readprofile.8.adoc @@ -51,11 +51,7 @@ Print individual counters within functions. *-v*, *--verbose*:: Verbose. The output is organized in four columns and filled with blanks. The first column is the RAM address of a kernel function, the second is the name of the function, the third is the number of clock ticks and the last is the normalized load. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == FILES diff --git a/sys-utils/renice.1.adoc b/sys-utils/renice.1.adoc index 4187cd6016..26392c2d79 100644 --- a/sys-utils/renice.1.adoc +++ b/sys-utils/renice.1.adoc @@ -66,11 +66,7 @@ Interpret the succeeding arguments as process IDs (the default). *-u*, *--user*:: Interpret the succeeding arguments as usernames or UIDs. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == FILES diff --git a/sys-utils/rfkill.8.adoc b/sys-utils/rfkill.8.adoc index 426583ae90..fcdab414a4 100644 --- a/sys-utils/rfkill.8.adoc +++ b/sys-utils/rfkill.8.adoc @@ -39,11 +39,7 @@ Output all available columns. *-r*, *--raw*:: Use the raw output format. -*--help*:: -Display help text and exit. - -*--version*:: -Display version information and exit. +include::man-common/help-version.adoc[] == COMMANDS diff --git a/sys-utils/rtcwake.8.adoc b/sys-utils/rtcwake.8.adoc index 9dd19c0aed..a6c4402bab 100644 --- a/sys-utils/rtcwake.8.adoc +++ b/sys-utils/rtcwake.8.adoc @@ -105,11 +105,7 @@ Assume that the hardware clock is set to UTC (Universal Time Coordinated), regar *-v*, *--verbose*:: Be verbose. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == NOTES diff --git a/sys-utils/setarch.8.adoc b/sys-utils/setarch.8.adoc index 70bfd86127..d204028f4f 100644 --- a/sys-utils/setarch.8.adoc +++ b/sys-utils/setarch.8.adoc @@ -70,11 +70,7 @@ If this is set then *mmap*(3p) *PROT_READ* will also add the *PROT_EXEC* bit - a *-Z*, *--mmap-page-zero*:: SVr4 bug emulation that will set *mmap*(3p) page zero as read-only. Use when _program_ depends on this behavior, and the source code is not available to be fixed. Turns on *MMAP_PAGE_ZERO*. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == EXAMPLE diff --git a/sys-utils/setpriv.1.adoc b/sys-utils/setpriv.1.adoc index 32904dcf46..a0ad6f8dfa 100644 --- a/sys-utils/setpriv.1.adoc +++ b/sys-utils/setpriv.1.adoc @@ -89,11 +89,7 @@ Clears all the environment variables except *TERM*; initializes the environment + The environment variable *PATH* may be different on systems where _/bin_ and _/sbin_ are merged into _/usr_. The environment variable *SHELL* defaults to */bin/sh* if none is given in the user's passwd entry. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == NOTES diff --git a/sys-utils/swapon.8.adoc b/sys-utils/swapon.8.adoc index 8a827ad529..c10ad82449 100644 --- a/sys-utils/swapon.8.adoc +++ b/sys-utils/swapon.8.adoc @@ -49,9 +49,6 @@ Silently skip devices that do not exist. The _/etc/fstab_ mount option *nofail* *-f*, *--fixpgsz*:: Reinitialize (exec mkswap) the swap space if its page size does not match that of the current running kernel. *mkswap*(8) initializes the whole device and does not check for bad blocks. -*-h*, *--help*:: -Display help text and exit. - *-L* _label_:: Use the partition that has the specified _label_. (For this, access to _/proc/partitions_ is needed.) @@ -89,8 +86,7 @@ Use the partition that has the specified _uuid_. *-v*, *--verbose*:: Be verbose. -*-V*, *--version*:: -Display version information and exit. +include::man-common/help-version.adoc[] == EXIT STATUS diff --git a/sys-utils/switch_root.8.adoc b/sys-utils/switch_root.8.adoc index a1a52c4fdb..3331ea368c 100644 --- a/sys-utils/switch_root.8.adoc +++ b/sys-utils/switch_root.8.adoc @@ -24,11 +24,7 @@ switch_root - switch to another filesystem as the root of the mount tree == OPTIONS -*-h, --help*:: -Display help text and exit. - -*-V, --version*:: -Display version information and exit. +include::man-common/help-version.adoc[] == EXIT STATUS diff --git a/sys-utils/umount.8.adoc b/sys-utils/umount.8.adoc index c1f6e06942..ea7f5ac56f 100644 --- a/sys-utils/umount.8.adoc +++ b/sys-utils/umount.8.adoc @@ -111,11 +111,7 @@ Indicate that the actions should only be taken on filesystems of the specified _ *-v*, *--verbose*:: Verbose mode. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == NON-SUPERUSER UMOUNTS diff --git a/sys-utils/unshare.1.adoc b/sys-utils/unshare.1.adoc index cb1302461e..f3367a8061 100644 --- a/sys-utils/unshare.1.adoc +++ b/sys-utils/unshare.1.adoc @@ -137,11 +137,7 @@ Set the offset of *CLOCK_MONOTONIC* which will be used in the entered time names *--boottime* _offset_:: Set the offset of *CLOCK_BOOTTIME* which will be used in the entered time namespace. This option requires unsharing a time namespace with *--time*. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == NOTES diff --git a/sys-utils/wdctl.8.adoc b/sys-utils/wdctl.8.adoc index ee7cf96d7f..6eb44e5d86 100644 --- a/sys-utils/wdctl.8.adoc +++ b/sys-utils/wdctl.8.adoc @@ -63,11 +63,7 @@ Do not print watchdog timeouts. *-x*, *--flags-only*:: Same as *-I -T*. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == AUTHORS diff --git a/sys-utils/zramctl.8.adoc b/sys-utils/zramctl.8.adoc index 2bb4f96239..cdfb13d161 100644 --- a/sys-utils/zramctl.8.adoc +++ b/sys-utils/zramctl.8.adoc @@ -67,11 +67,7 @@ The _size_ argument may be followed by the multiplicative suffixes KiB (=1024), *-t*, *--streams* _number_:: Set the maximum number of compression streams that can be used for the device. The default is use all CPUs and one stream for kernels older than 4.6. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == EXIT STATUS diff --git a/term-utils/agetty.8.adoc b/term-utils/agetty.8.adoc index f75a12f25f..9274b1020f 100644 --- a/term-utils/agetty.8.adoc +++ b/term-utils/agetty.8.adoc @@ -180,11 +180,7 @@ Run login with this priority. *--reload*:: Ask all running agetty instances to reload and update their displayed prompts, if the user has not yet commenced logging in. After doing so the command will exit. This feature might be unsupported on systems without Linux *inotify*(7). -*--version*:: -Display version information and exit. - -*--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == EXAMPLE diff --git a/term-utils/mesg.1.adoc b/term-utils/mesg.1.adoc index 1375ffdff2..5ccef72884 100644 --- a/term-utils/mesg.1.adoc +++ b/term-utils/mesg.1.adoc @@ -71,11 +71,7 @@ If no arguments are given, *mesg* shows the current message status on standard e *-v*, *--verbose*:: Explain what is being done. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == EXIT STATUS diff --git a/term-utils/script.1.adoc b/term-utils/script.1.adoc index 3c84de0e93..957cc29c7b 100644 --- a/term-utils/script.1.adoc +++ b/term-utils/script.1.adoc @@ -118,11 +118,7 @@ Be quiet (do not write start and done messages to standard output). *-t*[_file_], *--timing*[=_file_]:: Output timing data to standard error, or to _file_ when given. This option is deprecated in favour of *--log-timing* where the _file_ argument is not optional. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == SIGNALS diff --git a/term-utils/scriptlive.1.adoc b/term-utils/scriptlive.1.adoc index 0ba5da08d4..73e8faf5d3 100644 --- a/term-utils/scriptlive.1.adoc +++ b/term-utils/scriptlive.1.adoc @@ -45,11 +45,7 @@ Speed up the replay displaying this _number_ of times. The argument is a floatin *-m*, *--maxdelay* _number_:: Set the maximum delay between updates to _number_ of seconds. The argument is a floating-point number. This can be used to avoid long pauses in the typescript replay. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == EXAMPLES diff --git a/term-utils/scriptreplay.1.adoc b/term-utils/scriptreplay.1.adoc index 3f96a2d42c..4b3d448e33 100644 --- a/term-utils/scriptreplay.1.adoc +++ b/term-utils/scriptreplay.1.adoc @@ -62,11 +62,7 @@ Display details about the session recorded in the specified timing file and exit *-x*, *--stream* _type_:: Forces *scriptreplay* to print only the specified stream. The supported stream types are _in_, _out_, _signal_, or _info_. This option is recommended for multi-stream logs (e.g., *--log-io*) in order to print only specified data. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == EXAMPLES diff --git a/term-utils/setterm.1.adoc b/term-utils/setterm.1.adoc index 7c45cd2e2f..68b8554cb5 100644 --- a/term-utils/setterm.1.adoc +++ b/term-utils/setterm.1.adoc @@ -154,11 +154,7 @@ Sets the color for underlined characters. Virtual consoles only. *--underline* on|off:: Turns underline mode on or off. -*--version*:: -Displays version information and exits. - -*--help*:: -Displays a help text and exits. +include::man-common/help-version.adoc[] == COMPATIBILITY diff --git a/term-utils/wall.1.adoc b/term-utils/wall.1.adoc index 775791e8fa..441871d41c 100644 --- a/term-utils/wall.1.adoc +++ b/term-utils/wall.1.adoc @@ -68,11 +68,7 @@ Abandon the write attempt to the terminals after _timeout_ seconds. This _timeou *-g*, *--group* _group_:: Limit printing message to members of group defined as a _group_ argument. The argument can be group name or GID. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == NOTES diff --git a/term-utils/write.1.adoc b/term-utils/write.1.adoc index b65be35484..d18977f1af 100644 --- a/term-utils/write.1.adoc +++ b/term-utils/write.1.adoc @@ -71,11 +71,7 @@ The traditional protocol for writing to someone is that the string _-o_, either == OPTIONS -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == HISTORY diff --git a/text-utils/col.1.adoc b/text-utils/col.1.adoc index 823c9a8cac..cb9790f574 100644 --- a/text-utils/col.1.adoc +++ b/text-utils/col.1.adoc @@ -77,11 +77,7 @@ Force unknown control sequences to be passed through unchanged. Normally *col* w *-x*, *--spaces*:: Output multiple spaces instead of tabs. -*-V*, *--version*:: -Display version information and exit. - -*-H*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == CONFORMING TO diff --git a/text-utils/colcrt.1.adoc b/text-utils/colcrt.1.adoc index 0ffdf388e1..06519983a2 100644 --- a/text-utils/colcrt.1.adoc +++ b/text-utils/colcrt.1.adoc @@ -61,11 +61,7 @@ Suppress all underlining. This option is especially useful for previewing _allbo *-2*, *--half-lines*:: Causes all half-lines to be printed, effectively double spacing the output. Normally, a minimal space output format is used which will suppress empty lines. The program never suppresses two consecutive empty lines, however. The *-2* option is useful for sending output to the line printer when the output contains superscripts and subscripts which would otherwise be invisible. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == HISTORY diff --git a/text-utils/colrm.1.adoc b/text-utils/colrm.1.adoc index 2a41e9de53..529133961a 100644 --- a/text-utils/colrm.1.adoc +++ b/text-utils/colrm.1.adoc @@ -58,11 +58,7 @@ Column numbering starts with column 1. == OPTIONS -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == HISTORY diff --git a/text-utils/column.1.adoc b/text-utils/column.1.adoc index e0f7f57ed6..02ea3ce85e 100644 --- a/text-utils/column.1.adoc +++ b/text-utils/column.1.adoc @@ -132,11 +132,7 @@ Specify column with parent ID to create child-parent relation. *-x, --fillrows*:: Fill rows before filling columns. -*-V*, *--version*:: -Display version information and exit. - -*-h, --help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == ENVIRONMENT diff --git a/text-utils/hexdump.1.adoc b/text-utils/hexdump.1.adoc index 6f35f4dc0a..a4f13761d9 100644 --- a/text-utils/hexdump.1.adoc +++ b/text-utils/hexdump.1.adoc @@ -95,11 +95,7 @@ The *-v* option causes *hexdump* to display all input data. Without the *-v* opt *-x*, *--two-bytes-hex*:: _Two-byte hexadecimal display_. Display the input offset in hexadecimal, followed by eight space-separated, four-column, zero-filled, two-byte quantities of input data, in hexadecimal, per line. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] For each input file, *hexdump* sequentially copies the input to standard output, transforming the data according to the format strings specified by the *-e* and *-f* options, in the order that they were specified. @@ -113,7 +109,7 @@ The byte count is an optional positive integer. If specified it defines the numb If an iteration count and/or a byte count is specified, a single slash must be placed after the iteration count and/or before the byte count to disambiguate them. Any whitespace before or after the slash is ignored. -The format is required and must be surrounded by double quote (" ") marks. It is interpreted as a fprintf-style format string (see *fprintf*(3), with the following exceptions: +The format is required and must be surrounded by double quote (" ") marks. It is interpreted as a fprintf-style format string (see *fprintf*(3)), with the following exceptions: 1.:: An asterisk (*) may not be used as a field width or precision. diff --git a/text-utils/more.1.adoc b/text-utils/more.1.adoc index ea1b669c46..40f2422f30 100644 --- a/text-utils/more.1.adoc +++ b/text-utils/more.1.adoc @@ -95,11 +95,7 @@ Start displaying each file at line _number_. **+**/__string__:: The _string_ to be searched in each file before starting to display it. -*--help*:: -Display help text and exit. - -*-V*, *--version*:: -Display version information and exit. +include::man-common/help-version.adoc[] == COMMANDS diff --git a/text-utils/pg.1.adoc b/text-utils/pg.1.adoc index e92b847765..62b456e9ac 100644 --- a/text-utils/pg.1.adoc +++ b/text-utils/pg.1.adoc @@ -59,11 +59,7 @@ Disallow the shell escape. *-s*:: Print messages in _standout_ mode, if the terminfo entry for the terminal provides this capability. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == COMMANDS diff --git a/text-utils/rev.1.adoc b/text-utils/rev.1.adoc index fbef783f43..9076a7d374 100644 --- a/text-utils/rev.1.adoc +++ b/text-utils/rev.1.adoc @@ -56,11 +56,7 @@ This utility is a line-oriented tool and it uses in-memory allocated buffer for == OPTIONS -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == SEE ALSO diff --git a/text-utils/ul.1.adoc b/text-utils/ul.1.adoc index b192356fc4..bc19e61d76 100644 --- a/text-utils/ul.1.adoc +++ b/text-utils/ul.1.adoc @@ -60,11 +60,7 @@ Underlining is indicated by a separate line containing appropriate dashes `-'; t *-t*, *-T*, *--terminal* _terminal_:: Override the environment variable *TERM* with the specified _terminal_ type. -*-V*, *--version*:: -Display version information and exit. - -*-h*, *--help*:: -Display help text and exit. +include::man-common/help-version.adoc[] == ENVIRONMENT