tman: various cleanup - plan9port - [fork] Plan 9 from user space
(HTM) git clone git://src.adamsgaard.dk/plan9port
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) LICENSE
---
(DIR) commit b546bd6e723bcc49b0701729b7bc70fc9745eec2
(DIR) parent a18efdbab89f34ead735f572bb36b16a673dc265
(HTM) Author: Russ Cox <rsc@swtch.com>
Date: Sat, 15 Jul 2017 20:49:52 -0600
man: various cleanup
Change-Id: I9130e7d10ae42e894923097a7c97da802eb0d8c3
Reviewed-on: https://plan9port-review.googlesource.com/2962
Reviewed-by: Russ Cox <rsc@swtch.com>
Diffstat:
M man/man1/INDEX | 7 +++++--
M man/man1/awk.1 | 4 ++--
M man/man1/col.1 | 4 ++--
M man/man1/git.1 | 2 +-
M man/man1/graph.1 | 2 +-
M man/man1/mount.1 | 2 +-
M man/man1/pic.1 | 2 +-
M man/man1/resample.1 | 4 ++--
M man/man3/INDEX | 3 +--
M man/man3/ctime.3 | 6 +++---
M man/man3/getsnarf.3 | 14 +-------------
M man/man3/mux.3 | 2 +-
M man/man3/needstack.3 | 4 ++--
M man/man3/wctl.3 | 4 +---
M man/man4/INDEX | 4 ++++
M man/man4/fontsrv.4 | 1 -
M man/man4/fossil.4 | 2 +-
M man/man4/smugfs.4 | 2 +-
M man/man4/tapefs.4 | 4 ++--
M man/man7/htmlroff.7 | 4 ++--
M man/man7/mhtml.7 | 4 ++--
M man/man8/INDEX | 3 +++
M man/man8/fossilcons.8 | 2 +-
M man/man8/getflags.8 | 2 +-
M man/man8/listen1.8 | 2 +-
M man/mkfile | 2 +-
26 files changed, 43 insertions(+), 49 deletions(-)
---
(DIR) diff --git a/man/man1/INDEX b/man/man1/INDEX
t@@ -34,6 +34,7 @@ auxclog clog.1
clog clog.1
cmp cmp.1
codereview codereview.1
+col col.1
cmapcube colors.1
colors colors.1
comm comm.1
t@@ -44,6 +45,7 @@ date date.1
db db.1
stack db.1
dc dc.1
+dd dd.1
delatex deroff.1
deroff deroff.1
devdraw devdraw.1
t@@ -63,6 +65,9 @@ fortune fortune.1
freq freq.1
fsize fsize.1
mtime fsize.1
+cvs git.1
+git git.1
+hg git.1
grap grap.1
graph graph.1
g grep.1
t@@ -75,8 +80,6 @@ gunzip gzip.1
gzip gzip.1
unzip gzip.1
zip gzip.1
-cvs hg.1
-hg hg.1
hget hget.1
hist hist.1
history hist.1
(DIR) diff --git a/man/man1/awk.1 b/man/man1/awk.1
t@@ -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 it to be treated as a string concatenate
\&\fL""\fP to it.
-.br
+.PP
The scope rules for variables in functions are a botch;
the syntax is worse.
-.br
+.PP
UTF is not always dealt with correctly,
though
.I awk
(DIR) diff --git a/man/man1/col.1 b/man/man1/col.1
t@@ -14,9 +14,9 @@ and half line feeds (ESC-9 and ESC-8)
as produced by
.I nroff
for .2C in
-.IR ms (6)
+.IR ms (7)
or
-.IR man (6)
+.IR man (7)
and for
.IR tbl (1).
.I Col
(DIR) diff --git a/man/man1/git.1 b/man/man1/git.1
t@@ -1,4 +1,4 @@
-.TH HG 1
+.TH GIT 1
.SH NAME
git, hg, cvs \- introduction to using plan9port Git repository
.SH SYNOPSIS
(DIR) diff --git a/man/man1/graph.1 b/man/man1/graph.1
t@@ -89,7 +89,7 @@ The next argument is
Next argument is one or more of the characters
.B bcgkmrwy,
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.
.TP
.B -s
(DIR) diff --git a/man/man1/mount.1 b/man/man1/mount.1
t@@ -15,7 +15,7 @@ mounts a 9P server's files into the file system.
is typically
either the name of a Unix domain socket
(see
-.IR namespace (4))
+.IR namespace (1))
or the name or IP address of a machine
serving 9P over TCP port 564.
.PP
(DIR) diff --git a/man/man1/pic.1 b/man/man1/pic.1
t@@ -12,7 +12,7 @@
.if \\n($1>0 .sp .65
..
.SH NAME
-pic, tpic \- troff and tex preprocessors for drawing pictures
+pic, tpic, svgpic \- troff and tex preprocessors for drawing pictures
.SH SYNOPSIS
.B pic
[
(DIR) diff --git a/man/man1/resample.1 b/man/man1/resample.1
t@@ -40,7 +40,7 @@ and
.PP
The input should be a Plan 9 image
as described in
-.IR image (6),
+.IR image (7),
and the output will be a compressed 24-bit
.B r8g8b8
image.
t@@ -53,6 +53,6 @@ To uncompress the image or change the pixel format, use
.B \*9/src/cmd/resample.c
.SH "SEE ALSO
.IR crop (1),
-.IR image (6)
+.IR image (7)
.SH BUGS
Faster algorithms exist, but this implementation produces correct pictures.
(DIR) diff --git a/man/man3/INDEX b/man/man3/INDEX
t@@ -301,7 +301,6 @@ asctime ctime.3
ctime ctime.3
gmtime ctime.3
localtime ctime.3
-timezone ctime.3
tm2sec ctime.3
block_cipher des.3
t@@ -1238,6 +1237,7 @@ threadsetgrp thread.3
threadsetname thread.3
threadsetstate thread.3
threadspawn thread.3
+threadspawnd thread.3
threadspawnl thread.3
threadunpin thread.3
threadwaitchan thread.3
t@@ -1255,7 +1255,6 @@ vtblockput venti-cache.3
vtblockwrite venti-cache.3
vtcachealloc venti-cache.3
vtcacheallocblock venti-cache.3
-vtcacheblocksize venti-cache.3
vtcachefree venti-cache.3
vtcacheglobal venti-cache.3
vtcachelocal venti-cache.3
(DIR) diff --git a/man/man3/ctime.3 b/man/man3/ctime.3
t@@ -1,6 +1,6 @@
.TH CTIME 3
.SH NAME
-ctime, localtime, gmtime, asctime, tm2sec, timezone \- convert date and time
+ctime, localtime, gmtime, asctime, tm2sec \- convert date and time
.SH SYNOPSIS
.B #include <u.h>
.br
t@@ -81,9 +81,9 @@ if
is not
.BR GMT .
.SH SOURCE
-.B \*9/src/lib9/date.c
-.br
.B \*9/src/lib9/ctime.c
+.br
+.B \*9/src/lib9/tm2sec.c
.SH "SEE ALSO"
.IR date (1),
.IR time (3)
(DIR) diff --git a/man/man3/getsnarf.3 b/man/man3/getsnarf.3
t@@ -34,18 +34,6 @@ and
.I putsnarf
will convert as necessary.
.SH SOURCE
-.B \*9/src/libdraw/x11-itrans.c
+.B \*9/src/libdraw/snarf.c
.SH SEE ALSO
.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).
(DIR) diff --git a/man/man3/mux.3 b/man/man3/mux.3
t@@ -146,7 +146,7 @@ that need to remain active.
.I Libmux
also provides a non-blocking interface, useful for programs forced
to use a
-.IR select (2)-based
+.IR select (3)-based
main loop.
.I Muxrpcstart
runs the first half of
(DIR) diff --git a/man/man3/needstack.3 b/man/man3/needstack.3
t@@ -50,9 +50,9 @@ like
The X Window library implementation of
.I XLookupString
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
-.B needstack(20*1024)
+.B needstack(64*1024)
before making calls to
.IR XLookupString .
If a thread (in this case, the keyboard-reading thread used
(DIR) diff --git a/man/man3/wctl.3 b/man/man3/wctl.3
t@@ -34,6 +34,4 @@ requests that the program's window title be set to
requests that the program's window be moved
above all other windows and given the input focus.
.SH SOURCE
-.B \*9/src/libdraw/x11-init.c
-.br
-.B \*9/src/libdraw/x11-wsys.c
+.B \*9/src/libdraw/wsys.c
(DIR) diff --git a/man/man4/INDEX b/man/man4/INDEX
t@@ -1,10 +1,14 @@
0intro 0intro.4
intro 0intro.4
+9import 9import.4
9pfuse 9pfuse.4
9pserve 9pserve.4
acme acme.4
factotum factotum.4
fontsrv fontsrv.4
+flchk fossil.4
+flfmt fossil.4
+fossil fossil.4
import import.4
plumber plumber.4
ramfs ramfs.4
(DIR) diff --git a/man/man4/fontsrv.4 b/man/man4/fontsrv.4
t@@ -130,4 +130,3 @@ For example, the lower case r in the subfont
.B Times-Roman/14a/x0000.bit
appears truncated on the right and
too light overall.
-
(DIR) diff --git a/man/man4/fossil.4 b/man/man4/fossil.4
t@@ -486,7 +486,7 @@ and then use the
.I sed
command to prepare the script.
.SH SOURCE
-.B /sys/src/cmd/fossil
+.B \*9/src/cmd/fossil
.SH SEE ALSO
.IR yesterday (1),
.IR fs (3),
(DIR) diff --git a/man/man4/smugfs.4 b/man/man4/smugfs.4
t@@ -264,7 +264,7 @@ SmugMug,
.PP
If multiple categories or albums have the same name,
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)
will resolve the problem.
.PP
(DIR) diff --git a/man/man4/tapefs.4 b/man/man4/tapefs.4
t@@ -100,10 +100,10 @@ way using the files
and
.I util.c
in
-.BR /sys/src/cmd/tapefs ,
+.BR \*9/src/cmd/tapefs ,
which in
turn derive substantially from
.IR ramfs (4).
.SH "SEE ALSO
-.IR intro (5),
+.IR intro (7),
.IR ramfs (4).
(DIR) diff --git a/man/man7/htmlroff.7 b/man/man7/htmlroff.7
t@@ -2,7 +2,7 @@
.SH NAME
htmlroff \- HTML formatting and typesetting
.SH DESCRIPTION
-.I Htmlroff (1)
+.IR Htmlroff (1)
accepts
.I troff
input with a few extensions and changes.
t@@ -51,7 +51,7 @@ For example, the input:
\&.html td <td>Cell 2
\&.html td
\&.html t
-.EX
+.EE
.LP
produces this output:
.IP
(DIR) diff --git a/man/man7/mhtml.7 b/man/man7/mhtml.7
t@@ -22,7 +22,7 @@ This package of
.IR htmlroff (1)
macro definitions provides convenient macros for formatting HTML.
It is usually used along with
-.I troff (1)
+.IR troff (1)
macro packages such as
.IR man (7)
and
t@@ -75,7 +75,7 @@ and
.B .PE
with a PNG image corresponding to the output of
running
-.I troff(1)
+.IR troff (1)
on the input.
.TP
.B .TS\fR, \fP.TE
(DIR) diff --git a/man/man8/INDEX b/man/man8/INDEX
t@@ -1,6 +1,9 @@
+fossilcons fossilcons.8
getflags getflags.8
usage getflags.8
listen1 listen1.8
+mkext mkfs.8
+mkfs mkfs.8
vbackup vbackup.8
vcat vbackup.8
vftp vbackup.8
(DIR) diff --git a/man/man8/fossilcons.8 b/man/man8/fossilcons.8
t@@ -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
.TP
.I leader
-the group's leader (see
+the group's leader (see Plan 9's
.IR stat (5)
for a description of the special privileges held by a group leader)
.TP
(DIR) diff --git a/man/man8/getflags.8 b/man/man8/getflags.8
t@@ -58,7 +58,7 @@ which does not set
.BR $0 ,
the program name must be given explicitly on the command line.
.SH EXAMPLE
-Parse the arguments for
+Parse the arguments for Plan 9's
.IR leak (1):
.IP
.EX
(DIR) diff --git a/man/man8/listen1.8 b/man/man8/listen1.8
t@@ -1,4 +1,4 @@
-.TH LISTEN 8
+.TH LISTEN1 8
.SH NAME
listen1 \- listen for calls on a network device
.SH SYNOPSIS
(DIR) diff --git a/man/mkfile b/man/mkfile
t@@ -3,7 +3,7 @@ LIB=$PLAN9/lib
indices:V:
for i in man*
do
- rc ./secindex $i > $i/INDEX
+ 9 rc ./secindex $i > $i/INDEX
done
lookman.index:V: