* [9front] small patches
@ 2021-07-13 17:41 Stuart Morrow
2021-07-18 23:00 ` [9front] " Stuart Morrow
0 siblings, 1 reply; 8+ messages in thread
From: Stuart Morrow @ 2021-07-13 17:41 UTC (permalink / raw)
To: 9front
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 = {
^ permalink raw reply [flat|nested] 8+ messages in thread
* [9front] Re: small patches
2021-07-13 17:41 [9front] small patches Stuart Morrow
@ 2021-07-18 23:00 ` Stuart Morrow
2021-07-19 8:50 ` Kurt H Maier
` (2 more replies)
0 siblings, 3 replies; 8+ messages in thread
From: Stuart Morrow @ 2021-07-18 23:00 UTC (permalink / raw)
To: 9front
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
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [9front] Re: small patches
2021-07-18 23:00 ` [9front] " Stuart Morrow
@ 2021-07-19 8:50 ` Kurt H Maier
2021-07-19 12:06 ` Stuart Morrow
2021-07-19 19:40 ` Amavect
2021-07-21 21:19 ` Stuart Morrow
2 siblings, 1 reply; 8+ messages in thread
From: Kurt H Maier @ 2021-07-19 8:50 UTC (permalink / raw)
To: 9front
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
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [9front] Re: small patches
2021-07-19 8:50 ` Kurt H Maier
@ 2021-07-19 12:06 ` Stuart Morrow
0 siblings, 0 replies; 8+ messages in thread
From: Stuart Morrow @ 2021-07-19 12:06 UTC (permalink / raw)
To: 9front
> That rule is prescriptivist nonsense and it's only brought up to
> gatekeep ESL speakers.
Press X to doubt.
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [9front] Re: small patches
2021-07-18 23:00 ` [9front] " Stuart Morrow
2021-07-19 8:50 ` Kurt H Maier
@ 2021-07-19 19:40 ` Amavect
2021-07-19 19:52 ` ori
2021-07-21 21:19 ` Stuart Morrow
2 siblings, 1 reply; 8+ messages in thread
From: Amavect @ 2021-07-19 19:40 UTC (permalink / raw)
To: 9front
"stable, device-unique name" parses best to me.
If you need a rule: multiple adjectives get commas, compound adjectives get hyphens.
Thanks,
Amavect
^ permalink raw reply [flat|nested] 8+ messages in thread
* Re: [9front] Re: small patches
2021-07-19 19:40 ` Amavect
@ 2021-07-19 19:52 ` ori
0 siblings, 0 replies; 8+ messages in thread
From: ori @ 2021-07-19 19:52 UTC (permalink / raw)
To: 9front
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'.
^ permalink raw reply [flat|nested] 8+ messages in thread
* [9front] Re: small patches
2021-07-18 23:00 ` [9front] " Stuart Morrow
2021-07-19 8:50 ` Kurt H Maier
2021-07-19 19:40 ` Amavect
@ 2021-07-21 21:19 ` Stuart Morrow
2021-07-21 21:20 ` Stuart Morrow
2 siblings, 1 reply; 8+ messages in thread
From: Stuart Morrow @ 2021-07-21 21:19 UTC (permalink / raw)
To: 9front
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
^ permalink raw reply [flat|nested] 8+ messages in thread
* [9front] Re: small patches
2021-07-21 21:19 ` Stuart Morrow
@ 2021-07-21 21:20 ` Stuart Morrow
0 siblings, 0 replies; 8+ messages in thread
From: Stuart Morrow @ 2021-07-21 21:20 UTC (permalink / raw)
To: 9front
page a b a b a b a b # blink comparator
^ permalink raw reply [flat|nested] 8+ messages in thread
end of thread, other threads:[~2021-07-21 22:37 UTC | newest]
Thread overview: 8+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-07-13 17:41 [9front] small patches Stuart Morrow
2021-07-18 23:00 ` [9front] " Stuart Morrow
2021-07-19 8:50 ` Kurt H Maier
2021-07-19 12:06 ` Stuart Morrow
2021-07-19 19:40 ` Amavect
2021-07-19 19:52 ` ori
2021-07-21 21:19 ` Stuart Morrow
2021-07-21 21:20 ` Stuart Morrow
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).