ref: 4c9cbe484d8bbade0a44ba1d26044077cae44fee
parent: fcb974af3a3b9747083b618fb6be7a4e70df3201
author: cinap_lenrek <cinap_lenrek@felloff.net>
date: Fri May 11 12:15:08 EDT 2018
fix manpage cross references
--- a/sys/man/1/forp
+++ b/sys/man/1/forp
@@ -141,7 +141,7 @@
.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
--- a/sys/man/2/bio
+++ b/sys/man/2/bio
@@ -153,12 +153,12 @@
.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 @@
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 @@
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 @@
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 @@
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 @@
.B /sys/src/libbio
.SH SEE ALSO
.IR open (2),
+.IR read (2),
.IR print (2),
.IR exits (2),
.IR utf (6),
--- a/sys/man/2/sat
+++ b/sys/man/2/sat
@@ -158,7 +158,9 @@
.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 @@
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)
--- a/sys/man/3/usb
+++ b/sys/man/3/usb
@@ -402,7 +402,7 @@
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
--- a/sys/man/3/vmx
+++ b/sys/man/3/vmx
@@ -105,7 +105,9 @@
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.
--- a/sys/man/4/sshfs
+++ b/sys/man/4/sshfs
@@ -72,7 +72,9 @@
.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
@@ -79,7 +81,7 @@
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 @@
.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.
--- a/sys/man/8/listen
+++ b/sys/man/8/listen
@@ -156,7 +156,9 @@
.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)