util-linux/misc-utils
Michael Kerrisk (man-pages) 67e63c1263 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE 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 NOTES, HISTORY, BUGS, and EXAMPLE
sections are always placed near the end of the page, just above
AUTHORS, COPYRIGHT, SEE ALSO, and AVAILABILITY.

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>
2020-05-22 10:25:50 +02:00
..
.gitignore getopt: use examples installation directory in man page 2020-02-15 15:24:01 +00:00
Makemodule.am getopt: use examples installation directory in man page 2020-02-15 15:24:01 +00:00
blkid.8 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
blkid.c docs: improve size arguments description in --help output 2020-02-05 11:01:36 +01:00
cal.1 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
cal.c cal: Add column mode 2020-05-11 17:27:06 +02:00
fincore.1 docs: (man) remove double quotes (") in .SH lines 2020-05-19 12:15:34 +02:00
fincore.c cleanup: Remove some spurious spaces 2019-10-01 13:01:43 +02:00
findfs.8 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
findfs.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
findmnt-verify.c [clang-tidy] do not use else after return 2020-04-20 13:20:59 -07:00
findmnt.8 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
findmnt.c [clang-tidy] fix wrong *cmp usage 2020-04-20 13:21:00 -07:00
findmnt.h misc-tools/findmnt: add --pseudo, --real filters 2018-05-10 11:58:30 -05:00
getopt-parse.bash getops: make --a-long option work again 2017-05-16 14:54:41 +02:00
getopt-parse.tcsh getops: improve getopt-parse.bash example 2016-07-27 16:08:43 +01:00
getopt.1.in getopt: use examples installation directory in man page 2020-02-15 15:24:01 +00:00
getopt.c [clang-tidy] do not use else after return 2020-04-20 13:20:59 -07:00
hardlink.1 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
hardlink.c [clang-tidy] fix wrong *cmp usage 2020-04-20 13:21:00 -07:00
kill.1 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
kill.c [clang-tidy] do not use else after return 2020-04-20 13:20:59 -07:00
logger.1 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
logger.c various: fix more lgtm scan warnings 2020-02-20 20:18:46 +00:00
look.1 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
look.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
lsblk-devtree.c lsblk: fix -E segfault 2019-07-15 12:28:26 +02:00
lsblk-mnt.c lsblk: rename blkdev_cxt to lsblk_device 2018-12-07 12:32:57 +01:00
lsblk-properties.c lsblk: Fall back to ID_SERIAL 2020-05-04 11:21:01 +02:00
lsblk.8 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
lsblk.c lsblk: Ignore hidden devices 2020-05-14 15:48:26 +02:00
lsblk.h lsblk: add PARTTYPENAME column 2019-12-04 12:38:57 +01:00
lslocks.8 docs: (man) remove double quotes (") in .SH lines 2020-05-19 12:15:34 +02:00
lslocks.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
mcookie.1 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
mcookie.c docs: improve size arguments description in --help output 2020-02-05 11:01:36 +01:00
namei.1 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
namei.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
rename.1 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
rename.c [clang-tidy] do not use else after return 2020-04-20 13:20:59 -07:00
test_uuidd.c misc: replace magic number 37 with UUID_STR_LEN 2017-09-05 11:49:21 +02:00
uuidd.8.in man pages: Change a HYPHEN-MINUS (-) to a minus (\-) for options and numbers 2019-12-17 12:32:43 +01:00
uuidd.c [clang-tidy] do not use else after return 2020-04-20 13:20:59 -07:00
uuidd.rc.in build: use --runstatedir instead of --localstatedir 2017-07-31 15:24:46 +02:00
uuidd.service.in uuidd: Add hardening settings to uuidd.service 2018-11-29 10:37:08 +01:00
uuidd.socket.in build: use --runstatedir instead of --localstatedir 2017-07-31 15:24:46 +02:00
uuidgen.1 Manual pages: Standardize on EXAMPLE as section title 2020-05-20 12:56:12 +02:00
uuidgen.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
uuidparse.1 docs: (man) remove double quotes (") in .SH lines 2020-05-19 12:15:34 +02:00
uuidparse.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
whereis.1 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
whereis.c [clang-tidy] do not return in void functions 2020-04-19 14:03:21 -07:00
wipefs.8 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
wipefs.c docs: improve size arguments description in --help output 2020-02-05 11:01:36 +01:00