[9front] Re: small patches

[Stuart Morrow <morrow.stuart@gmail.com>]

More de-plenking

--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree//sys/man/1/vac
+++ /sys/man/1/vac
@@ -82,7 +82,7 @@
 .I yyyy/mmdd
 (year, month, day)
 in the style of the dump file system
-(see Plan 9's \fIfs\fR(4)).
+(see \fIfs\fR(4)).
 If
 .I vacfile
 already exists, an additional backup day is added to the
@@ -184,7 +184,7 @@
 .I pattern
 or
 .B exclude
-.I pattern .
+.IR pattern .
 When considering whether to include a directory or file
 in the vac archive,
 the earliest matching pattern in the file
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree//sys/man/2/9p
+++ /sys/man/2/9p
@@ -511,7 +511,7 @@
 will handle the request given pointers to two functions
 .I walk1
 and (optionally)
-.I clone .
+.IR clone .
 .IR Clone ,
 if non-nil, is called to signal the creation of
 .I newfid
@@ -881,7 +881,7 @@
 .IR nntpfs (4),
 .IR snap (4),
 and
-.B /sys/src/lib9p/ramfs.c
+.B /sys/src/cmd/ramfs.c
 are good examples of simple single-threaded file servers.
 .PP
 In general, the
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree//sys/man/2/ioproc
+++ /sys/man/2/ioproc
@@ -92,7 +92,7 @@
 .PP
 .I Closeioproc
 terminates the I/O proc and frees the associated
-.B Ioproc .
+.BR Ioproc .
 .PP
 .I Iocall
 is a primitive that may be used to implement
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree//sys/man/2/ip
+++ /sys/man/2/ip
@@ -97,7 +97,7 @@
 .SH DESCRIPTION
 These routines are used by Internet Protocol (IP) programs to
 manipulate IP and Ethernet addresses.
-Plan 9, by default, uses V6 format IP addresses.  Since V4
+Plan 9, by default, uses V6-format IP addresses.  Since V4
 addresses fit into the V6 space, all IP addresses can be represented.
 IP addresses are stored as a string of 16
 .B unsigned
@@ -222,7 +222,7 @@
 .PP
 .I Defmask
 returns the standard class A, B, or C mask for
-.I ipaddr .
+.IR ipaddr .
 .PP
 .I Isv4
 returns non-zero if the V6 address is in the V4 space, that is,
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree//sys/man/4/cdfs
+++ /sys/man/4/cdfs
@@ -203,7 +203,7 @@
 option will print rc commands using
 .IR audio/flacenc (1)
 to encode and tag audio tracks from the disc to output directory
-.I dir .
+.IR dir .
 .SH EXAMPLES
 Backup to a BD-R disc:
 .br
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree//sys/man/6/authsrv
+++ /sys/man/6/authsrv
@@ -283,7 +283,7 @@
 proving to the client that it also knows
 .I Kn
 and therefore
-.I Ks .
+.IR Ks .
 .PP
 The 64-bit shared secret
 .I Kn
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree//sys/man/8/ndb
+++ /sys/man/8/ndb
@@ -764,7 +764,7 @@
 .PP
 .I Ndb/dnsgetip
 resolves and prints A and AAAA records without consulting
-.I ndb/dns .
+.IR ndb/dns .
 By default,
 .I ndb/dnsgetip
 queries A records first and then AAAA records. As with
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree//sys/man/8/venti-backup
+++ /sys/man/8/venti-backup
@@ -66,7 +66,7 @@
 (default
 .BR 0 )
 in
-.I arenafile .
+.IR arenafile .
 This is useful for reading directly from
 the Venti arena partition:
 .IP
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree/sys/man/1/deroff
+++ sys/man/1/deroff
@@ -83,11 +83,11 @@
 .IR spell (1)
 .SH BUGS
 This filter is not a complete interpreter of
-.I troff .
+.IR troff .
 For example, macro definitions containing
 .L \e$
 cause chaos in
-.IR deroff
+.I deroff
 when the popular
 .L $$
 delimiters for
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree/sys/man/1/leak
+++ sys/man/1/leak
@@ -158,7 +158,7 @@
 .I Umem
 prints summarizes all allocations, not just
 memory leaks, but it is faster and requires less memory than
-.I leak .
+.IR leak .
 .PP
 .I Kmem
 is like
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree/sys/man/1/uhtml
+++ sys/man/1/uhtml
@@ -1,6 +1,6 @@
 .TH UHTML 1
 .SH NAME
-uhtml \- convert foreign character set HTML file to unicode
+uhtml \- convert foreign-character-set HTML file to Unicode
 .SH SYNOPSIS
 .B uhtml
 [
@@ -12,24 +12,24 @@
 .I file
 ]
 .SH DESCRIPTION
-HTML comes in various character set encodings
+HTML comes in various character-set encodings
 and has special forms to encode characters. To
-make it easier to process html, uhtml is used
-to normalize it to a unicode only form.
+make it easier to process HTML, uhtml is used
+to normalize it to a Unicode-only form.
 .LP
-Uhtml detects the character set of the html input
+Uhtml detects the character set of the HTML input
 .I file
 and calls
 .IR tcs (1)
-to convert it to utf replacing html-entity forms
-by ther unicode character representations except for
-.B lt
-.B gt
-.B amp
-.B quot
+to convert it to UTF replacing HTML-entity forms
+by their Unicode character representations except for
+.BR lt ,
+.BR gt ,
+.BR amp ,
+.BR quot ,
 and
-.B apos .
-The converted html is written to
+.BR apos .
+The converted HTML is written to
 standard output. If no
 .I file
 was given, it is read from standard input. If the
@@ -36,7 +36,7 @@
 .B -p
 option is given, the detected character set is printed and
 the program exits without conversion.
-In case character set detection fails, the default (utf)
+In case character-set detection fails, the default (UTF)
 is assumed. This default can be changed with the
 .B -c
 option.
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree/sys/man/2/pushtls
+++ sys/man/2/pushtls
@@ -78,10 +78,10 @@
 descriptor will get encrypted and authenticated and then written to the
 file descriptor,
 .IR fd .
-.I Pushtls ,
-.IR tlsClient
+.IR Pushtls ,
+.I tlsClient
 and
-.IR tlsServer
+.I tlsServer
 close the original file descriptor on success.
 If
 .I dir
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree/sys/man/2/venti-cache
+++ sys/man/2/venti-cache
@@ -126,7 +126,7 @@
 with room for
 .I nblocks
 of maximum block size
-.I blocksize .
+.IR blocksize .
 .PP
 .I Vtcachefree
 frees a cache and all the associated blocks.
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree/sys/man/2/venti-log
+++ sys/man/2/venti-log
@@ -54,7 +54,7 @@
 .PP
 .I Vtlogopen
 returns a reference to the log with the given
-.I name .
+.IR name .
 If a log with that name does not exist and
 .I size
 is non-zero,
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree/sys/man/3/cmd
+++ sys/man/3/cmd
@@ -61,7 +61,7 @@
 Run the host command in directory
 .IR wdir ,
 which is a directory
-.I "on the host system" .
+.IR "on the host system" .
 Issue this request before starting the command.
 By default, commands are run in the Inferno root directory on the host system.
 .TP
@@ -207,10 +207,10 @@
 .SS "Command execution"
 In all cases, the command runs in the host operating system's
 own file name space.
-All file names will be interpreted in that space, not Plan9's.
+All file names will be interpreted in that space, not Plan 9's.
 For example, on Unix
 .B /
-refers to the host's file system root, not Plan9's;
+refers to the host's file system root, not Plan 9's;
 the effects of mounts and binds will not be visible.
 .SH "SEE ALSO"
 .IR os (1)
--- //.git/fs/object/be36c092ac061a04065720e98e5849130487be7f/tree/sys/man/3/usb
+++ sys/man/3/usb
@@ -19,7 +19,7 @@
 .SH DESCRIPTION
 The Universal Serial Bus is a complex yet popular bus
 for connecting all kind of devices to a computer.
-It is a four-wire tree-shaped bus that provides both communication
and (limited)
+It is a tree-shaped bus that provides both communication and (limited)
 power to devices.
 Branching points in the tree are provided by devices called
 .IR hubs .
@@ -41,7 +41,6 @@
 EHCI for USB 2 (up to 480 Mb/s)
 and
 XHCI for USB 3 (up to 5 Gb/s).
-We currently support all but XHCI, which is still quite new.
 .PP
 The USB bus is fully controlled by the host; all devices are polled.
 Hubs are passive in the sense that they do not poll the devices attached
@@ -57,7 +56,7 @@
 Specialization continues as subclasses and subsubclasses are explored.
 .PP
 Enumeration of the bus and initial configuration of devices is done
-by a user level program,
+by a user-level program,
 .IR usbd .
 Device drivers are implemented by separate user programs, although
 some of them may be statically linked into
@@ -179,7 +178,7 @@
 to resume I/O.
 The most common error is
 .L crc/timeout
-indicating problems in communication with the device (eg., a physical
+indicating problems in communication with the device (e.g., a physical
 detach of the device or a wiring problem).
 .PP
 For control and isochronous transfers, there is an implicit
@@ -267,9 +266,11 @@
 (1.5 Mb/s),
 .BR full
 (12 Mb/s),
-or
 .BR high
-(480 Mb/s).
+(480 Mb/s)
+or
+.BR super
+(5 Gb/s).
 .TP
 Maximum packet size
 Used when performing I/O on the data file.
@@ -426,7 +427,7 @@
 .TP
 .BI name " str"
 Generates an additional file name,
-.I str ,
+.IR str ,
 for the
 .B data
 file of the endpoint.
@@ -484,16 +485,16 @@
 .BR rw ,
 which creates, respectively, an input, output, or input/output endpoint.
 .TP
-.B "speed {low|full|high}
-Set the endpoint speed to full, low, or high, respectively.
+.B "speed {low|full|high|super}
+Set the endpoint speed to full, low, high, or SuperSpeed, respectively.
 .TP
 .B hub
 Tell this driver that the endpoint corresponds to a hub device.
 .PD
 .PP
-Setup endpoints for hub devices also accept his request:
+Setup endpoints for hub devices also accept
 .TP
-.B "newdev {low|full|high} \fIport\fP
+.B "newdev {low|full|high|super} \fIport\fP
 Create a new setup endpoint to represent a new device.
 The first argument is the device speed.
 .I Port