commit b546bd6e723bcc49b0701729b7bc70fc9745eec2 from: Russ Cox date: Sun Jul 16 02:52:27 2017 UTC man: various cleanup Change-Id: I9130e7d10ae42e894923097a7c97da802eb0d8c3 Reviewed-on: https://plan9port-review.googlesource.com/2962 Reviewed-by: Russ Cox commit - a18efdbab89f34ead735f572bb36b16a673dc265 commit + b546bd6e723bcc49b0701729b7bc70fc9745eec2 blob - 218e53932e75c5ec0f75b8ec04e2924936ead081 blob + e3ff2f16fea494e82d2643942c26ec7b64799217 --- man/man1/INDEX +++ 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 blob - df28f145265f714f16ca47fe97e651fed494b00a blob + 9a933b709ee877fb9a846d41b7dbffe8e9158ca8 --- man/man1/awk.1 +++ man/man1/awk.1 @@ -546,10 +546,10 @@ There are no explicit conversions between numbers and 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 blob - 0d9513cf4a298c98ee61034d7564edacc94a88fa blob + 1cdcbcba41cce5d04c7dcbe37aae0329afec4633 --- man/man1/col.1 +++ 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 blob - 19f2a102f77e235e035654182e992fba0ef748d2 blob + b7e111f5aca1230e004ba497d47d14a0399929c3 --- man/man1/git.1 +++ 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 blob - e82d312620f9c2d1565d6c8f2623abc7889afe7c blob + bb6d25da9a974828ec4c5b1587233825f45dc3bd --- man/man1/graph.1 +++ 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 blob - 4722a49a2ff3985227ee60a436205ccb59df1b4f blob + ec9f016e47f16439801c01401baff67539a1f2b8 --- man/man1/mount.1 +++ 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 blob - de443cc0f4a219a2385a8433be8edf7cae52e6b5 blob + 0ee526fe1905b2d17b2d178a132412a92b8c5bb2 --- man/man1/pic.1 +++ 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 [ blob - 87922468e0dfb03cc8a709c03543f0b132499ef6 blob + f41d9e5129aedb7ed024d79e943541178c0ba00f --- man/man1/resample.1 +++ 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, us .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. blob - 9664f800d4a2320f7213d32eb2d895c0283970c0 blob + 6654ea7c2209304d515e9dce888cb10bb4b6ed9b --- man/man3/INDEX +++ 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 blob - 65ab1d4122e20f518dbfcf2b40e58c0e6825d79c blob + 5491d39fd7d5cfe4f390f7ab68fee719e25cb302 --- man/man3/ctime.3 +++ 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) blob - 6c236e76c4c3c5a8ac8ae28927980442a540ca09 blob + 938aae3f201ade00ac4f3790d424abb78f4a1260 --- man/man3/getsnarf.3 +++ 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). blob - caaf55fffc752246d6c4bc4fd3216024fcb8fd99 blob + 0c429fba9fc42ac9f6f3bfbb64fb83cdd21cdec4 --- man/man3/mux.3 +++ 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 blob - cf13809d0387f63ebb30a5ffdc38a665cae6472f blob + 071b89165e9061a99fc4a6ffeeee210d81ee8806 --- man/man3/needstack.3 +++ 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 blob - 9addaeb29d5f671f40b20cf8a810a33fe7c96bce blob + 25c90234615d81bf533350ab049b9e7d8c4d3f06 --- man/man3/wctl.3 +++ 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 blob - 7b90c482e6eae24506213c49f53cee7749eee08e blob + 1965c3a77c0649c6806d3b3efb2fab2d85426102 --- man/man4/INDEX +++ 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 blob - 7344cde9628b70e10e1109ce055d8869e252c80c blob + 3fb0d66b92d3a6313247f03ad256e39ffd682428 --- man/man4/fontsrv.4 +++ 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. - blob - 6bb4a39207b006981d7cdfc6b5e78ff1f0fb8e03 blob + 7c06f2f7a09ecccaffac24f327ed29abd3bf0d5b --- man/man4/fossil.4 +++ 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), blob - f05ccf49018a8ea2512e88a6f65c23084f7279a5 blob + 4fb8c7f0f97962e26b6bc63f858477f710406ba9 --- man/man4/smugfs.4 +++ 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 blob - 26f2afa58049594440c6c9217ae0b27e32d4fb31 blob + 3297e2a42c7f358c4265601778eb799a1b1a0b8d --- man/man4/tapefs.4 +++ 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). blob - 2e93a2d7721557d884b29f8faba30602bdb65787 blob + e908c3ff5056c2d7bb86e0d1366935f53fac54c7 --- man/man7/htmlroff.7 +++ 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 blob - 666eaad9908506da553e4380791a575e3e005919 blob + dcf49868da60ed5dbdaa251129674a12fda391c5 --- man/man7/mhtml.7 +++ 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 blob - 13ced07325f5320812bb52420aa3f3eb77365ff1 blob + f122247ff7e5681e1845527ab839e0e5d93fbdbf --- man/man8/INDEX +++ 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 blob - 163ee1ac6a276eec4597d3cbdd64e7d846586b31 blob + b59b6b6a760371e83cbce994ab5e825db40870d7 --- man/man8/fossilcons.8 +++ man/man8/fossilcons.8 @@ -491,7 +491,7 @@ the string used to represent this user in the on-disk 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 blob - 50274d4079a9fb4224a0f7dc5c690e28401930ed blob + 86c295b9ccac854f72791af5a9b1d29f188d5a4a --- man/man8/getflags.8 +++ 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 blob - 0c4fc7a4f7c454529e69bf20c684465e4579d7c7 blob + 534766bfd77176d5cfbfce5293001864ade77cba --- man/man8/listen1.8 +++ 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 blob - 8235445ab43a9c91f96bdf79a96fdfa6da107c79 blob + a1ba97b671283efd9bbc2290b9908ecb09555b32 --- man/mkfile +++ 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: