From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=0.2 required=5.0 tests=DKIM_ADSP_CUSTOM_MED, DKIM_INVALID,DKIM_SIGNED,FREEMAIL_FROM autolearn=no autolearn_force=no version=3.4.4 Received: (qmail 2237 invoked from network); 21 Jul 2021 22:05:20 -0000 Received: from 1ess.inri.net (216.126.196.35) by inbox.vuxu.org with ESMTPUTF8; 21 Jul 2021 22:05:20 -0000 Received: from mail-ed1-f53.google.com ([209.85.208.53]) by 1ess; Wed Jul 21 17:25:01 -0400 2021 Received: by mail-ed1-f53.google.com with SMTP id h2so4197021edt.3 for <9front@9front.org>; Wed, 21 Jul 2021 14:24:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to; bh=BCt3Xlbm+QqzcyfnNFke6ikbxEO2sdP2LlZ7gUt8hws=; b=NzIWRRaTXtTrJnqmIKjn9rCaV8Mj1Xye8iNAjObiM+S+M0EypfRAX46VjGjyartXwV /EfM5aeKXLKedkCS+sVRaicqzYGsRVrFw3BiUkFcgy8REJvksUHOwDTBUAQXqyY0JVIE JyC64K6+5YTdwRsgf7yIebfLveD+uLqxugzg5Mt7YdTqiRJ5rvk7S5aqlxughQC858cn WqZf4AJ2Jqbb/NlNYujojpC7HEFFT+DrapMHoMRwjP2JOgMnDRnJpBrz7FXb89AYBKpV xPIZZoacrWFDF76/xE7aW1CRFPOSfOKtNMpaQPv/vNWMjbiAL4PJ11oIcWvhyM3sSg7x ak1A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to; bh=BCt3Xlbm+QqzcyfnNFke6ikbxEO2sdP2LlZ7gUt8hws=; b=km1K1XJ229LSah94D2oMuZODUW2aZABtpqw8bEnGR3nftTa61aQXiQ/7Tnw19DYfDV Qb47wzTcHJoQB5jX2geQO3AMPooObtj4aBbrSOnWnO82QwV/NA3HT8m3T7FDgE/CCkeO RE8DuryupuJBscsfJDrIzaNwP7qqvq1sHQRjVonvRJIUxquAQxX0LN5PTtH6RtaJyRUn nfGCYdB5ySlD1+cHZIFDMZTL+g0NKbpc9ErOp1OwsEV3Z9mU7ISHvYqea5flqiLi1zEW UPBIkY/QCJaUG0vSWS+nJXZFO3NVImW4j5DbQszTluthJeZPbPXbsDk2OwZ2U5gEytbs 9JUA== X-Gm-Message-State: AOAM532qIk8YiKD9QS2Yf2l0LxaOFOp5LaeUK+c0ZUsMbQNAne+9/po4 t55aPGi8K8sqV1NLZz94UAFNuvfS4qBOez52+sr1j2aLIQQ= X-Google-Smtp-Source: ABdhPJwVrE1X9hVfP/a7l3NRaqJDsgsowxHgOaLi8CqeBh9KCVORZ1+UIM4QQgYYM+6w7J3J4/Z1n3xRQkw7I5YANbM= X-Received: by 2002:a05:6402:1242:: with SMTP id l2mr49859092edw.97.1626902346616; Wed, 21 Jul 2021 14:19:06 -0700 (PDT) MIME-Version: 1.0 Received: by 2002:a17:906:76c8:b029:4d9:7711:78cc with HTTP; Wed, 21 Jul 2021 14:19:05 -0700 (PDT) In-Reply-To: References: From: Stuart Morrow Date: Wed, 21 Jul 2021 22:19:05 +0100 Message-ID: To: 9front@9front.org Content-Type: text/plain; charset="UTF-8" List-ID: <9front.9front.org> List-Help: X-Glyph: ➈ X-Bullshit: progressive standard browser-based DOM backend Subject: [9front] Re: small patches Reply-To: 9front@9front.org Precedence: bulk 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