man: various cleanup

Change-Id: I9130e7d10ae42e894923097a7c97da802eb0d8c3
Reviewed-on: https://plan9port-review.googlesource.com/2962
Reviewed-by: Russ Cox <rsc@swtch.com>
This commit is contained in:
Russ Cox 2017-07-15 20:49:52 -06:00
parent a18efdbab8
commit b546bd6e72
26 changed files with 43 additions and 49 deletions

View file

@ -34,6 +34,7 @@ auxclog clog.1
clog clog.1 clog clog.1
cmp cmp.1 cmp cmp.1
codereview codereview.1 codereview codereview.1
col col.1
cmapcube colors.1 cmapcube colors.1
colors colors.1 colors colors.1
comm comm.1 comm comm.1
@ -44,6 +45,7 @@ date date.1
db db.1 db db.1
stack db.1 stack db.1
dc dc.1 dc dc.1
dd dd.1
delatex deroff.1 delatex deroff.1
deroff deroff.1 deroff deroff.1
devdraw devdraw.1 devdraw devdraw.1
@ -63,6 +65,9 @@ fortune fortune.1
freq freq.1 freq freq.1
fsize fsize.1 fsize fsize.1
mtime fsize.1 mtime fsize.1
cvs git.1
git git.1
hg git.1
grap grap.1 grap grap.1
graph graph.1 graph graph.1
g grep.1 g grep.1
@ -75,8 +80,6 @@ gunzip gzip.1
gzip gzip.1 gzip gzip.1
unzip gzip.1 unzip gzip.1
zip gzip.1 zip gzip.1
cvs hg.1
hg hg.1
hget hget.1 hget hget.1
hist hist.1 hist hist.1
history hist.1 history hist.1

View file

@ -546,10 +546,10 @@ There are no explicit conversions between numbers and strings.
To force an expression to be treated as a number add 0 to it; To force an expression to be treated as a number add 0 to it;
to force it to be treated as a string concatenate to force it to be treated as a string concatenate
\&\fL""\fP to it. \&\fL""\fP to it.
.br .PP
The scope rules for variables in functions are a botch; The scope rules for variables in functions are a botch;
the syntax is worse. the syntax is worse.
.br .PP
UTF is not always dealt with correctly, UTF is not always dealt with correctly,
though though
.I awk .I awk

View file

@ -14,9 +14,9 @@ and half line feeds (ESC-9 and ESC-8)
as produced by as produced by
.I nroff .I nroff
for .2C in for .2C in
.IR ms (6) .IR ms (7)
or or
.IR man (6) .IR man (7)
and for and for
.IR tbl (1). .IR tbl (1).
.I Col .I Col

View file

@ -1,4 +1,4 @@
.TH HG 1 .TH GIT 1
.SH NAME .SH NAME
git, hg, cvs \- introduction to using plan9port Git repository git, hg, cvs \- introduction to using plan9port Git repository
.SH SYNOPSIS .SH SYNOPSIS

View file

@ -89,7 +89,7 @@ The next argument is
Next argument is one or more of the characters Next argument is one or more of the characters
.B bcgkmrwy, .B bcgkmrwy,
choosing pen colors by their initial letter, as in choosing pen colors by their initial letter, as in
.IR plot (6). .IR plot (7).
Successive curves will cycle through the colors in the given order. Successive curves will cycle through the colors in the given order.
.TP .TP
.B -s .B -s

View file

@ -15,7 +15,7 @@ mounts a 9P server's files into the file system.
is typically is typically
either the name of a Unix domain socket either the name of a Unix domain socket
(see (see
.IR namespace (4)) .IR namespace (1))
or the name or IP address of a machine or the name or IP address of a machine
serving 9P over TCP port 564. serving 9P over TCP port 564.
.PP .PP

View file

@ -12,7 +12,7 @@
.if \\n($1>0 .sp .65 .if \\n($1>0 .sp .65
.. ..
.SH NAME .SH NAME
pic, tpic \- troff and tex preprocessors for drawing pictures pic, tpic, svgpic \- troff and tex preprocessors for drawing pictures
.SH SYNOPSIS .SH SYNOPSIS
.B pic .B pic
[ [

View file

@ -40,7 +40,7 @@ and
.PP .PP
The input should be a Plan 9 image The input should be a Plan 9 image
as described in as described in
.IR image (6), .IR image (7),
and the output will be a compressed 24-bit and the output will be a compressed 24-bit
.B r8g8b8 .B r8g8b8
image. image.
@ -53,6 +53,6 @@ To uncompress the image or change the pixel format, use
.B \*9/src/cmd/resample.c .B \*9/src/cmd/resample.c
.SH "SEE ALSO .SH "SEE ALSO
.IR crop (1), .IR crop (1),
.IR image (6) .IR image (7)
.SH BUGS .SH BUGS
Faster algorithms exist, but this implementation produces correct pictures. Faster algorithms exist, but this implementation produces correct pictures.

View file

@ -301,7 +301,6 @@ asctime ctime.3
ctime ctime.3 ctime ctime.3
gmtime ctime.3 gmtime ctime.3
localtime ctime.3 localtime ctime.3
timezone ctime.3
tm2sec ctime.3 tm2sec ctime.3
block_cipher des.3 block_cipher des.3
@ -1238,6 +1237,7 @@ threadsetgrp thread.3
threadsetname thread.3 threadsetname thread.3
threadsetstate thread.3 threadsetstate thread.3
threadspawn thread.3 threadspawn thread.3
threadspawnd thread.3
threadspawnl thread.3 threadspawnl thread.3
threadunpin thread.3 threadunpin thread.3
threadwaitchan thread.3 threadwaitchan thread.3
@ -1255,7 +1255,6 @@ vtblockput venti-cache.3
vtblockwrite venti-cache.3 vtblockwrite venti-cache.3
vtcachealloc venti-cache.3 vtcachealloc venti-cache.3
vtcacheallocblock venti-cache.3 vtcacheallocblock venti-cache.3
vtcacheblocksize venti-cache.3
vtcachefree venti-cache.3 vtcachefree venti-cache.3
vtcacheglobal venti-cache.3 vtcacheglobal venti-cache.3
vtcachelocal venti-cache.3 vtcachelocal venti-cache.3

View file

@ -1,6 +1,6 @@
.TH CTIME 3 .TH CTIME 3
.SH NAME .SH NAME
ctime, localtime, gmtime, asctime, tm2sec, timezone \- convert date and time ctime, localtime, gmtime, asctime, tm2sec \- convert date and time
.SH SYNOPSIS .SH SYNOPSIS
.B #include <u.h> .B #include <u.h>
.br .br
@ -81,9 +81,9 @@ if
is not is not
.BR GMT . .BR GMT .
.SH SOURCE .SH SOURCE
.B \*9/src/lib9/date.c
.br
.B \*9/src/lib9/ctime.c .B \*9/src/lib9/ctime.c
.br
.B \*9/src/lib9/tm2sec.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR date (1), .IR date (1),
.IR time (3) .IR time (3)

View file

@ -34,18 +34,6 @@ and
.I putsnarf .I putsnarf
will convert as necessary. will convert as necessary.
.SH SOURCE .SH SOURCE
.B \*9/src/libdraw/x11-itrans.c .B \*9/src/libdraw/snarf.c
.SH SEE ALSO .SH SEE ALSO
.IR snarfer (1) .IR snarfer (1)
.SH BUGS
On OS X, there are two snarf buffers: the Carbon snarf buffer
used by native OS X applications, and the X11 snarf buffer,
used by X11 applications.
Whenever new text is written to the Carbon snarf buffer, the OS X X11
implementation automatically copies that text to the X11 snarf buffer.
The reverse is not done automatically, arguably a bug in the X11 server.
To work around this,
.I putsnarf
writes to both the Carbon snarf buffer and the X11 snarf buffer.
To work around this bug in remote or non-Plan 9 X11 clients, run
.IR snarfer (1).

View file

@ -146,7 +146,7 @@ that need to remain active.
.I Libmux .I Libmux
also provides a non-blocking interface, useful for programs forced also provides a non-blocking interface, useful for programs forced
to use a to use a
.IR select (2)-based .IR select (3)-based
main loop. main loop.
.I Muxrpcstart .I Muxrpcstart
runs the first half of runs the first half of

View file

@ -50,9 +50,9 @@ like
The X Window library implementation of The X Window library implementation of
.I XLookupString .I XLookupString
allocates some very large buffers on the stack, so allocates some very large buffers on the stack, so
.B \*9/src/libdraw/x11-itrans.c .B \*9/src/cmd/devdraw/x11-itrans.c
calls calls
.B needstack(20*1024) .B needstack(64*1024)
before making calls to before making calls to
.IR XLookupString . .IR XLookupString .
If a thread (in this case, the keyboard-reading thread used If a thread (in this case, the keyboard-reading thread used

View file

@ -34,6 +34,4 @@ requests that the program's window title be set to
requests that the program's window be moved requests that the program's window be moved
above all other windows and given the input focus. above all other windows and given the input focus.
.SH SOURCE .SH SOURCE
.B \*9/src/libdraw/x11-init.c .B \*9/src/libdraw/wsys.c
.br
.B \*9/src/libdraw/x11-wsys.c

View file

@ -1,10 +1,14 @@
0intro 0intro.4 0intro 0intro.4
intro 0intro.4 intro 0intro.4
9import 9import.4
9pfuse 9pfuse.4 9pfuse 9pfuse.4
9pserve 9pserve.4 9pserve 9pserve.4
acme acme.4 acme acme.4
factotum factotum.4 factotum factotum.4
fontsrv fontsrv.4 fontsrv fontsrv.4
flchk fossil.4
flfmt fossil.4
fossil fossil.4
import import.4 import import.4
plumber plumber.4 plumber plumber.4
ramfs ramfs.4 ramfs ramfs.4

View file

@ -130,4 +130,3 @@ For example, the lower case r in the subfont
.B Times-Roman/14a/x0000.bit .B Times-Roman/14a/x0000.bit
appears truncated on the right and appears truncated on the right and
too light overall. too light overall.

View file

@ -486,7 +486,7 @@ and then use the
.I sed .I sed
command to prepare the script. command to prepare the script.
.SH SOURCE .SH SOURCE
.B /sys/src/cmd/fossil .B \*9/src/cmd/fossil
.SH SEE ALSO .SH SEE ALSO
.IR yesterday (1), .IR yesterday (1),
.IR fs (3), .IR fs (3),

View file

@ -264,7 +264,7 @@ SmugMug,
.PP .PP
If multiple categories or albums have the same name, If multiple categories or albums have the same name,
only one will be accessible via the file system interface. only one will be accessible via the file system interface.
Renaming the accessible one via Renaming the accessible one via Unix's
.IR mv (1) .IR mv (1)
will resolve the problem. will resolve the problem.
.PP .PP

View file

@ -100,10 +100,10 @@ way using the files
and and
.I util.c .I util.c
in in
.BR /sys/src/cmd/tapefs , .BR \*9/src/cmd/tapefs ,
which in which in
turn derive substantially from turn derive substantially from
.IR ramfs (4). .IR ramfs (4).
.SH "SEE ALSO .SH "SEE ALSO
.IR intro (5), .IR intro (7),
.IR ramfs (4). .IR ramfs (4).

View file

@ -2,7 +2,7 @@
.SH NAME .SH NAME
htmlroff \- HTML formatting and typesetting htmlroff \- HTML formatting and typesetting
.SH DESCRIPTION .SH DESCRIPTION
.I Htmlroff (1) .IR Htmlroff (1)
accepts accepts
.I troff .I troff
input with a few extensions and changes. input with a few extensions and changes.
@ -51,7 +51,7 @@ For example, the input:
\&.html td <td>Cell 2 \&.html td <td>Cell 2
\&.html td \&.html td
\&.html t \&.html t
.EX .EE
.LP .LP
produces this output: produces this output:
.IP .IP

View file

@ -22,7 +22,7 @@ This package of
.IR htmlroff (1) .IR htmlroff (1)
macro definitions provides convenient macros for formatting HTML. macro definitions provides convenient macros for formatting HTML.
It is usually used along with It is usually used along with
.I troff (1) .IR troff (1)
macro packages such as macro packages such as
.IR man (7) .IR man (7)
and and
@ -75,7 +75,7 @@ and
.B .PE .B .PE
with a PNG image corresponding to the output of with a PNG image corresponding to the output of
running running
.I troff(1) .IR troff (1)
on the input. on the input.
.TP .TP
.B .TS\fR, \fP.TE .B .TS\fR, \fP.TE

View file

@ -1,6 +1,9 @@
fossilcons fossilcons.8
getflags getflags.8 getflags getflags.8
usage getflags.8 usage getflags.8
listen1 listen1.8 listen1 listen1.8
mkext mkfs.8
mkfs mkfs.8
vbackup vbackup.8 vbackup vbackup.8
vcat vbackup.8 vcat vbackup.8
vftp vbackup.8 vftp vbackup.8

View file

@ -491,7 +491,7 @@ the string used to represent this user in the on-disk structures
the string used to represent this user in the 9P protocol the string used to represent this user in the 9P protocol
.TP .TP
.I leader .I leader
the group's leader (see the group's leader (see Plan 9's
.IR stat (5) .IR stat (5)
for a description of the special privileges held by a group leader) for a description of the special privileges held by a group leader)
.TP .TP

View file

@ -58,7 +58,7 @@ which does not set
.BR $0 , .BR $0 ,
the program name must be given explicitly on the command line. the program name must be given explicitly on the command line.
.SH EXAMPLE .SH EXAMPLE
Parse the arguments for Parse the arguments for Plan 9's
.IR leak (1): .IR leak (1):
.IP .IP
.EX .EX

View file

@ -1,4 +1,4 @@
.TH LISTEN 8 .TH LISTEN1 8
.SH NAME .SH NAME
listen1 \- listen for calls on a network device listen1 \- listen for calls on a network device
.SH SYNOPSIS .SH SYNOPSIS

View file

@ -3,7 +3,7 @@ LIB=$PLAN9/lib
indices:V: indices:V:
for i in man* for i in man*
do do
rc ./secindex $i > $i/INDEX 9 rc ./secindex $i > $i/INDEX
done done
lookman.index:V: lookman.index:V: