Manual pages: order ENVIRONMENT / FILES / CONFORMING TO consistently

There is value in ensuring that manual page sections use consistently
named sections, as far as possible, and also that sections have a
consistent order within manual pages. This is one of a series of patches
to place manual page sections in a consistent order.

In this patch, we ensure that the ENVIRONMENT, FILES, and CONFORMING TO
sections are always placed toward the end of the page, just above NOTES.

One page is not fixed by this patch: term-utils/agetty.8. This page
is a mess of unusual section names, and probably requires an individual
edit.

Testing that no gross editing mistake (causing accidental loss or addition
of text) was performed as follows:

    $ cat $(grep '\.SH' -l $(find . -name '*.[1-9]') |sort) | sort > a
    [Apply patch]
    $ cat $(grep '\.SH' -l $(find . -name '*.[1-9]') |sort) | sort > b
    $ diff a b
    $ echo $?
    0

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk (man-pages) 2020-05-21 09:28:49 +02:00 committed by Karel Zak
parent 67e63c1263
commit 380fd9aa95
5 changed files with 28 additions and 28 deletions

View File

@ -343,8 +343,6 @@ You're almost certainly doing something that you shouldn't be doing
with
.BR fsck .
Options to different filesystem-specific fsck's are not standardized.
.SH FILES
.I /etc/fstab
.SH ENVIRONMENT
The
.B fsck
@ -388,6 +386,8 @@ enables libblkid debug output.
.TP
.B LIBMOUNT_DEBUG=all
enables libmount debug output.
.SH FILES
.I /etc/fstab
.SH AUTHORS
.nf
Theodore Ts'o <tytso@mit.edu>

View File

@ -145,6 +145,10 @@ Lines where the first non-blank character is a # (hash) are ignored.
Any other use of the hash character is not interpreted as introducing
a comment.
.SH ENVIRONMENT
.IP TERMINAL_COLORS_DEBUG=all
enables debug output.
.SH FILES
.I $XDG_CONFIG_HOME/terminal-colors.d
.br
@ -152,10 +156,6 @@ a comment.
.br
.I /etc/terminal-colors.d
.SH ENVIRONMENT
.IP TERMINAL_COLORS_DEBUG=all
enables debug output.
.SH EXAMPLE
Disable colors for all compatible utilities:
.RS

View File

@ -178,6 +178,10 @@ displays the status of a loop device, it returns 1 if the device
is not configured and 2 if an error occurred which prevented
determining the status of the device.
.SH ENVIRONMENT
.IP LOOPDEV_DEBUG=all
enables debug output.
.SH FILES
.TP
.I /dev/loop[0..N]
@ -185,10 +189,6 @@ loop block devices
.TP
.I /dev/loop-control
loop control device
.SH ENVIRONMENT
.IP LOOPDEV_DEBUG=all
enables debug output.
.SH EXAMPLE
The following commands can be used as an example of using the loop device.
.nf

View File

@ -2574,6 +2574,17 @@ and
to the mount.<suffix> helpers. All other options are used in a
comma-separated list as argument to the \fB\-o\fR option.
.SH ENVIRONMENT
.IP LIBMOUNT_FSTAB=<path>
overrides the default location of the fstab file (ignored for suid)
.IP LIBMOUNT_MTAB=<path>
overrides the default location of the mtab file (ignored for suid)
.IP LIBMOUNT_DEBUG=all
enables libmount debug output
.IP LIBBLKID_DEBUG=all
enables libblkid debug output
.IP LOOPDEV_DEBUG=all
enables loop device setup debug output
.SH FILES
See also "\fBThe files /etc/fstab, /etc/mtab and /proc/mounts\fR" section above.
.TP 18n
@ -2594,17 +2605,6 @@ temporary file (unused on systems with mtab symlink)
.TP
.I /etc/filesystems
a list of filesystem types to try
.SH ENVIRONMENT
.IP LIBMOUNT_FSTAB=<path>
overrides the default location of the fstab file (ignored for suid)
.IP LIBMOUNT_MTAB=<path>
overrides the default location of the mtab file (ignored for suid)
.IP LIBMOUNT_DEBUG=all
enables libmount debug output
.IP LIBBLKID_DEBUG=all
enables libblkid debug output
.IP LOOPDEV_DEBUG=all
enables loop device setup debug output
.SH HISTORY
A
.B mount

View File

@ -253,6 +253,13 @@ to the \fB/sbin/umount.\fItype\fR helper independently of UID.
.PP
Note that \fI/etc/mtab\fR is currently deprecated and helper= and another
userspace mount options are maintained by libmount.
.SH ENVIRONMENT
.IP LIBMOUNT_FSTAB=<path>
overrides the default location of the fstab file (ignored for suid)
.IP LIBMOUNT_MTAB=<path>
overrides the default location of the mtab file (ignored for suid)
.IP LIBMOUNT_DEBUG=all
enables libmount debug output
.SH FILES
.TP
.I /etc/mtab
@ -264,13 +271,6 @@ table of known filesystems
.TP
.I /proc/self/mountinfo
table of mounted filesystems generated by kernel.
.SH ENVIRONMENT
.IP LIBMOUNT_FSTAB=<path>
overrides the default location of the fstab file (ignored for suid)
.IP LIBMOUNT_MTAB=<path>
overrides the default location of the mtab file (ignored for suid)
.IP LIBMOUNT_DEBUG=all
enables libmount debug output
.SH HISTORY
A
.B umount