From b546bd6e723bcc49b0701729b7bc70fc9745eec2 Mon Sep 17 00:00:00 2001 From: Russ Cox Date: Sat, 15 Jul 2017 20:49:52 -0600 Subject: man: various cleanup Change-Id: I9130e7d10ae42e894923097a7c97da802eb0d8c3 Reviewed-on: https://plan9port-review.googlesource.com/2962 Reviewed-by: Russ Cox --- man/man1/INDEX | 7 +++++-- man/man1/awk.1 | 4 ++-- man/man1/col.1 | 4 ++-- man/man1/git.1 | 2 +- man/man1/graph.1 | 2 +- man/man1/mount.1 | 2 +- man/man1/pic.1 | 2 +- man/man1/resample.1 | 4 ++-- man/man3/INDEX | 3 +-- man/man3/ctime.3 | 6 +++--- man/man3/getsnarf.3 | 14 +------------- man/man3/mux.3 | 2 +- man/man3/needstack.3 | 4 ++-- man/man3/wctl.3 | 4 +--- man/man4/INDEX | 4 ++++ man/man4/fontsrv.4 | 1 - man/man4/fossil.4 | 2 +- man/man4/smugfs.4 | 2 +- man/man4/tapefs.4 | 4 ++-- man/man7/htmlroff.7 | 4 ++-- man/man7/mhtml.7 | 4 ++-- man/man8/INDEX | 3 +++ man/man8/fossilcons.8 | 2 +- man/man8/getflags.8 | 2 +- man/man8/listen1.8 | 2 +- man/mkfile | 2 +- 26 files changed, 43 insertions(+), 49 deletions(-) (limited to 'man') 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 .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 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: -- cgit v1.2.3