ericonr
/
util-linux
mirror of https://github.com/ericonr/util-linux.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
util-linux/sys-utils
History
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 build-sys: .gitignore hwclock-parse-date.c 2019-11-07 10:43:46 +01:00
Makemodule.am lsirq: add new command 2020-03-06 16:21:10 +01:00
adjtime_config.5 docs: (man) remove double quotes (") in .SH lines 2020-05-19 12:15:34 +02:00
blkdiscard.8 Manual pages: Standardize on AUTHORS as section title 2020-05-20 12:56:12 +02:00
blkdiscard.c docs: improve size arguments description in --help output 2020-02-05 11:01:36 +01:00
blkzone.8 blkzone: add open/close/finish commands 2020-03-25 12:27:13 +01:00
blkzone.c blkzone: deny destructive ioctls on busy blockdev 2020-05-15 14:53:11 +02:00
chcpu.8 Manual pages: use the term "exit status" 2020-05-20 12:56:52 +02:00
chcpu.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
chmem.8 Manual pages: use the term "exit status" 2020-05-20 12:56:52 +02:00
chmem.c [clang-tidy] fix wrong *cmp usage 2020-04-20 13:21:00 -07:00
choom.1 choom: improve docs 2019-08-01 11:06:06 +02:00
choom.c choom: improve docs 2019-08-01 11:06:06 +02:00
ctrlaltdel.8 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
ctrlaltdel.c ctrlaltdel: display error message indicated by errno 2020-03-29 20:19:11 +01:00
dmesg.1 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
dmesg.c dmesg: do not stop on \0 2019-09-10 10:34:01 +02:00
eject.1 man pages: Add a comma after "e.g." and "i.e." 2019-12-17 12:32:43 +01:00
eject.c docs: Fix dead references to kernel documentation 2020-05-18 10:35:31 +02:00
fallocate.1 Manual pages: use the term "exit status" 2020-05-20 12:56:52 +02:00
fallocate.c docs: improve size arguments description in --help output 2020-02-05 11:01:36 +01:00
flock.1 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
flock.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
fsfreeze.8 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
fsfreeze.c fsfreeze: remove unnecessary condition [lgtm scan] 2019-09-20 15:57:31 +02:00
fstab.5 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
fstrim.8 Manual pages: Standardize on EXIT STATUS as section title 2020-05-20 12:56:12 +02:00
fstrim.c fstrim: rename --quite to --quite-unsupported 2020-03-31 12:26:54 +02:00
fstrim.service.in fstrim: run service and timer only if /etc/fstab is present 2020-04-27 10:08:53 +00:00
fstrim.timer fstrim: run service and timer only if /etc/fstab is present 2020-04-27 10:08:53 +00:00
hwclock-cmos.c hwclock: add SPDX-License-Identifier(s) 2019-11-08 11:12:13 +01:00
hwclock-parse-date.y hwclock: update yacc file 2020-02-15 15:24:01 +00:00
hwclock-rtc.c [clang-tidy] do not use else after return 2020-04-20 13:20:59 -07:00
hwclock.8.in docs: Fix adjtime documentation 2019-12-06 12:50:46 +01:00
hwclock.c [clang-tidy] use ceil 2020-04-20 13:21:00 -07:00
hwclock.h build-sys: use parse-date() only for hwclock 2019-11-07 09:02:23 +01:00
ipcmk.1 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
ipcmk.c docs: improve size arguments description in --help output 2020-02-05 11:01:36 +01:00
ipcrm.1 man pages: Change a HYPHEN-MINUS (-) to a minus (\-) for options and numbers 2019-12-17 12:32:43 +01:00
ipcrm.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
ipcs.1 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
ipcs.c [clang-tidy] do not return in void functions 2020-04-19 14:03:21 -07:00
ipcutils.c [clang-tidy] do not use else after return 2020-04-20 13:20:59 -07:00
ipcutils.h ipcs: use new ul_path_* API 2018-06-21 13:07:46 +02:00
irq-common.c lsirq: add -P option 2020-03-06 16:34:51 +01:00
irq-common.h lsirq: add -P option 2020-03-06 16:34:51 +01:00
irqtop.1 docs: fix spacing in irqtop and lsirq manual pages 2020-03-07 06:38:57 +00:00
irqtop.c lsirq: add new command 2020-03-06 16:21:10 +01:00
ldattach.8 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
ldattach.c [clang-tidy] do not return in void functions 2020-04-19 14:03:21 -07:00
losetup.8 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
losetup.c losetup: Typo fix 2019-06-21 14:38:32 +02:00
lscpu-arm.c [clang-tidy] fix wrong *cmp usage 2020-04-20 13:21:00 -07:00
lscpu-dmi.c lscpu: top-level DMI function refactoring 2019-11-20 11:33:59 +01:00
lscpu.1 Manual pages: Standardize on AUTHORS as section title 2020-05-20 12:56:12 +02:00
lscpu.c [clang-tidy] fix wrong *cmp usage 2020-04-20 13:21:00 -07:00
lscpu.h lscpu: add a new columns to --cache 2019-06-17 15:46:10 +02:00
lsipc.1 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
lsipc.c [clang-tidy] do not use else after return 2020-04-20 13:20:59 -07:00
lsirq.1 docs: fix spacing in irqtop and lsirq manual pages 2020-03-07 06:38:57 +00:00
lsirq.c lsirq: mark --json and --pairs options mutually exclusive 2020-03-07 06:38:57 +00:00
lsmem.1 Manual pages: Standardize on AUTHORS as section title 2020-05-20 12:56:12 +02:00
lsmem.c [clang-tidy] fix wrong *cmp usage 2020-04-20 13:21:00 -07:00
lsns.8 docs: (man) remove double quotes (") in .SH lines 2020-05-19 12:15:34 +02:00
lsns.c [clang-tidy] do not use else after return 2020-04-20 13:20:59 -07:00
mount.8 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
mount.c mount: support "-o move" on command line 2020-04-15 13:39:48 +02:00
mountpoint.1 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
mountpoint.c mountpoint: add --nofollow option 2019-08-02 19:39:05 +01:00
nsenter.1 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
nsenter.c nsenter: add support for the time namespace 2020-03-10 07:46:37 +01:00
pivot_root.8 Manual pages: Standardize on EXAMPLE as section title 2020-05-20 12:56:12 +02:00
pivot_root.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
prlimit.1 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
prlimit.c [clang-tidy] do not use else after return 2020-04-20 13:20:59 -07:00
readprofile.8 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
readprofile.c readprofile: be more explicit with used types [cppcheck] 2019-05-28 12:17:26 +02:00
renice.1 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
renice.c renice: fix arguments description in --help 2019-11-08 11:32:18 +01:00
rfkill.8 Manual pages: Standardize on EXAMPLE as section title 2020-05-20 12:56:12 +02:00
rfkill.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
rtcwake.8.in man pages: Add a comma after "e.g." and "i.e." 2019-12-17 12:32:43 +01:00
rtcwake.c various: fix more lgtm scan warnings 2020-02-20 20:18:46 +00:00
setarch.8 Manual pages: Standardize on EXAMPLE as section title 2020-05-20 12:56:12 +02:00
setarch.c [clang-tidy] fix wrong *cmp usage 2020-04-20 13:21:00 -07:00
setpriv.1 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
setpriv.c unshare: add --keep-caps option 2019-09-09 20:23:08 -07:00
setsid.1 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
setsid.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
swapoff.8 build-sys: move swapon from mount/ to sys-utils/ 2012-01-11 12:14:29 +01:00
swapoff.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
swapon-common.c mount, umount, swapon, fsck, lsblk, findmnt: harmonize six error messages 2016-03-16 10:39:38 +01:00
swapon-common.h swapon: split swapon-common.c 2014-09-22 13:16:25 +02:00
swapon.8 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
swapon.c [clang-tidy] do not return in void functions 2020-04-19 14:03:21 -07:00
switch_root.8 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
switch_root.c misc: consolidate version printing and close_stdout() 2019-04-16 15:14:13 +02:00
tunelp.8 Manual pages: order NOTES / HISTORY / BUGS / EXAMPLE consistently 2020-05-22 10:25:50 +02:00
tunelp.c [clang-tidy] fix misleading identation 2020-04-20 13:21:00 -07:00
umount.8 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
umount.c umount: don't try it as non-suid if not found mountinfo entry 2020-02-24 13:02:09 +01:00
unshare.1 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
unshare.c unshare: Fix PID and TIME namespace persistence 2020-04-30 10:59:38 +02:00
wdctl.8 wdctl; read from /sys if necessary 2019-06-17 15:47:39 +02:00
wdctl.c wdctl: remove duplicate include of <unistd.h> 2019-08-19 15:00:35 +02:00
zramctl.8 Manual pages: order AUTHORS / COPYRIGHT / SEE ALSO / AVAILABILITY consistently 2020-05-22 10:25:49 +02:00
zramctl.c [clang-tidy] do not use else after return 2020-04-20 13:20:59 -07:00