Manual pages: Standardize on EXAMPLE as section title
There is quite some value (in terms of readability and user expectations) if consistent names are used for the sections within manual pages. This patch is one of a series to bring about this consistency. Currently we have EXAMPLE (10) or EXAMPLES (23). Let's standardize on the EXAMPLE (which is also what is suggested in man-pages(7)) and used consistently across a large number of pages in the Linux man-pages project. (I realize the choice to go EXAMPLE, rather than EXAMPLES, may be debatable. If necessary, I'd write a patch that instead goes the other way, but I'd prefer to follow man-pages(7).) Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
a8d0d330cf
commit
bc281b0991
|
@ -144,7 +144,7 @@ Display version information and exit.
|
|||
.TP
|
||||
.BR \-h , " \-\-help"
|
||||
Display help text and exit.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
.TP
|
||||
partx \-\-show /dev/sdb3
|
||||
.TQ
|
||||
|
|
|
@ -50,7 +50,7 @@ or
|
|||
.I $HOME/.config/terminal-colors.d
|
||||
overrides the global setting.
|
||||
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
Disable colors for all compatible utilities:
|
||||
.RS
|
||||
.br
|
||||
|
|
|
@ -260,7 +260,7 @@ It's possible to specify source (device) or target (mountpoint) to filter mount
|
|||
.TP
|
||||
.B \-\-verbose
|
||||
Force findmnt to print more information (\fB\-\-verify\fP only for now).
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
.IP "\fBfindmnt \-\-fstab \-t nfs\fP"
|
||||
Prints all NFS filesystems defined in
|
||||
.IR /etc/fstab .
|
||||
|
|
|
@ -345,7 +345,7 @@ l l.
|
|||
.PP
|
||||
For the priority order and intended purposes of these facilities and levels, see
|
||||
.BR syslog (3).
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
.B logger System rebooted
|
||||
.br
|
||||
.B logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc
|
||||
|
|
|
@ -40,7 +40,7 @@ Display version information and exit.
|
|||
.TP
|
||||
.BR \-h , " \-\-help"
|
||||
Display help text and exit.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
Given the files
|
||||
.IR foo1 ", ..., " foo9 ", " foo10 ", ..., " foo278 ,
|
||||
the commands
|
||||
|
|
|
@ -89,7 +89,7 @@ Generate the hash of the \fIname\fR.
|
|||
Interpret name \fIname\fR as a hexadecimal string.
|
||||
.SH CONFORMING TO
|
||||
OSF DCE 1.1
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
uuidgen \-\-sha1 \-\-namespace @dns \-\-name "www.example.com"
|
||||
.SH AUTHORS
|
||||
.B uuidgen
|
||||
|
|
|
@ -65,7 +65,7 @@ restricted with the \fB\-t\fR option.
|
|||
.TP
|
||||
.BR \-b , " \-\-backup"
|
||||
Create a signature backup to the file $HOME/wipefs-<devname>-<offset>.bak.
|
||||
For more details see the \fBEXAMPLES\fR section.
|
||||
For more details see the \fBEXAMPLE\fR section.
|
||||
.TP
|
||||
.BR \-f , " \-\-force"
|
||||
Force erasure, even if the filesystem is mounted. This is required in
|
||||
|
@ -112,7 +112,7 @@ taken. For more details see mount(8).
|
|||
.TP
|
||||
.BR \-V , " \-\-version"
|
||||
Display version information and exit.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
.TP
|
||||
.B wipefs /dev/sda*
|
||||
Prints information about sda and all partitions on sda.
|
||||
|
|
|
@ -113,7 +113,7 @@ scheduling parameters.
|
|||
.TP
|
||||
.BR \-V , " \-\-version"
|
||||
Display version information and exit.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
.LP
|
||||
.TP 7
|
||||
# \fBionice\fP \-c 3 \-p 89
|
||||
|
|
|
@ -91,7 +91,7 @@ failure
|
|||
.TP
|
||||
.B 64
|
||||
partial success
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
.TP
|
||||
.B chmem \-\-enable 1024
|
||||
This command requests 1024 MiB of memory to be set online.
|
||||
|
|
|
@ -124,7 +124,7 @@ Display version information and exit.
|
|||
.TP
|
||||
.BR \-h , " \-\-help"
|
||||
Display help text and exit.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
Note that "shell> " in examples is a command line prompt.
|
||||
.TP
|
||||
shell1> flock /tmp \-c cat
|
||||
|
|
|
@ -39,7 +39,7 @@ Display version information and exit.
|
|||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Display help text and exit.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
Change the root file system to /dev/hda1 from an interactive shell:
|
||||
.sp
|
||||
.nf
|
||||
|
|
|
@ -89,7 +89,7 @@ Maximum number of file locks held.
|
|||
.IP "\fB\-y, \-\-rttime\fP[=\fIlimits\fR]"
|
||||
Timeout for real-time tasks.
|
||||
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
.IP "\fBprlimit \-\-pid 13134\fP"
|
||||
Display limit values for all current resources.
|
||||
.IP "\fBprlimit \-\-pid 13134 \-\-rss \-\-nofile=1024:4095\fP"
|
||||
|
|
|
@ -90,7 +90,7 @@ Display version information and exit.
|
|||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Display help text and exit.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
Browse the profiling buffer ordering by clock ticks:
|
||||
.nf
|
||||
readprofile | sort \-nr | less
|
||||
|
|
|
@ -77,7 +77,7 @@ Display version information and exit.
|
|||
.TP
|
||||
.BR \-h , " \-\-help"
|
||||
Display help text and exit.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
The following command would change the priority of the processes with
|
||||
PIDs 987 and 32, plus all processes owned by the users daemon and root:
|
||||
.TP
|
||||
|
|
|
@ -74,7 +74,7 @@ Disable the corresponding device.
|
|||
Enable the corresponding device. If the device is hard\-blocked, for example
|
||||
via a hardware switch, it will remain unavailable though it is now
|
||||
soft\-unblocked.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
rfkill --output ID,TYPE
|
||||
.br
|
||||
rfkill block all
|
||||
|
|
|
@ -113,7 +113,7 @@ Display version information and exit.
|
|||
.TP
|
||||
.BR \-h , " \-\-help"
|
||||
Display help text and exit.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
setarch \-\-addr-no-randomize mytestprog
|
||||
.br
|
||||
setarch ppc32 rpmbuild \-\-target=ppc \-\-rebuild foo.src.rpm
|
||||
|
|
|
@ -18,7 +18,7 @@ even after the \fIprogram\fR terminates (except PID namespaces where
|
|||
permanently running init process is required).
|
||||
Once a persistent \%namespace is no longer needed, it can be unpersisted with
|
||||
.BR umount (8).
|
||||
See the \fBEXAMPLES\fR section for more details.
|
||||
See the \fBEXAMPLE\fR section for more details.
|
||||
.PP
|
||||
.B unshare
|
||||
since util-linux version 2.36 uses /\fIproc/[pid]/ns/pid_for_children\fP and \fI/proc/[pid]/ns/time_for_children\fP
|
||||
|
@ -259,7 +259,7 @@ The proc and sysfs filesystems mounting as root in a user namespace have to be
|
|||
restricted so that a less privileged user can not get more access to sensitive
|
||||
files that a more privileged user made unavailable. In short the rule for proc
|
||||
and sysfs is as close to a bind mount as possible.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
.TP
|
||||
.B # unshare \-\-fork \-\-pid \-\-mount-proc readlink /proc/self
|
||||
.TQ
|
||||
|
|
|
@ -305,7 +305,7 @@ Display version information and exit.
|
|||
\-\-help
|
||||
Display help text and exit.
|
||||
.PP
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
This section shows examples for the process field of an entry in the
|
||||
\fI/etc/inittab\fP file. You'll have to prepend appropriate values
|
||||
for the other fields. See \fIinittab(5)\fP for more details.
|
||||
|
|
|
@ -66,7 +66,7 @@ Display version information and exit.
|
|||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Display help text and exit.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
A typical use of
|
||||
.B colcrt
|
||||
would be:
|
||||
|
|
|
@ -126,7 +126,7 @@ Display help text and exit.
|
|||
.SH ENVIRONMENT
|
||||
The environment variable \fBCOLUMNS\fR is used to determine the size of
|
||||
the screen if no other information is available.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
Print fstab with header line and align number to the right:
|
||||
.EX
|
||||
\fBsed 's/#.*//' /etc/fstab | column \-\-table \-\-table-columns SOURCE,TARGET,TYPE,OPTIONS,PASS,FREQ \-\-table-right PASS,FREQ\fR
|
||||
|
|
|
@ -343,7 +343,7 @@ used between format units than in the default output).
|
|||
.SH EXIT STATUS
|
||||
.B hexdump
|
||||
exits 0 on success and >0 if an error occurred.
|
||||
.SH EXAMPLES
|
||||
.SH EXAMPLE
|
||||
Display the input in perusal format:
|
||||
.nf
|
||||
"%06.6_ao " 12/1 "%3_u "
|
||||
|
|
Loading…
Reference in New Issue