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: