[9front] small patches

[9front] small patches

[Stuart Morrow]

libdraw: topbottom(): rm double-check of n
rio(4): document 'resize ±n' commands
	someone that knows how is going to have to tidy up my troff.
	I don't know how to avoid these g a p s.
man: make -P work in acme
page: cmdmenu: perfectly balanced, as all things should be

--- //.git/fs/object/e8259861da3a55c03491904e4d11c5c15b7577c5/tree/sys/src/libdraw/window.c
+++ sys/src/libdraw/window.c
@@ -150,8 +150,6 @@
 			return;
 		}

-	if(n==0)
-		return;
 	b = bufimage(d, 1+1+2+4*n);
 	if(b == nil)
 		return;

--- //.git/fs/object/e8259861da3a55c03491904e4d11c5c15b7577c5/tree/sys/man/4/rio
+++ sys/man/4/rio
@@ -225,7 +225,7 @@
 .B wctl
 accepts messages to change the size or placement of the associated window,
 and to create new windows.
-The messages are in a command-line like format, with a command name,
+The messages are in a command-line-like format, with a command name,
 possibly followed by options introduced by a minus sign.
 The options must be separated by blanks, for example
 .B -dx 100
@@ -275,14 +275,17 @@
 and
 .B new
 commands accept
-.B -minx
+.B -minx [±]
 .IR n ,
 .B -miny
+[±]
 .IR n ,
 .B -maxx
+[±]
 .IR n ,
 and
 .BR -maxy
+[±]
 .I n
 options to set the position of the corresponding edge of the window.
 They also accept an option

--- //.git/fs/object/e8259861da3a55c03491904e4d11c5c15b7577c5/tree/rc/bin/man
+++ rc/bin/man
@@ -50,7 +50,11 @@

 fn page {
 	if(test -d /mnt/wsys/acme)
-		/bin/page -w
+		@{
+			rfork n
+			unmount /mnt/acme /dev
+			/bin/page -w
+		}
 	if not
 		/bin/page
 }


--- //.git/fs/object/e8259861da3a55c03491904e4d11c5c15b7577c5/tree/sys/src/cmd/page.c
+++ sys/src/cmd/page.c
@@ -114,7 +114,7 @@
 Menu cmdmenu = {
 	nil,
 	cmdmenugen,
-	-1,
+	7,
 };

 Cursor reading = {

[9front] Re: small patches

[Stuart Morrow]

Better rio(4) diff than before.

"Stable device unique name" sounds like a violation of that rule about
the order in adjectives in English, although "device unique name"
appears elsewhere and so may be a technical term not to be rearranged.

Or perhaps I'm looking at a missing hyphen (stable device-unique name)
rather than wrong order. The order the words are already in would be
correct in this case.

inb4 device isn't an adjective

--- /mnt/git/object/be36c092ac061a04065720e98e5849130487be7f/tree/sys/man/4/rio
+++ sys/man/4/rio
@@ -225,7 +225,7 @@
 .B wctl
 accepts messages to change the size or placement of the associated window,
 and to create new windows.
-The messages are in a command-line like format, with a command name,
+The messages are in a command-line-like format, with a command name,
 possibly followed by options introduced by a minus sign.
 The options must be separated by blanks, for example
 .B -dx 100
@@ -276,14 +276,14 @@
 .B new
 commands accept
 .B -minx
-.IR n ,
+.RI [±] n ,
 .B -miny
-.IR n ,
+.RI [±] n ,
 .B -maxx
-.IR n ,
+.RI [±] n ,
 and
-.BR -maxy
-.I n
+.B -maxy
+.RI [±] n
 options to set the position of the corresponding edge of the window.
 They also accept an option
 .B -r
--- /mnt/git/object/be36c092ac061a04065720e98e5849130487be7f/tree/sys/man/4/nusb
+++ sys/man/4/nusb
@@ -88,7 +88,7 @@
 .B usbevent
 (usually seen as
 .BR /dev/usbevent )
-which, when read, returns a 6 column, space separated line of
+which, when read, returns a 6-column, space-separated line of
 text, one for each event. The columns are:
 .B attach
 or
@@ -99,7 +99,7 @@
 .I did
 .I csp
 and
-.I hname .
+.IR hname .
 The
 .I addr
 is the decimal device address assigned.
@@ -113,7 +113,7 @@
 .I Usbd
 assigns a stable device unique name based on the
 device descriptor for
-.I hname .
+.IR hname .
 This information is read by
 .IR nusbrc (8)
 and the
@@ -160,7 +160,7 @@
 .SS Ethernet
 .I Ether
 handles USB ethernet devices. The file system provided is
-compatible to
+compatible with
 .IR ether (3)
 and added to the share
 .B usbnet
@@ -234,7 +234,7 @@
 configures and manages a USB audio device.
 It implements a file system, (normally seen under
 .BI /dev )
-compatible to
+compatible with
 .IR audio (3).
 .SH SOURCE
 .B /sys/src/cmd/nusb

Re: [9front] Re: small patches

[Kurt H Maier]

On Mon, Jul 19, 2021 at 12:00:36AM +0100, Stuart Morrow wrote:
> 
> "Stable device unique name" sounds like a violation of that rule about
> the order in adjectives in English, although "device unique name"
> appears elsewhere and so may be a technical term not to be rearranged.

That rule is prescriptivist nonsense and it's only brought up to
gatekeep ESL speakers.  I propose it be ignored entirely, and I propose
it with the entirety of my heart-shaped red American solitary heart.

khm

Re: [9front] Re: small patches

[Stuart Morrow]

> That rule is prescriptivist nonsense and it's only brought up to
> gatekeep ESL speakers.

Press X to doubt.

Re: [9front] Re: small patches

[Amavect]

"stable, device-unique name" parses best to me.
If you need a rule: multiple adjectives get commas, compound adjectives get hyphens.

Thanks,
Amavect

Re: [9front] Re: small patches

[ori]

Quoth Amavect <amavect@gmail.com>:
> "stable, device-unique name" parses best to me.
> If you need a rule: multiple adjectives get commas, compound adjectives get hyphens.
> 
> Thanks,
> Amavect
> 

I'd change it entirely: 'device identifier'.

[9front] Re: small patches

[Stuart Morrow]

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

[9front] Re: small patches

[Stuart Morrow]

page a b a b a b a b  # blink comparator