fix manpage cross references

7 files changed, 28 insertions, 15 deletions

diff --git a/sys/man/1/forp b/sys/man/1/forp
index 1a43d3074..a0dcd3ab9 100644
--- a/sys/man/1/forp
+++ b/sys/man/1/forp
@@ -141,7 +141,7 @@ Assignment.
 .PP
 One subtle point concerning assignments is that they forcibly override any previous values, i.e. expressions use the value of the latest assignments preceding them.
 Note that the values reported as the counterexample are always the values given by the last assignment.
-.SH "EXAMPLES"
+.SH EXAMPLES
 We know that, mathematically, \fIa\fR + \fIb\fR ≥ \fIa\fR if \fIb\fR ≥ 0 (which is always true for an unsigned number).
 We can ask
 .I forp
diff --git a/sys/man/2/bio b/sys/man/2/bio
index 31a5c8386..b62a5877d 100644
--- a/sys/man/2/bio
+++ b/sys/man/2/bio
@@ -153,12 +153,12 @@ returns the integer file descriptor of the associated open file.
 .PP
 .I Bterm
 flushes the buffer for
-.IR bp
+.I bp
 and returns
 .IR Bflush 's
 return value.
 If the buffer was allocated by
-.IR Bopen
+.I Bopen
 or
 .IR Bfdopen ,
 the buffer is
@@ -270,7 +270,7 @@ outputs the low order 8 bits of
 on
 .IR bp .
 If this causes a
-.IR write
+.I write
 to occur and there is an error,
 a negative value is returned.
 Otherwise, a zero is returned.
@@ -291,7 +291,7 @@ on the output stream.
 is a buffered interface to
 .IR print (2).
 If this causes a
-.IR write
+.I write
 to occur and there is an error,
 a negative value
 .RB ( Beof )
@@ -312,7 +312,7 @@ of data starting at
 to
 .IR bp .
 If this causes a
-.IR write
+.I write
 to occur and there is an error,
 a negative value is returned.
 Otherwise, the number of bytes written is returned.
@@ -349,7 +349,7 @@ is called with a non-nil
 function, then that function is called for I/O in lieu of
 .IR read (2)
 and
-.IR write (2).
+.IR write .
 A nil argument for
 .I iof
 restores normal behaviour.
@@ -357,6 +357,7 @@ restores normal behaviour.
 .B /sys/src/libbio
 .SH SEE ALSO
 .IR open (2),
+.IR read (2),
 .IR print (2),
 .IR exits (2),
 .IR utf (6),
diff --git a/sys/man/2/sat b/sys/man/2/sat
index 0d04f11a9..badbba2a8 100644
--- a/sys/man/2/sat
+++ b/sys/man/2/sat
@@ -158,7 +158,9 @@ to generate random numbers between 0 and
 .if t 2\u\s731\s10\d-1;
 .if n 2^31-1;
 it defaults to
-.IR lrand (2).
+.I lrand
+(see
+.IR rand (2)).
 .I Errfun
 is called on fatal errors (see DIAGNOSTICS).
 Additionally, a number of finetuning parameters are defined in
@@ -199,7 +201,9 @@ with an error string and
 If no
 .I errfun
 is provided or if it returns,
-.IR sysfatal (2)
+.I sysfatal
+(see
+.IR perror (2))
 is called.
 It is permissible to use
 .IR setjmp (2)
diff --git a/sys/man/3/usb b/sys/man/3/usb
index ba476c002..de66fa46b 100644
--- a/sys/man/3/usb
+++ b/sys/man/3/usb
@@ -402,7 +402,7 @@ by the descriptor.
 If
 .I n
 is set to 1 for an isochronous endpoint,
-.IR read(2)
+.IR read (2)
 from the data file will not cross μframe boundaries.
 .TP
 .B clrhalt
diff --git a/sys/man/3/vmx b/sys/man/3/vmx
index ec5b5497f..471febb17 100644
--- a/sys/man/3/vmx
+++ b/sys/man/3/vmx
@@ -105,7 +105,9 @@ Reading the
 file will stall the reading process until the virtual CPU reaches a point where it cannot continue (a "VM exit").
 This may be due to the an access to hardware or a software exception.
 Each exit is indicated by a single line in a format compatible with
-.IR tokenize (2).
+.I tokenize
+(see
+.IR getfields (2)).
 The first column contains the cause of the exit and the second column contains the "exit qualification" field that may contain more details on the exit (see Intel SDM).
 The remaining columns come in pairs and contain further info and the values of relevant registers.
 
diff --git a/sys/man/4/sshfs b/sys/man/4/sshfs
index 83d484e4f..d86d74fef 100644
--- a/sys/man/4/sshfs
+++ b/sys/man/4/sshfs
@@ -72,14 +72,16 @@ if
 .B -m
 is not specified.
 The default mount options are equivalent to calling
-.IR mount (1)
+.I mount
+(see
+.IR bind (1))
 with
 .BR -c .
 .B -a
 and
 .B -b
 have the same function as they do with
-.IR mount (1).
+.IR mount .
 The default remote root is the user's home directory but can be changed with
 .BR -r .
 .PP
@@ -130,7 +132,9 @@ Version 4 and later also handle uid/gid translation at the server end which woul
 .PP
 Some 9P operations that should be atomic are not atomic because they do not map 1:1 to SFTP operations.
 In particular there is no guarantee that a failed
-.IR wstat (5)
+.I wstat
+(see
+.IR stat (5))
 did not change some of the fields.
 .PP
 The code is naive about links and assumes files with distinct names to be distinct, assigning them different QIDs.
diff --git a/sys/man/8/listen b/sys/man/8/listen
index 617aac870..272733bb4 100644
--- a/sys/man/8/listen
+++ b/sys/man/8/listen
@@ -156,7 +156,9 @@ using TLS for encryption.
 .TP
 .B tcp17020
 TLS encrypted 9P fileserver (t9fs) for
-.IR srvtls (4)
+.I srvtls
+(see
+.IR srv (4)).
 .TP
 .B tcp7
 echo any bytes received (bit mirror)