Place SEE ALSO entries in order

This patch does only the following: * Order SEE ALSO entries first by section name, then alphabetically within section * Adds one or two missing commas in SEE ALSO lists * Removes one or two periods that were (inconsistently) used at the end of SEE ALSO lists. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:59:27 +01:00 · 2016-11-10 11:59:27 +01:00 · f053ff1e3a
parent 4a2ec98bf1
commit f053ff1e3a
47 changed files with 88 additions and 88 deletions
--- a/disk-utils/cfdisk.8
+++ b/disk-utils/cfdisk.8
@ -189,10 +189,10 @@ use visible padding characters. Requires enabled LIBSMARTCOLS_DEBUG.

 .SH "SEE ALSO"
 .BR fdisk (8),
-.BR sfdisk (8),
 .BR parted (8),
 .BR partprobe (8),
-.BR partx (8)
+.BR partx (8),
+.BR sfdisk (8)
 .SH AUTHOR
 Karel Zak <kzak@redhat.com>
 .PP
--- a/disk-utils/fdformat.8
+++ b/disk-utils/fdformat.8
@ -64,9 +64,9 @@ Display version information and exit.
 Display help text and exit.
 .SH "SEE ALSO"
 .BR fd (4),
-.BR setfdprm (8),
+.BR emkfs (8),
 .BR mkfs (8),
-.BR emkfs (8)
+.BR setfdprm (8)
 .SH AUTHOR
 Werner Almesberger (almesber@nessie.cs.id.ethz.ch)
 .SH AVAILABILITY
--- a/disk-utils/fdisk.8
+++ b/disk-utils/fdisk.8
@ -359,9 +359,9 @@ use visible padding characters. Requires enabled LIBSMARTCOLS_DEBUG.

 .SH "SEE ALSO"
 .BR cfdisk (8),
-.BR sfdisk (8),
 .BR mkfs (8),
-.BR partx (8)
+.BR partx (8),
+.BR sfdisk (8)

 .SH AVAILABILITY
 The fdisk command is part of the util-linux package and is available from
--- a/disk-utils/fsck.8
+++ b/disk-utils/fsck.8
@ -392,13 +392,13 @@ or
 or
 .BR e2fsck (8),
 .BR cramfsck (8),
-.BR fsck.minix (8),
-.BR fsck.msdos (8),
 .BR fsck.jfs (8),
 .BR fsck.nfs (8),
+.BR fsck.minix (8),
+.BR fsck.msdos (8),
 .BR fsck.vfat (8),
 .BR fsck.xfs (8),
-.BR reiserfsck (8).
+.BR reiserfsck (8)
 .ad
 .SH AUTHORS
 .nf
--- a/disk-utils/fsck.minix.8
+++ b/disk-utils/fsck.minix.8
@ -158,8 +158,8 @@ Russell King
 .BR fsck (8),
 .BR fsck.ext2 (8),
 .BR mkfs (8),
-.BR mkfs.minix (8),
 .BR mkfs.ext2 (8),
+.BR mkfs.minix (8),
 .BR reboot (8)
 .SH AVAILABILITY
 The fsck.minix command is part of the util-linux package and is available from
--- a/disk-utils/mkfs.cramfs.8
+++ b/disk-utils/mkfs.cramfs.8
@ -81,8 +81,8 @@ operation error, such as unable to allocate memory
 .PD
 .RE
 .SH "SEE ALSO"
-.BR mount (8),
-.BR fsck.cramfs (8)
+.BR fsck.cramfs (8),
+.BR mount (8)
 .SH AVAILABILITY
 The example command is part of the util-linux package and is available from
 .UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
--- a/disk-utils/mkfs.minix.8
+++ b/disk-utils/mkfs.minix.8
@ -81,8 +81,8 @@ Operational error
 .IP 16
 Usage or syntax error
 .SH "SEE ALSO"
-.BR mkfs (8),
 .BR fsck (8),
+.BR mkfs (8),
 .BR reboot (8)
 .SH AVAILABILITY
 The mkfs.minix command is part of the util-linux package and is available from
--- a/disk-utils/swaplabel.8
+++ b/disk-utils/swaplabel.8
@ -65,6 +65,6 @@ enables libblkid debug output.
 The swaplabel command is part of the util-linux package and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
 .SH SEE ALSO
+.BR uuidgen (1),
 .BR mkswap (8),
-.BR swapon (8),
-.BR uuidgen (1)
+.BR swapon (8)
--- a/libuuid/man/uuid_generate.3
+++ b/libuuid/man/uuid_generate.3
@ -114,13 +114,13 @@ Theodore Y.\& Ts'o
 is part of the util-linux package since version 2.15.1 and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
 .SH "SEE ALSO"
-.BR uuid (3),
 .BR uuidgen (1),
-.BR uuidd (8),
+.BR uuid (3),
 .BR uuid_clear (3),
 .BR uuid_compare (3),
 .BR uuid_copy (3),
 .BR uuid_is_null (3),
 .BR uuid_parse (3),
 .BR uuid_time (3),
-.BR uuid_unparse (3)
+.BR uuid_unparse (3),
+.BR uuidd (8)
--- a/login-utils/last.1
+++ b/login-utils/last.1
@ -192,6 +192,6 @@ The last command is part of the util-linux package and is available from
 Linux Kernel Archive
 .UE .
 .SH "SEE ALSO"
-.BR shutdown (8),
 .BR login (1),
-.BR init (8)
+.BR init (8),
+.BR shutdown (8)
--- a/login-utils/login.1
+++ b/login-utils/login.1
@ -285,12 +285,12 @@ the superuser logs in.  The default value is
 .I .hushlogin
 .fi
 .SH "SEE ALSO"
-.BR init (8),
-.BR getty (8),
 .BR mail (1),
 .BR passwd (1),
 .BR passwd (5),
 .BR environ (7),
+.BR getty (8),
+.BR init (8),
 .BR shutdown (8)
 .SH BUGS
 The undocumented BSD
--- a/login-utils/runuser.1
+++ b/login-utils/runuser.1
@ -224,11 +224,11 @@ runuser specific logindef config file
 global logindef config file
 .PD 1
 .SH "SEE ALSO"
-.BR pam (8),
-.BR shells (5),
-.BR login.defs (5),
+.BR setpriv (1),
 .BR su (1),
-.BR setpriv (1)
+.BR login.defs (5),
+.BR shells (5),
+.BR pam (8)
 .SH HISTORY
 This \fB runuser\fR command was
 derived from coreutils' \fBsu\fR, which was based on an implementation by
--- a/login-utils/su.1
+++ b/login-utils/su.1
@ -250,11 +250,11 @@ be configured to update the lastlog file as well. For example by:
 session  required  pam_lastlog.so nowtmp
 .RE
 .SH "SEE ALSO"
-.BR runuser (8),
 .BR setpriv (1),
-.BR pam (8),
+.BR login.defs (5),
 .BR shells (5),
-.BR login.defs (5)
+.BR pam (8),
+.BR runuser (8)
 .SH HISTORY
 This \fBsu\fR command was
 derived from coreutils' \fBsu\fR, which was based on an implementation by
--- a/login-utils/vipw.8
+++ b/login-utils/vipw.8
@ -70,9 +70,9 @@ The editor specified by the string
 will be invoked instead of the default editor
 .BR vi (1).
 .SH SEE ALSO
+.BR vi (1),
 .BR passwd (1),
 .BR flock (2),
-.BR vi (1),
 .BR passwd (5)
 .SH HISTORY
 The
--- a/misc-utils/blkid.8
+++ b/misc-utils/blkid.8
@ -313,8 +313,8 @@ and Karel Zak.
 .SH SEE ALSO
 .BR libblkid (3),
 .BR findfs (8),
-.BR wipefs (8),
 .BR lsblk (8),
+.BR wipefs (8)
 .SH AVAILABILITY
 The blkid command is part of the util-linux package and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
--- a/misc-utils/findmnt.8
+++ b/misc-utils/findmnt.8
@ -284,8 +284,8 @@ use visible padding characters. Requires enabled LIBSMARTCOLS_DEBUG.
 Karel Zak <kzak@redhat.com>
 .fi
 .SH SEE ALSO
-.BR mount (8),
-.BR fstab (5)
+.BR fstab (5),
+.BR mount (8)
 .SH AVAILABILITY
 The findmnt command is part of the util-linux package and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
--- a/misc-utils/getopt.1
+++ b/misc-utils/getopt.1
@ -450,9 +450,9 @@ string).
 Frodo Looijaard
 .ME
 .SH "SEE ALSO"
-.BR getopt (3),
 .BR bash (1),
-.BR tcsh (1).
+.BR tcsh (1),
+.BR getopt (3)
 .SH AVAILABILITY
 The getopt command is part of the util-linux package and is available from
 .UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
