Manual pages: rename EXAMPLE section to EXAMPLES

Earlier, I patched various pages to consistently use EXAMPLE as a
section heading, rather than EXAMPLES.  (At that time, both headings
occurred in util-linux, with roughly equal frequency.)

Since then, I've observed that EXAMPLES is the more common usage
across a large corpus of manual pages. So, in Linux the man-pages
project, I switched to using EXAMPLES also. This patch makes the same
change for util-linux.

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk (man-pages) 2020-05-25 14:59:12 +02:00 committed by Karel Zak
parent 79a0cc9d02
commit 3bc92f313a
16 changed files with 17 additions and 17 deletions

View File

@ -349,7 +349,7 @@ For the priority order and intended purposes of these facilities and levels, see
The
.B logger
command is expected to be IEEE Std 1003.2 ("POSIX.2") compatible.
.SH EXAMPLE
.SH EXAMPLES
.B logger System rebooted
.br
.B logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc

View File

@ -108,7 +108,7 @@ the alternative dictionary
The
.B look
utility appeared in Version 7 AT&T Unix.
.SH EXAMPLE
.SH EXAMPLES
.RS
.nf
sort \-d /etc/passwd \-o /tmp/look.dict

View File

@ -84,7 +84,7 @@ nothing was renamed
unanticipated error occurred
.PD
.RE
.SH EXAMPLE
.SH EXAMPLES
Given the files
.IR foo1 ", ..., " foo9 ", " foo10 ", ..., " foo278 ,
the commands

View File

@ -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 EXAMPLE
.SH EXAMPLES
uuidgen \-\-sha1 \-\-namespace @dns \-\-name "www.example.com"
.SH AUTHORS
.B uuidgen

View File

@ -153,7 +153,7 @@ are displayed with
.SH ENVIRONMENT
.IP WHEREIS_DEBUG=all
enables debug output.
.SH EXAMPLE
.SH EXAMPLES
To find all files in
.I /usr/\:bin
which are not documented

View File

@ -116,7 +116,7 @@ Display version information and exit.
.SH NOTES
Linux supports I/O scheduling priorities and classes since 2.6.13 with the CFQ
I/O scheduler.
.SH EXAMPLE
.SH EXAMPLES
.LP
.TP 7
# \fBionice\fP \-c 3 \-p 89

View File

@ -137,7 +137,7 @@ option, or 1 by default.
.PP
When using the \fIcommand\fR variant, and executing the child worked, then
the exit status is that of the child command.
.SH EXAMPLE
.SH EXAMPLES
Note that "shell> " in examples is a command line prompt.
.TP
shell1> flock /tmp \-c cat

View File

@ -93,7 +93,7 @@ Timeout for real-time tasks.
The prlimit system call is supported since Linux 2.6.36, older kernels will
break this program.
.SH EXAMPLE
.SH EXAMPLES
.IP "\fBprlimit \-\-pid 13134\fP"
Display limit values for all current resources.
.IP "\fBprlimit \-\-pid 13134 \-\-rss \-\-nofile=1024:4095\fP"

View File

@ -101,7 +101,7 @@ negative (to make things go very fast).
The
.B renice
command appeared in 4.0BSD.
.SH EXAMPLE
.SH EXAMPLES
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

View File

@ -190,7 +190,7 @@ Be careful with this tool \-\- it may have unexpected security consequences.
For example, setting no_new_privs and then execing a program that is
SELinux\-confined (as this tool would do) may prevent the SELinux
restrictions from taking effect.
.SH EXAMPLE
.SH EXAMPLES
If you're looking for behaviour similar to
.BR su (1)/ runuser "(1), or " sudo (8)
(without the

View File

@ -28,7 +28,7 @@ Once a persistent \%namespace is no longer needed,
it can be unpersisted by using
.BR umount (8)
to remove the bind mount.
See the \fBEXAMPLE\fR section for more details.
See the \fBEXAMPLES\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
@ -243,7 +243,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 EXAMPLE
.SH EXAMPLES
.PP
The following command creates a PID namespace, using
.B \-\-fork

View File

@ -65,7 +65,7 @@ Display version information and exit.
.TP
.BR \-h , " \-\-help"
Display help text and exit.
.SH EXAMPLE
.SH EXAMPLES
.nf
% script --log-timing file.tm --log-in script.in
Script started, file is script.out

View File

@ -110,7 +110,7 @@ Display version information and exit.
.TP
.BR \-h , " \-\-help"
Display help text and exit.
.SH EXAMPLE
.SH EXAMPLES
.nf
% script --log-timing file.tm --log-out script.out
Script started, file is script.out

View File

@ -84,7 +84,7 @@ Lines are trimmed to 132 characters.
.PP
Some provision should be made for processing superscripts and subscripts in
documents which are already double-spaced.
.SH EXAMPLE
.SH EXAMPLES
A typical use of
.B colcrt
would be:

View File

@ -157,7 +157,7 @@ has since been corrected (see above). Other implementations of
.B column
may continue to use the older documentation, but the behavior should be
identical in any case.
.SH EXAMPLE
.SH EXAMPLES
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

View File

@ -347,7 +347,7 @@ exits 0 on success and >0 if an error occurred.
The
.B hexdump
utility is expected to be IEEE Std 1003.2 ("POSIX.2") compatible.
.SH EXAMPLE
.SH EXAMPLES
Display the input in perusal format:
.nf
"%06.6_ao " 12/1 "%3_u "