man: various cleanup

Change-Id: I9130e7d10ae42e894923097a7c97da802eb0d8c3
Reviewed-on: https://plan9port-review.googlesource.com/2962
Reviewed-by: Russ Cox <rsc@swtch.com>

26 files changed, 43 insertions, 49 deletions

diff --git a/man/man1/INDEX b/man/man1/INDEX
index 218e5393..e3ff2f16 100644
--- a/man/man1/INDEX
+++ b/man/man1/INDEX
@@ -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
@@ -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
@@ -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
@@ -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
diff --git a/man/man1/awk.1 b/man/man1/awk.1
index df28f145..9a933b70 100644
--- a/man/man1/awk.1
+++ b/man/man1/awk.1
@@ -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
diff --git a/man/man1/col.1 b/man/man1/col.1
index 0d9513cf..1cdcbcba 100644
--- a/man/man1/col.1
+++ b/man/man1/col.1
@@ -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
diff --git a/man/man1/git.1 b/man/man1/git.1
index 19f2a102..b7e111f5 100644
--- a/man/man1/git.1
+++ b/man/man1/git.1
@@ -1,4 +1,4 @@
-.TH HG 1
+.TH GIT 1
 .SH NAME 
 git, hg, cvs \- introduction to using plan9port Git repository
 .SH SYNOPSIS
diff --git a/man/man1/graph.1 b/man/man1/graph.1
index e82d3126..bb6d25da 100644
--- a/man/man1/graph.1
+++ b/man/man1/graph.1
@@ -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
diff --git a/man/man1/mount.1 b/man/man1/mount.1
index 4722a49a..ec9f016e 100644
--- a/man/man1/mount.1
+++ b/man/man1/mount.1
@@ -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
diff --git a/man/man1/pic.1 b/man/man1/pic.1
index de443cc0..0ee526fe 100644
--- a/man/man1/pic.1
+++ b/man/man1/pic.1
@@ -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
 [
diff --git a/man/man1/resample.1 b/man/man1/resample.1
index 87922468..f41d9e51 100755
--- a/man/man1/resample.1
+++ b/man/man1/resample.1
@@ -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.
@@ -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.
diff --git a/man/man3/INDEX b/man/man3/INDEX
index 9664f800..6654ea7c 100644
--- a/man/man3/INDEX
+++ b/man/man3/INDEX
@@ -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
@@ -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
@@ -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
diff --git a/man/man3/ctime.3 b/man/man3/ctime.3
index 65ab1d41..5491d39f 100644
--- a/man/man3/ctime.3
+++ b/man/man3/ctime.3
@@ -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
@@ -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)
diff --git a/man/man3/getsnarf.3 b/man/man3/getsnarf.3
index 6c236e76..938aae3f 100644
--- a/man/man3/getsnarf.3
+++ b/man/man3/getsnarf.3
@@ -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).
diff --git a/man/man3/mux.3 b/man/man3/mux.3
index caaf55ff..0c429fba 100644
--- a/man/man3/mux.3
+++ b/man/man3/mux.3
@@ -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
diff --git a/man/man3/needstack.3 b/man/man3/needstack.3
index cf13809d..071b8916 100644
--- a/man/man3/needstack.3
+++ b/man/man3/needstack.3
@@ -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
diff --git a/man/man3/wctl.3 b/man/man3/wctl.3
index 9addaeb2..25c90234 100644
--- a/man/man3/wctl.3
+++ b/man/man3/wctl.3
@@ -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
diff --git a/man/man4/INDEX b/man/man4/INDEX
index 7b90c482..1965c3a7 100644
--- a/man/man4/INDEX
+++ b/man/man4/INDEX
@@ -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
diff --git a/man/man4/fontsrv.4 b/man/man4/fontsrv.4
index 7344cde9..3fb0d66b 100644
--- a/man/man4/fontsrv.4
+++ b/man/man4/fontsrv.4
@@ -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.
-
diff --git a/man/man4/fossil.4 b/man/man4/fossil.4
index 6bb4a392..7c06f2f7 100644
--- a/man/man4/fossil.4
+++ b/man/man4/fossil.4
@@ -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),
diff --git a/man/man4/smugfs.4 b/man/man4/smugfs.4
index f05ccf49..4fb8c7f0 100644
--- a/man/man4/smugfs.4
+++ b/man/man4/smugfs.4
@@ -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
diff --git a/man/man4/tapefs.4 b/man/man4/tapefs.4
index 26f2afa5..3297e2a4 100644
--- a/man/man4/tapefs.4
+++ b/man/man4/tapefs.4
@@ -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).
diff --git a/man/man7/htmlroff.7 b/man/man7/htmlroff.7
index 2e93a2d7..e908c3ff 100644
--- a/man/man7/htmlroff.7
+++ b/man/man7/htmlroff.7
@@ -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.
@@ -51,7 +51,7 @@ For example, the input:
 \&.html td <td>Cell 2
 \&.html td
 \&.html t
-.EX
+.EE
 .LP
 produces this output:
 .IP
diff --git a/man/man7/mhtml.7 b/man/man7/mhtml.7
index 666eaad9..dcf49868 100644
--- a/man/man7/mhtml.7
+++ b/man/man7/mhtml.7
@@ -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
@@ -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
diff --git a/man/man8/INDEX b/man/man8/INDEX
index 13ced073..f122247f 100644
--- a/man/man8/INDEX
+++ b/man/man8/INDEX
@@ -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
diff --git a/man/man8/fossilcons.8 b/man/man8/fossilcons.8
index 163ee1ac..b59b6b6a 100644
--- a/man/man8/fossilcons.8
+++ b/man/man8/fossilcons.8
@@ -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
diff --git a/man/man8/getflags.8 b/man/man8/getflags.8
index 50274d40..86c295b9 100644
--- a/man/man8/getflags.8
+++ b/man/man8/getflags.8
@@ -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
diff --git a/man/man8/listen1.8 b/man/man8/listen1.8
index 0c4fc7a4..534766bf 100644
--- a/man/man8/listen1.8
+++ b/man/man8/listen1.8
@@ -1,4 +1,4 @@
-.TH LISTEN 8
+.TH LISTEN1 8
 .SH NAME
 listen1 \- listen for calls on a network device
 .SH SYNOPSIS
diff --git a/man/mkfile b/man/mkfile
index 8235445a..a1ba97b6 100644
--- a/man/mkfile
+++ b/man/mkfile
@@ -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: