ref: 36d2092a3330692c43f33ef4e05edc997c05ecad
parent: af42c4f4816c84772533ee7f47ffaafd33abeb22
author: cinap_lenrek <cinap_lenrek@felloff.net>
date: Tue Jan 12 03:43:36 EST 2016
fix manpage references
--- a/sys/lib/man/checkman.awk
+++ b/sys/lib/man/checkman.awk
@@ -84,9 +84,8 @@
name = substr(FILENAME, seclen+2, n-seclen-1)
if($1 != ".TH" || NF != 3)
print "First line of", FILENAME, "not a proper .TH"
- else if($2 != toupper(name) || substr($3, 1, seclen) != section){- if($2!="INTRO" || name!="0intro")
- print ".TH of", FILENAME, "doesn't match filename"
+ else if(($2!="INTRO" || name!="0intro") && ($2 != toupper(name) || substr($3, 1, seclen) != section)){+ print ".TH of", FILENAME, "doesn't match filename"
}else
Pages[section "/" $2] = 1
}
@@ -177,7 +176,7 @@
for (i in Refs) { if (!(i in Pages)){split(tolower(i), a, "/")
- print "grep -n " a[2] ".*" a[1] " ?/* # Need " tolower(i)
+ print "grep -in '" a[2] "[ ]*\\(" a[1] "' ?/* # Need " tolower(i)}
}
print ""
--- a/sys/man/1/2c
+++ b/sys/man/1/2c
@@ -185,8 +185,6 @@
The signature is based on the C
.B signof
operator.
-See
-.IR dynld (2).
.TP
.B -V
By default, the compilers are non-standardly lax about type equality between
--- a/sys/man/1/2l
+++ b/sys/man/1/2l
@@ -133,8 +133,6 @@
The optional
.I file
restricts the exported symbols to those listed in the file.
-See
-.IR dynld (2).
.TP
.BI -u " [ file ]"
Produce an export table, import table
@@ -142,8 +140,6 @@
The optional
.I file
restricts the imported symbols to those listed in the file.
-See
-.IR dynld (2).
.TP
.B -t
(\c
--- a/sys/man/1/5e
+++ b/sys/man/1/5e
@@ -22,8 +22,8 @@
.IR exec (2),
which allows for the execution of threaded programs (e.g.,
.IR rio (1)
-or
-.IR catclock (1)).
+or catclock (see
+.IR games (1)).
.PP
.I 5e
executes the specified binary
@@ -113,8 +113,8 @@
Obscure opcodes, in particular uncommon operations on R15, are not implemented.
Accesses spanning segment boundaries will be treated as page faults.
-Many syscalls such as
-.IR pread (2)
+Many syscalls such as pread (see
+.IR read (2))
will shuffle data around (in most cases unnecessarily) if invoked on potentially shared segments of variable length, in particular the bss segment.
FPA emulation leaves much to be desired, rounding modes are ignored, all calculations are performed at extended precision.
--- a/sys/man/1/rc
+++ b/sys/man/1/rc
@@ -971,8 +971,6 @@
Print debugging information (internal form of commands
as they are executed).
.PD
-.SH SOURCE
-.B /sys/src/cmd/rc
.SH FILES
.TF $home/lib/profile
.TP
@@ -986,6 +984,8 @@
.TP
.B /rc/lib/rcmain.local
Site specific system rc start script
+.SH SOURCE
+.B /sys/src/cmd/rc
.SH "SEE ALSO"
Tom Duff,
``Rc \- The Plan 9 Shell''.
--- a/sys/man/1/spred
+++ b/sys/man/1/spred
@@ -7,7 +7,7 @@
.I Spred
is an editor for small images using a limited palette.
It uses a window system mimicking
-.IR samterm (1).
+.IR sam (1).
There is a command window which uses a command language described below.
There is also an arbitrary number of palette and sprite windows.
Each open sprite file has an associated palette file.
--- a/sys/man/1/ssam
+++ b/sys/man/1/ssam
@@ -64,7 +64,7 @@
.SH SEE ALSO
.IR sed (1),
.IR sam (1),
-.IR regexp (7)
+.IR regexp (6)
.PP
Rob Pike,
``The text editor sam''.
--- a/sys/man/2/nusb
+++ b/sys/man/2/nusb
@@ -135,7 +135,7 @@
Usb drivers rely on
.IR usb (3)
to perform I/O through USB as well as on
-.IR usbd
+.I usbd
to perform the initial configuration for the device's setup endpoint.
The rest of the work is up to the driver and is where this library may help.
.PP
@@ -152,7 +152,7 @@
.B Devs
adjust the number of references to one, initially.
The driver is free to call
-.IR incref
+.I incref
(in
.IR lock (2))
to add references and
--- a/sys/man/3/flash
+++ b/sys/man/3/flash
@@ -20,12 +20,6 @@
For both types of flash,
the driver gives a read/write/erase interface to the raw flash device,
which can impose constraints on operations beyond those imposed by the driver.
-Other drivers such as
-.IR ftl (3)
-or
-.IR logfs (3)
-implement any higher-level format required,
-including ECC for NAND flash, for instance.
.PP
The top level directory contains a single directory named
.B flash
@@ -157,9 +151,7 @@
.IR atof (2));
the default base is 10.
.SH SOURCE
-.B /sys/src/*/devflash.c
-.br
-.B /sys/src/*/flash*.c
+.B /sys/src/9/*/devflash.c
.SH SEE ALSO
.IR flashfs (4),
.IR paqfs (4)
--- a/sys/man/3/usb
+++ b/sys/man/3/usb
@@ -115,7 +115,7 @@
as dictated by the device to perform actual I/O.
.SS Operation
Bus enumeration and device configuration is performed by
-.IR usbd
+.I usbd
and not by this driver.
The driver provides an interface
to access existing endpoints (initially those for the built-in root hubs),
@@ -212,7 +212,7 @@
.LP
The first line contains status information.
The rest is information supplied by
-.IR usbd
+.I usbd
as an aid to locate devices.
The status information includes:
.TF "\fREndpoint mode
@@ -346,7 +346,7 @@
Endpoint control files accept the following requests.
In most cases
the driver does not issue them, leaving the task to either
-.IR usbd
+.I usbd
or the usb driver library documented in
.IR nusb (2).
.TF "\fLsamplehz\fI n
@@ -408,7 +408,7 @@
.B ctl
with
.IR string .
-.IR Usbd (4)
+.I Usbd
uses this to add device descriptions.
.TP
.B address
--- a/sys/man/4/execnet
+++ b/sys/man/4/execnet
@@ -30,8 +30,7 @@
.IR cmd .
.SH EXAMPLE
.I Execnet
-can be used to connect to instances of
-.IR u9fs (4)
+can be used to connect to instances of u9fs
running on other hosts:
.EX
g% execnet
@@ -52,15 +51,11 @@
u9fs -na none -u $USER -l $HOME/tmp/u9fs.log
ny%
.EE
-See the
-.IR u9fs (4)
-man page for more information.
.SH SOURCE
.B /sys/src/cmd/execnet
.SH "SEE ALSO
.IR dial (2),
.IR ip (3),
-.IR u9fs (4)
.SH BUGS
Almost certainly:
.IR execnet
--- a/sys/man/4/srv
+++ b/sys/man/4/srv
@@ -162,7 +162,7 @@
connects to a remote Unix system via
.IR ssh (1)
and starts
-.IR u9fs (4).
+.BR u9fs .
The
.B -u
option specifies the path to the
@@ -191,7 +191,7 @@
.EE
.PP
To connect to an instance of the Unix server
-.IR u9fs (4)
+.I u9fs
started via
.IR ssh (1):
.IP
@@ -220,7 +220,6 @@
.IR exportfs (4),
.IR import (4),
.IR ftpfs (4),
-.IR u9fs (4)
.SH BUGS
.I Srv
does not explicitly report failures of
--- a/sys/man/5/remove
+++ b/sys/man/5/remove
@@ -40,7 +40,7 @@
remove the file immediately: attempts to use the other fids
will yield a
``phase error.''
-.IR U9fs (4)
+.I U9fs
follows the semantics of the underlying Unix file system,
so other fids typically remain usable.
.SH ENTRY POINTS
--- a/sys/man/6/venti
+++ b/sys/man/6/venti
@@ -42,9 +42,7 @@
.IR vac (1)
uses a
.B vac:
-prefix, while
-.IR vbackup (8)
-uses prefixes corresponding to the file system
+prefix, while vbackup uses prefixes corresponding to the file system
types:
.BR ext2: ,
.BR ffs: ,
--- a/sys/man/8/auth
+++ b/sys/man/8/auth
@@ -260,7 +260,7 @@
.L #¤/caphash
still exists.
.SH FILES
-.TF /sys/lib/httppasswords
+.TF /adm/netkeys.who
.TP
.B /lib/ndb/auth
Speaksfor relationships and mappings for
@@ -271,9 +271,6 @@
.TP
.B /adm/netkeys.who
List of users in the SecureNet database.
-.TP
-.B /sys/lib/httppasswords
-List of realms and passwords for HTTP access.
.SH SOURCE
.B /sys/src/cmd/auth
.SH "SEE ALSO"
--- a/sys/man/8/mkflashfs
+++ b/sys/man/8/mkflashfs
@@ -32,7 +32,7 @@
.I nsect
sectors.
.SH SOURCE
-.B /sys/src/cmd/aux/flashfs/mkflashfs.c
+.B /sys/src/cmd/aux/flashfs/mkfs.c
.SH "SEE ALSO"
.IR flashfs (4),
.IR paqfs (4),
--- a/sys/man/8/prep
+++ b/sys/man/8/prep
@@ -158,9 +158,7 @@
worm filesystem.
.TP
.B fs
-A
-.IR kfs (4)
-file system.
+A kfs file system.
.TP
.B fscfg
A one-sector partition used to store an
--- a/sys/man/8/rc-httpd
+++ b/sys/man/8/rc-httpd
@@ -138,8 +138,7 @@
.I Rc-httpd
is run from a file in the directory scanned by
.IR listen (8),
-or called as an argument to
-.IR listen1 (8).
+or called as an argument to aux/listen1.
The program's standard error may be captured to a log file:
.RS
.EX
--- a/sys/man/8/wpa
+++ b/sys/man/8/wpa
@@ -28,11 +28,10 @@
The
.B -p
option will prompt and install the preshared key or
-pap/chap credentials into
-.IR factotum (4),
-otherwise the key has to be already present in
-factotum or an interactive key prompter like
-.IR fgui (4)
+pap/chap credentials into factotum, otherwise the key has to be
+already present in factotum or an interactive key prompter like
+auth/fgui (see
+.IR factotum (4))
needs to provide it.
.PP
The authentication protocol is initiated by the