From dbeb1d733e9eb8b77139250d0f5ec8db2c1f44b7 Mon Sep 17 00:00:00 2001 From: Sami Kerola Date: Sat, 24 Aug 2019 22:34:16 +0100 Subject: [PATCH] docs: try to find broken man references and fix them Unfortunately methods I used to find and fix were based on quite manual process that cannot be easily repeated so I do not see how this fix could be turned into a tools/checkmans.sh addition. Well, lets hope doing this manually twice every decade is good enough. Signed-off-by: Sami Kerola --- disk-utils/fdisk.8 | 2 +- disk-utils/fsck.8 | 2 +- disk-utils/sfdisk.8 | 2 +- misc-utils/fincore.1 | 2 +- misc-utils/mcookie.1 | 2 +- sys-utils/adjtime_config.5 | 2 +- sys-utils/fstab.5 | 2 +- sys-utils/hwclock.8.in | 4 ++-- sys-utils/mount.8 | 2 +- sys-utils/prlimit.1 | 2 +- sys-utils/renice.1 | 2 +- sys-utils/setarch.8 | 4 ++-- sys-utils/swapon.8 | 2 +- term-utils/script.1 | 2 +- term-utils/setterm.1 | 2 +- text-utils/colrm.1 | 2 +- text-utils/line.1 | 2 +- text-utils/pg.1 | 2 +- text-utils/ul.1 | 4 ++-- 19 files changed, 22 insertions(+), 22 deletions(-) diff --git a/disk-utils/fdisk.8 b/disk-utils/fdisk.8 index a674f9ee58..364451711e 100644 --- a/disk-utils/fdisk.8 +++ b/disk-utils/fdisk.8 @@ -94,7 +94,7 @@ specified in the format \fI+list\fP (e.g. \fB-o +UUID\fP). \fB\-s\fR, \fB\-\-getsz\fR Print the size in 512-byte sectors of each given block device. This option is DEPRECATED in favour of -.BR blockdev (1). +.BR blockdev (8). .TP \fB\-t\fR, \fB\-\-type\fR \fItype\fR Enable support only for disklabels of the specified \fItype\fP, and disable diff --git a/disk-utils/fsck.8 b/disk-utils/fsck.8 index a4970e40ca..bbbbc71611 100644 --- a/disk-utils/fsck.8 +++ b/disk-utils/fsck.8 @@ -397,7 +397,7 @@ or .BR fsck.ext3 (8) or .BR e2fsck (8), -.BR cramfsck (8), +.BR fsck.cramfs (8), .BR fsck.jfs (8), .BR fsck.nfs (8), .BR fsck.minix (8), diff --git a/disk-utils/sfdisk.8 b/disk-utils/sfdisk.8 index c7630bb376..0f8a1dfc7b 100644 --- a/disk-utils/sfdisk.8 +++ b/disk-utils/sfdisk.8 @@ -157,7 +157,7 @@ Renumber the partitions, ordering them by their start offset. .BR \-s , " \-\-show\-size " [ \fIdevice ...] List the sizes of all or the specified devices in units of 1024 byte size. This command is DEPRECATED in favour of -.BR blockdev (1). +.BR blockdev (8). .TP .BR \-T , " \-\-list\-types" Print all supported types for the current disk label or the label specified by diff --git a/misc-utils/fincore.1 b/misc-utils/fincore.1 index 97c134bbb3..ce4d37d286 100644 --- a/misc-utils/fincore.1 +++ b/misc-utils/fincore.1 @@ -54,7 +54,7 @@ Masatake YAMATO .SH "SEE ALSO" .BR mincore (2), .BR getpagesize (2), -.BR getconf (1) +.BR getconf (1p) .SH AVAILABILITY The fincore command is part of the util-linux package and is available from .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ diff --git a/misc-utils/mcookie.1 b/misc-utils/mcookie.1 index 1ac50ef139..73be11ab5e 100644 --- a/misc-utils/mcookie.1 +++ b/misc-utils/mcookie.1 @@ -59,7 +59,7 @@ It is assumed that none of the randomness sources will block. .I /dev/random .SH "SEE ALSO" .BR md5sum (1), -.BR X (1), +.BR X (7), .BR xauth (1), .BR rand (3) .SH AVAILABILITY diff --git a/sys-utils/adjtime_config.5 b/sys-utils/adjtime_config.5 index 6f03ca7309..03bf27a6f9 100644 --- a/sys-utils/adjtime_config.5 +++ b/sys-utils/adjtime_config.5 @@ -20,7 +20,7 @@ The Hardware Clock is usually not very accurate. However, much of its inaccurac or loses the same amount of time every day. This is called systematic drift. The util hwclock keeps the file /etc/adjtime, that keeps some historical information. For more details see "\fBThe Adjust Function\fR" and "\fBThe Adjtime File\fR" sections from -.BR hwckock (8) +.BR hwclock (8) man page. .PP diff --git a/sys-utils/fstab.5 b/sys-utils/fstab.5 index a9e9f8c54d..1c0bed7433 100644 --- a/sys-utils/fstab.5 +++ b/sys-utils/fstab.5 @@ -73,7 +73,7 @@ remote filesystem to be mounted. .LP For ordinary mounts, it will hold (a link to) a block special device node (as created by -.BR mknod (8)) +.BR mknod (2)) for the device to be mounted, like `/dev/cdrom' or `/dev/sdb7'. For NFS mounts, this field is :, e.g., `knuth.aeb.nl:/'. For filesystems with no storage, any string can be used, and will show up in diff --git a/sys-utils/hwclock.8.in b/sys-utils/hwclock.8.in index dacdd272f1..6c3a2e6ac8 100644 --- a/sys-utils/hwclock.8.in +++ b/sys-utils/hwclock.8.in @@ -810,7 +810,7 @@ and a precision timepiece, and then calculate the correction manually. .PP After setting the tick and frequency values, continue to test and refine the adjustments until the System Clock keeps good time. See -.BR \%adjtimex (8) +.BR \%adjtimex (2) for more information and the example demonstrating manual drift calculations. .PP @@ -983,7 +983,7 @@ may try for Hardware Clock access: .BR adjtimex (8), .BR gettimeofday (2), .BR settimeofday (2), -.BR crontab (1), +.BR crontab (1p), .BR tzset (3) . .SH AUTHORS diff --git a/sys-utils/mount.8 b/sys-utils/mount.8 index 56d3520be3..0583c225c8 100644 --- a/sys-utils/mount.8 +++ b/sys-utils/mount.8 @@ -2032,7 +2032,7 @@ utility which can be obtained from .TP .B user_xattr Enable Extended User Attributes. See the -.BR attr (5) +.BR attr (1) manual page. .TP .B acl diff --git a/sys-utils/prlimit.1 b/sys-utils/prlimit.1 index 1230b3ad85..86d3e21232 100644 --- a/sys-utils/prlimit.1 +++ b/sys-utils/prlimit.1 @@ -104,7 +104,7 @@ processes to unlimited. Set both the soft and hard CPU time limit to ten seconds and run 'sort'. .SH "SEE ALSO" -.BR ulimit (1), +.BR ulimit (1p), .BR prlimit (2) .SH NOTES diff --git a/sys-utils/renice.1 b/sys-utils/renice.1 index 6b735faf6f..513d984227 100644 --- a/sys-utils/renice.1 +++ b/sys-utils/renice.1 @@ -89,7 +89,7 @@ own. Furthermore, an unprivileged user can only the ``nice value'' (i.e., choose a lower priority) and such changes are irreversible unless (since Linux 2.6.12) the user has a suitable ``nice'' resource limit (see -.BR ulimit (1) +.BR ulimit (1p) and .BR getrlimit (2)). diff --git a/sys-utils/setarch.8 b/sys-utils/setarch.8 index efa3d50881..e59921476e 100644 --- a/sys-utils/setarch.8 +++ b/sys-utils/setarch.8 @@ -95,14 +95,14 @@ manual page. Turns on STICKY_TIMEOUTS. .TP \fB\-X\fR, \fB\-\-read\-implies\-exec\fR If this is set then -.BR mmap (3) +.BR mmap (3p) PROT_READ will also add the PROT_EXEC bit - as expected by legacy x86 binaries. Notice that the ELF loader will automatically set this bit when it encounters a legacy binary. Turns on READ_IMPLIES_EXEC. .TP \fB\-Z\fR, \fB\-\-mmap\-page\-zero\fR SVr4 bug emulation that will set -.BR mmap (3) +.BR mmap (3p) page zero as read-only. Use when .I program depends on this behavior, and the source code is not available to be fixed. diff --git a/sys-utils/swapon.8 b/sys-utils/swapon.8 index d01f681f85..1b82fa5e69 100644 --- a/sys-utils/swapon.8 +++ b/sys-utils/swapon.8 @@ -110,7 +110,7 @@ may also be used to skip non-existing device. .BR \-f , " \-\-fixpgsz" Reinitialize (exec mkswap) the swap space if its page size does not match that of the current running kernel. -.BR mkswap (2) +.BR mkswap (8) initializes the whole device and does not check for bad blocks. .TP .BR \-h , " \-\-help" diff --git a/term-utils/script.1 b/term-utils/script.1 index 0fb4c4fd7c..02ca31373a 100644 --- a/term-utils/script.1 +++ b/term-utils/script.1 @@ -116,7 +116,7 @@ Display help text and exit. The script ends when the forked shell exits (a .I control-D for the Bourne shell -.RB ( sh (1)), +.RB ( sh (1p)), and .IR exit , .I logout diff --git a/term-utils/setterm.1 b/term-utils/setterm.1 index c5eabc967c..1685657b23 100644 --- a/term-utils/setterm.1 +++ b/term-utils/setterm.1 @@ -232,7 +232,7 @@ its power-on state. Reset terminal size by assessing maximum row and column. This is useful when actual geometry and kernel terminal driver are not in sync. Most notable use case is with serial consoles, that do not use -.BR ioctl (3) +.BR ioctl (3p) but just byte streams and breaks. .TP \fB\-\-reverse\fP [\fBon\fP|\fBoff\fP] diff --git a/text-utils/colrm.1 b/text-utils/colrm.1 index 2c50f9ab94..4950f28850 100644 --- a/text-utils/colrm.1 +++ b/text-utils/colrm.1 @@ -60,7 +60,7 @@ Display version information and exit. \fB\-h\fR, \fB\-\-help\fR Display help text and exit. .SH SEE ALSO -.BR awk (1), +.BR awk (1p), .BR column (1), .BR expand (1), .BR paste (1) diff --git a/text-utils/line.1 b/text-utils/line.1 index 08236e2f8a..5620cc0a11 100644 --- a/text-utils/line.1 +++ b/text-utils/line.1 @@ -11,7 +11,7 @@ copies one line (up to a newline) from standard input to standard output. It always prints at least a newline and returns an exit status of 1 on EOF or read error. .SH "SEE ALSO" -.BR read (1) +.BR read (1p) .SH AVAILABILITY The line command is part of the util-linux package and is available from https://www.kernel.org/pub/linux/utils/util-linux/. diff --git a/text-utils/pg.1 b/text-utils/pg.1 index 901ac7d91f..7d2e1317f3 100644 --- a/text-utils/pg.1 +++ b/text-utils/pg.1 @@ -220,7 +220,7 @@ Determines the terminal type. .SH "SEE ALSO" .BR cat (1), .BR more (1), -.BR sh (1), +.BR sh (1p), .BR terminfo (5), .BR locale (7), .BR regex (7), diff --git a/text-utils/ul.1 b/text-utils/ul.1 index 64f7f8d9a0..172844ce11 100644 --- a/text-utils/ul.1 +++ b/text-utils/ul.1 @@ -89,13 +89,13 @@ is set at login time, either by the default terminal type specified in or as set during the login process by the user in their .B login file (see -.BR setenv (1)). +.BR setenv (3)). .SH SEE ALSO .BR colcrt (1), .BR login (1), .BR man (1), .BR nroff (1), -.BR setenv (1), +.BR setenv (3), .BR terminfo (5) .SH BUGS .B nroff -- 2.47.2