--- a/misc-utils/kill.1
+++ b/misc-utils/kill.1
@ -145,8 +145,8 @@ partial success (when more than one process specified)
 .SH SEE ALSO
 .BR bash (1),
 .BR tcsh (1),
-.BR kill (2),
 .BR sigvec (2),
+.BR kill (2),
 .BR signal (7)

 .SH AUTHORS
--- a/misc-utils/logger.1
+++ b/misc-utils/logger.1
@ -341,8 +341,8 @@ For the priority order and intended purposes of these facilities and levels, see
 .br
 .B logger \-n loghost.example.com System rebooted
 .SH SEE ALSO
-.BR syslog (3),
 .BR journalctl (1),
+.BR syslog (3),
 .BR systemd.journal-fields (7)
 .SH STANDARDS
 The
--- a/misc-utils/lsblk.8
+++ b/misc-utils/lsblk.8
@ -164,9 +164,9 @@ enables libsmartcols debug output.
 .IP LIBSMARTCOLS_DEBUG_PADDING=on
 use visible padding characters. Requires enabled LIBSMARTCOLS_DEBUG.
 .SH SEE ALSO
-.BR findmnt (8),
+.BR ls (1),
 .BR blkid (8),
-.BR ls (1)
+.BR findmnt (8)
 .SH AVAILABILITY
 The lsblk command is part of the util-linux package and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
--- a/misc-utils/mcookie.1
+++ b/misc-utils/mcookie.1
@ -56,9 +56,9 @@ It is assumed that none of the randomness sources will block.
 .br
 .I /dev/random
 .SH "SEE ALSO"
+.BR md5sum (1),
 .BR X (1),
 .BR xauth (1),
-.BR md5sum (1),
 .BR rand (3)
 .SH AVAILABILITY
 The mcookie command is part of the util-linux package and is available from
--- a/schedutils/chrt.1
+++ b/schedutils/chrt.1
@ -152,9 +152,9 @@ may be ignored on some systems.
 Linux' default scheduling policy is
 .BR SCHED_OTHER .
 .SH SEE ALSO
-.BR taskset (1),
 .BR nice (1),
 .BR renice (1),
+.BR taskset (1),
 .BR sched (7)
 .sp
 See
--- a/schedutils/taskset.1
+++ b/schedutils/taskset.1
@ -119,8 +119,8 @@ A user can retrieve the affinity mask of any process.
 .BR chrt (1),
 .BR nice (1),
 .BR renice (1),
-.BR sched_setaffinity (2),
-.BR sched_getaffinity (2)
+.BR sched_getaffinity (2),
+.BR sched_setaffinity (2)
 .sp
 See
 .BR sched_setscheduler (2)
--- a/sys-utils/dmesg.1
+++ b/sys-utils/dmesg.1
@ -227,8 +227,8 @@ The text of the message with the warning log priority.
 The text of the message that inform about segmentation fault.

 .SH SEE ALSO
+.BR terminal-colors.d (5),
 .BR syslogd (8)
-.BR terminal-colors.d (5)
 .SH AUTHORS
 .MT kzak@redhat.com
 Karel Zak
--- a/sys-utils/eject.1
+++ b/sys-utils/eject.1
@ -176,8 +176,8 @@ Michal Luscon
 .ME
 - util-linux version.
 .SH SEE ALSO
-.BR lsblk (8),
 .BR findmnt (8),
+.BR lsblk (8),
 .BR mount (8),
 .BR umount (8)
 .SH AVAILABILITY
--- a/sys-utils/fallocate.1
+++ b/sys-utils/fallocate.1
@ -116,9 +116,9 @@ Eric Sandeen
 Karel Zak
 .UE
 .SH SEE ALSO
+.BR truncate (1),
 .BR fallocate (2),
-.BR posix_fallocate (3),
-.BR truncate (1)
+.BR posix_fallocate (3)
 .SH AVAILABILITY
 The fallocate command is part of the util-linux package and is available from
 .UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
--- a/sys-utils/fstab.5
+++ b/sys-utils/fstab.5
@ -231,11 +231,11 @@ libmount based mount utility (since util-linux v2.22).
 .IR /etc/fstab ,
 .I <fstab.h>
 .SH "SEE ALSO"
+.BR getmntent (3),
+.BR fs (5),
 .BR findmnt (8),
 .BR mount (8),
-.BR swapon (8),
-.BR fs (5),
-.BR getmntent (3)
+.BR swapon (8)
 .SH HISTORY
 The ancestor of this
 .B fstab
--- a/sys-utils/fstrim.8
+++ b/sys-utils/fstrim.8
@ -114,8 +114,8 @@ Lukas Czerner <lczerner@redhat.com>
 Karel Zak <kzak@redhat.com>
 .fi
 .SH SEE ALSO
-.BR mount (8),
-.BR blkdiscard (8)
+.BR blkdiscard (8),
+.BR mount (8)
 .SH AVAILABILITY
 The fstrim command is part of the util-linux package and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
--- a/sys-utils/ipcrm.1
+++ b/sys-utils/ipcrm.1
@ -100,8 +100,8 @@ compatibility the previous syntax is still supported.
 .\" Krishna Balasubramanian (balasub@cis.ohio-state.edu)
 .SH SEE ALSO
 .nh
-.BR ipcs (1),
 .BR ipcmk (1),
+.BR ipcs (1),
 .BR msgctl (2),
 .BR msgget (2),
 .BR semctl (2),
--- a/sys-utils/ipcs.1
+++ b/sys-utils/ipcs.1
@ -77,8 +77,8 @@ Print sizes in bytes.
 .B \-\-human
 Print sizes in human-readable format.
 .SH SEE ALSO
-.BR ipcrm (1),
 .BR ipcmk (1),
+.BR ipcrm (1),
 .BR msgrcv (2),
 .BR msgsnd (2),
 .BR semget (2),
--- a/sys-utils/lsipc.1
+++ b/sys-utils/lsipc.1
@ -109,8 +109,8 @@ if incorrect arguments specified,
 2
 if a serious error occurs.
 .SH SEE ALSO
-.BR ipcrm (1),
 .BR ipcmk (1),
+.BR ipcrm (1),
 .BR msgrcv (2),
 .BR msgsnd (2),
 .BR semget (2),
--- a/sys-utils/lsns.8
+++ b/sys-utils/lsns.8
@ -72,8 +72,8 @@ Karel Zak <kzak@redhat.com>
 .fi

 .SH "SEE ALSO"
-.BR unshare (1),
 .BR nsenter (1),
+.BR unshare (1),
 .BR clone (2)

 .SH AVAILABILITY
--- a/sys-utils/mount.8
+++ b/sys-utils/mount.8
@ -3047,17 +3047,17 @@ enables loop device setup debug output
 .BR umount (2),
 .BR umount (8),
 .BR fstab (5),
-.BR findmnt (8),
 .BR nfs (5),
-.BR nfsd (8),
 .BR xfs (5),
-.BR xfs_admin (8),
-.BR mountd (8),
-.BR mke2fs (8),
-.BR tune2fs (8),
 .BR e2label (8),
+.BR findmnt (8),
+.BR losetup (8),
+.BR mke2fs (8),
+.BR mountd (8),
+.BR nfsd (8),
 .BR swapon (8),
-.BR losetup (8)
+.BR tune2fs (8),
+.BR xfs_admin (8)
 .ad
 .SH BUGS
 It is possible for a corrupted filesystem to cause a crash.
--- a/sys-utils/nsenter.1
+++ b/sys-utils/nsenter.1
@ -180,8 +180,8 @@ Display version information and exit.
 \fB\-h\fR, \fB\-\-help\fR
 Display help text and exit.
 .SH SEE ALSO
-.BR setns (2),
-.BR clone (2)
+.BR clone (2),
+.BR setns (2)
 .SH AUTHORS
 .UR biederm@xmission.com
 Eric Biederman
--- a/sys-utils/pivot_root.8
+++ b/sys-utils/pivot_root.8
@ -66,8 +66,8 @@ exec chroot . sh -c 'umount /old_root; exec /sbin/init' \\
 .fi
 .SH "SEE ALSO"
 .BR chroot (1),
-.BR mount (8),
 .BR pivot_root (2),
+.BR mount (8),
 .BR switch_root (8),
 .BR umount (8)
 .SH AVAILABILITY
--- a/sys-utils/prlimit.1
+++ b/sys-utils/prlimit.1
@ -104,8 +104,8 @@ processes to unlimited.
 Set both the soft and hard CPU time limit to ten seconds and run 'sort'.

 .SH "SEE ALSO"
-.BR prlimit (2),
-.BR ulimit (1)
+.BR ulimit (1),
+.BR prlimit (2)

 .SH NOTES
 The prlimit system call is supported since Linux 2.6.36, older kernels will
--- a/sys-utils/setpriv.1
+++ b/sys-utils/setpriv.1
@ -147,8 +147,8 @@ 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 SEE ALSO
-.BR su (1),
 .BR runuser (1),
+.BR su (1),
 .BR prctl (2),
 .BR capabilities (7)
 .SH AUTHOR
--- a/sys-utils/swapon.8
+++ b/sys-utils/swapon.8
@ -230,13 +230,13 @@ enables libmount debug output.
 enables libblkid debug output.

 .SH SEE ALSO
-.BR swapon (2),
 .BR swapoff (2),
+.BR swapon (2),
 .BR fstab (5),
 .BR init (8),
 .BR mkswap (8),
-.BR rc (8),
-.BR mount (8)
+.BR mount (8),
+.BR rc (8)
 .SH FILES
 .br
 .I /dev/sd??
--- a/sys-utils/switch_root.8
+++ b/sys-utils/switch_root.8
@ -46,10 +46,10 @@ mount --bind $DIR $DIR
 .fi

 .SH "SEE ALSO"
-.BR mount (8),
 .BR chroot (2),
 .BR init (8),
-.BR mkinitrd (8)
+.BR mkinitrd (8),
+.BR mount (8)
 .SH AUTHORS
 .nf
 Peter Jones <pjones@redhat.com>
--- a/sys-utils/umount.8
+++ b/sys-utils/umount.8
@ -220,8 +220,8 @@ overrides the default location of the mtab file (ignored for suid)
 enables libmount debug output
 .SH "SEE ALSO"
 .BR umount (2),
-.BR mount (8),
-.BR losetup (8)
+.BR losetup (8),
+.BR mount (8)
 .SH HISTORY
 A
 .B umount
--- a/sys-utils/unshare.1
+++ b/sys-utils/unshare.1
@ -186,8 +186,8 @@ Establish a persistent mount namespace referenced by the bind mount
 makes sure that the bind mount is created on a shared filesystem.

 .SH SEE ALSO
-.BR unshare (2),
 .BR clone (2),
+.BR unshare (2),
 .BR mount (8)
 .SH AUTHORS
 .UR dottedmag@dottedmag.net
--- a/term-utils/mesg.1
+++ b/term-utils/mesg.1
@ -94,10 +94,10 @@ An error has occurred.
 .SH FILES
 .I /dev/[pt]ty[pq]?
 .SH "SEE ALSO"
+.BR login (1),
 .BR talk (1),
 .BR write (1),
 .BR wall (1),
-.BR login (1),
 .BR xterm (1)
 .SH HISTORY
 A
--- a/term-utils/script.1
+++ b/term-utils/script.1
@ -167,7 +167,7 @@ automatically).
 (for the
 .I history
 mechanism),
-.BR scriptreplay (1).
+.BR scriptreplay (1)
 .SH HISTORY
 The
 .B script
--- a/term-utils/setterm.1
+++ b/term-utils/setterm.1
@ -267,10 +267,10 @@ In scripts it is better to use the backward-compatible single hyphen
 rather than the double hyphen.  Currently there are no plans nor good
 reasons to discontinue single-hyphen compatibility.
 .SH "SEE ALSO"
-.BR tput (1),
 .BR stty (1),
-.BR terminfo (5),
-.BR tty (4)
+.BR tput (1),
+.BR tty (4),
+.BR terminfo (5)
 .SH BUGS
 Differences between the Minix and Linux versions are not documented.
 .SH AVAILABILITY
--- a/text-utils/colcrt.1
+++ b/text-utils/colcrt.1
@ -75,10 +75,10 @@ would be:
 .B tbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more
 .RE
 .SH SEE ALSO
-.BR nroff (1),
-.BR troff (1),
 .BR col (1),
 .BR more (1),
+.BR nroff (1),
+.BR troff (1),
 .BR ul (1)
 .SH BUGS
 Should fold underlines onto blanks even with the
--- a/text-utils/more.1
+++ b/text-utils/more.1
@ -217,8 +217,8 @@ The editor of choice when
 .B VISUAL
 is not specified.
 .SH SEE ALSO
-.BR vi (1),
-.BR less (1)
+.BR less (1),
+.BR vi (1)
 .SH AUTHORS
 Eric Shienbrood, UC Berkeley
 .br
--- a/text-utils/tailf.1
+++ b/text-utils/tailf.1
@ -66,8 +66,8 @@ NO WARRANTY for this program.

 The latest inotify-based implementation was written by Karel Zak (kzak@redhat.com).
 .SH "SEE ALSO"
-.BR tail (1),
-.BR less (1)
+.BR less (1),
+.BR tail (1)
 .SH AVAILABILITY
 The tailf command is part of the util-linux package and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.