commit 977b25a76ae8263e53fb4eb1abfc395769f23e3d from: Russ Cox date: Fri Aug 14 03:43:43 2020 UTC tmac: introduce real manual reference macro instead of overloading IR The overloading of IR emits magic \X'...' sequences that turn into HTML manual links. But not all such IR invocations should be manual links; those had to be written to avoid the IR macro before. Worse, the \X'...' ending the IR causes troff to emit only a single space after a period. Defining a new IM macro for manual references fixes both problems. Fixes #441. commit - a1c4307800c7f1ef9c5d71ba4c6c3642837e2877 commit + 977b25a76ae8263e53fb4eb1abfc395769f23e3d blob - 161349330c9802664a8425f3333d27a7e62ea413 blob + 5c45aefe960cb389aeae6d538ab548b386265b7c --- man/man1/0intro.1 +++ man/man1/0intro.1 @@ -32,15 +32,15 @@ they expect the environment variable to contain the name of the root of the tree. See -.IR install (1) +.IM install (1) for details about installation. .PP Many of the familiar Unix commands, for example -.IR cat (1), -.IR ls (1), +.IM cat (1) , +.IM ls (1) , and -.IR wc (1), +.IM wc (1) , are present, but in their Plan 9 forms: .I cat takes no options, @@ -50,12 +50,12 @@ and .I wc counts UTF characters. In some cases, the differences are quite noticeable: -.IR grep (1) +.IM grep (1) and -.IR sed (1) +.IM sed (1) expect Plan 9 regular expressions (see -.IR regexp (7)), +.IM regexp (7) ), which are closest to what Unix calls extended regular expressions. Because of these differences, it is not recommended to put .B $PLAN9/bin @@ -63,16 +63,16 @@ before the usual system .B bin directories in your search path. Instead, put it at the end of your path and use the -.IR 9 (1) +.IM 9 (1) script when you want to invoke the Plan 9 version of a traditional Unix command. .PP Occasionally the Plan 9 programs have been changed to adapt to Unix. -.IR Mk (1) +.IM Mk (1) now allows mkfiles to choose their own shell, and -.IR rc (1) +.IM rc (1) has a .I ulimit builtin and manages @@ -80,14 +80,14 @@ builtin and manages .PP Many of the graphical programs from Plan 9 are present, including -.IR sam (1) +.IM sam (1) and -.IR acme (1). +.IM acme (1) . An X11 window manager -.IR rio (1) +.IM rio (1) mimics Plan 9's window system, with command windows implemented by the external program -.IR 9term (1). +.IM 9term (1) . Following the style of X Windows, these programs run in new windows rather than the one in which they are invoked. They all take a @@ -101,10 +101,10 @@ The argument is one of \fIxmin\fL,\fIymin\fL,\fIxmax\fL,\fIymax\fR. .PP The -.IR plumber (4) +.IM plumber (4) helps to connect the various Plan 9 programs together, and fittings like -.IR web (1) +.IM web (1) connect it to external programs such as web browsers; one can click on a URL in .I acme @@ -119,17 +119,17 @@ with file servers by reading and writing files. This cannot be done directly on Unix. Instead the servers listen for 9P connections on Unix domain sockets; clients connect to these sockets and speak 9P directly using the -.IR 9pclient (3) +.IM 9pclient (3) library. -.IR Intro (4) +.IM Intro (4) tells more of the story. The effect is not as clean as on Plan 9, but it gets the job done and still provides a uniform and easy-to-understand mechanism. The -.IR 9p (1) +.IM 9p (1) client can be used in shell scripts or by hand to carry out simple interactions with servers. -.IR Netfiles (1) +.IM Netfiles (1) is an experimental client for acme. .SS External databases Some programs rely on large databases that would be @@ -146,7 +146,7 @@ The shell scripts and .I 9l (see -.IR 9c (1)) +.IM 9c (1) ) provide a simple interface to the underlying system compiler and linker, similar to the .I 2c @@ -165,22 +165,22 @@ so that no options are needed. .PP The only way to write multithreaded programs is to use the -.IR thread (3) +.IM thread (3) library. -.IR Rfork (3) +.IM Rfork (3) exists but is not as capable as on Plan 9. There are many unfortunate by necessary preprocessor diversions to make Plan 9 and Unix libraries coexist. See -.IR intro (3) +.IM intro (3) for details. .PP The debuggers -.IR acid (1) +.IM acid (1) and -.IR db (1) +.IM db (1) and the debugging library -.IR mach (3) +.IM mach (3) are works in progress. They are platform-independent, so that x86 Linux core dumps can be inspected on PowerPC Mac OS X machines, @@ -203,22 +203,22 @@ but that it is the extent to which they have been deve .SS Porting programs The vast majority of the familiar Plan 9 programs have been ported, including the Unicode-aware -.IR troff (1). +.IM troff (1) . .PP Of the more recent additions to Plan 9, -.IR factotum (4), -.IR secstore (1), +.IM factotum (4) , +.IM secstore (1) , and -.IR secstored (1), -.IR vac (1), -.IR vacfs (4), +.IM secstored (1) , +.IM vac (1) , +.IM vacfs (4) , and -.IR venti (8) +.IM venti (8) are all ported. .PP A backup system providing a dump file system built atop Venti is in progress; see -.IR vbackup (8). +.IM vbackup (8) . .SS Porting to new systems Porting the tree to new operating systems or architectures should be straightforward, as system-specific code has been @@ -240,9 +240,9 @@ need to write any system specific code at all. .PP There are other smaller system dependencies, such as the terminal handling code in -.IR 9term (1) +.IM 9term (1) and the implementation of -.IR getcallerpc (3), +.IM getcallerpc (3) , but these are usually simple and are not on the critical path for getting the system up and running. .SH SEE ALSO @@ -255,7 +255,7 @@ The manual pages are in a Unix style tree, with names instead of Plan 9's simpler .BR $PLAN9/man/1/cat , so that the Unix -.IR man (1) +.IM man (1) utility can handle it. Some systems, for example Debian Linux, deduce the man page locations from the search path, so that @@ -300,52 +300,52 @@ describes the Plan 9 file protocol 9P. These pages describe parts of the system that are new or different from Plan 9 from Bell Labs: .IP -.IR 9 (1), -.IR 9c (1), -.IR 9p (1), -.IR 9term (1), +.IM 9 (1) , +.IM 9c (1) , +.IM 9p (1) , +.IM 9term (1) , .I acidtypes in -.IR acid (1), -.IR dial (1), -.IR git (1), -.IR label (1), +.IM acid (1) , +.IM dial (1) , +.IM git (1) , +.IM label (1) , the .B MKSHELL variable in -.IR mk (1), -.IR namespace (1), -.IR netfiles (1), -.IR page (1), -.IR psfonts (1), -.IR rio (1), -.IR web (1), -.IR wintext (1) +.IM mk (1) , +.IM namespace (1) , +.IM netfiles (1) , +.IM page (1) , +.IM psfonts (1) , +.IM rio (1) , +.IM web (1) , +.IM wintext (1) .IP -.IR intro (3), -.IR 9pclient (3), +.IM intro (3) , +.IM 9pclient (3) , the .B unix network in -.IR dial (3), -.IR exits (3), -.IR get9root (3), -.IR getns (3), -.IR notify (3), -.IR post9pservice (3), -.IR rfork (3), -.IR searchpath (3), -.IR sendfd (3), -.IR udpread (3), -.IR venti (3), -.IR wait (3), -.IR wctl (3) +.IM dial (3) , +.IM exits (3) , +.IM get9root (3) , +.IM getns (3) , +.IM notify (3) , +.IM post9pservice (3) , +.IM rfork (3) , +.IM searchpath (3) , +.IM sendfd (3) , +.IM udpread (3) , +.IM venti (3) , +.IM wait (3) , +.IM wctl (3) .IP -.IR intro (4), -.IR 9pserve (4), -.IR import (4), +.IM intro (4) , +.IM 9pserve (4) , +.IM import (4) , .IP -.IR vbackup (8) +.IM vbackup (8) .IP .IR openfd (9p) .SH DIAGNOSTICS @@ -356,4 +356,4 @@ exit with string statuses. In fact, exiting with an e corresponds to exiting with status 0, and exiting with any non-empty string corresponds to exiting with status 1. See -.IR exits (3). +.IM exits (3) . blob - a115260d50662a165fa866e075bdbb48adcfc8b0 blob + b39ca885e267f509e5c426258ea85d91df58ca49 --- man/man1/9.1 +++ man/man1/9.1 @@ -12,7 +12,7 @@ .B . .B 9 (from -.IR sh (1)) +.IM sh (1) ) .PP .B 9.rc .I cmd @@ -24,7 +24,7 @@ .B . .B 9.rc (from -.IR rc (1)) +.IM rc (1) ) .PP .B u .I cmd @@ -36,7 +36,7 @@ .B . .B u (from -.IR sh (1)) +.IM sh (1) ) .PP .B u.rc .I cmd @@ -48,7 +48,7 @@ .B . .B u.rc (from -.IR rc (1)) +.IM rc (1) ) .SH DESCRIPTION Because Plan 9 supplies commands with the same name as but different behavior than many basic Unix system commands @@ -86,7 +86,7 @@ in order to make the current shell start running in th is the same as .I 9 but written for use by the shell -.IR rc (1). +.IM rc (1) . .PP .I U and @@ -106,7 +106,7 @@ $ 9 grep '[α-ζ]' /etc/passwd .EE .PP Start an -.IR rc (1) +.IM rc (1) with the Plan 9 commands in the path before the system commands, and then run the Unix .IR ls : @@ -124,7 +124,7 @@ $ 9 rc .br .B \*9/bin/u.rc .SH SEE ALSO -.IR intro (1) +.IM intro (1) .SH BUGS Some shell configurations (notably, oh-my-zsh) blob - 8d24d67d5171c2becbfd9197085c10d4b6a80b88 blob + 14bb618d8342bdd62c880c861434bc5569c316e5 --- man/man1/9c.1 +++ man/man1/9c.1 @@ -164,7 +164,7 @@ With .BR t , give a long listing of all information about the files, somewhat like a listing by -.IR ls (1), +.IM ls (1) , showing .br .ns blob - 762e7220572197e604c001da34ca3ec15e5893d3 blob + 3a77e244f3a13e8427d6d09de7dd2d51ba609faa --- man/man1/9p.1 +++ man/man1/9p.1 @@ -121,11 +121,11 @@ copy a line from standard input to the file. Print errors, but don't give up. .B Rdwr is useful for interacting with servers like -.IR factotum (4). +.IM factotum (4) . .TP .B ls Print a directory listing in the format of -.IR ls (1). +.IM ls (1) . The .B -d and @@ -150,12 +150,12 @@ it connects to the Unix domain socket .I service in the name space directory (see -.IR intro (4)) +.IM intro (4) ) and then accesses .IR subpath . .SH EXAMPLE To update -.IR plumber (4)'s +.IM plumber (4) 's copy of your plumbing rules after editing .BR $HOME/lib/plumbing : .IP @@ -164,7 +164,7 @@ cat $HOME/lib/plumbing | 9p write plumb/rules .EE .PP To display the contents of the current -.IR acme (4) +.IM acme (4) window: .IP .EX @@ -173,6 +173,6 @@ window: .SH SOURCE .B \*9/src/cmd/9p.c .SH SEE ALSO -.IR intro (4), +.IM intro (4) , .IR intro (9p), -.IR 9pclient (3) +.IM 9pclient (3) blob - b070613984a80941866a152ce677e6a920ee679d blob + bf0ee27f6e86b0fbaf8aa4aadef3719d1a4806dd --- man/man1/9term.1 +++ man/man1/9term.1 @@ -58,7 +58,7 @@ uses the imported value of .B $font if set; otherwise it uses the graphics system default. (See -.IR font (7) +.IM font (7) for a full discussion of font syntaxes.) .PP .I 9term @@ -96,7 +96,7 @@ Characters typed on the keyboard replace the selected if this text is not empty, it is placed in a .I snarf buffer common to all windows but distinct from that of -.IR sam (1). +.IM sam (1) . .PP Programs access the text in the window at a single point maintained automatically by @@ -163,7 +163,7 @@ and erases the character before the word. .PP An ACK character (control-F) or Insert character triggers file name completion for the preceding string (see -.IR complete (3)). +.IM complete (3) ). .PP Text may be moved vertically within the window. A scroll bar on the left of the window shows in its clear portion what fragment of the @@ -201,7 +201,7 @@ EOT, so the terminal must be set up with EOT as the ``eof'' character. .I 9term runs -.IR stty (1) +.IM stty (1) to establish this when the terminal is created. .PP .I 9term @@ -231,13 +231,13 @@ are a few common ones where they fall short. First, programs using the GNU readline library typically disable terminal echo and perform echoing themselves. The most common example is the shell -.IR bash (1). +.IM bash (1) . Disabling the use of readline with .RB `` "set +o emacs" '' .RI [ sic ] usually restores the desired behavior. Second, remote terminal programs such as -.IR ssh (1) +.IM ssh (1) typically run with echo disabled, relying on the remote system to echo characters as desired. Plan 9's @@ -279,7 +279,7 @@ The menu item sends the contents of the selection (not the snarf buffer) to the .I plumber (see -.IR plumb (1)). +.IM plumb (1) ). If the selection is empty, it sends the white-space-delimited text containing the selection (typing cursor). A typical use of this feature is to tell the editor to find the source of an error @@ -323,7 +323,7 @@ Not a .IR 9term bug: when running -.IR bash (1) +.IM bash (1) in .RB `` "set +o emacs" '' mode, its handling of interrupts is broken. @@ -334,4 +334,4 @@ character typed. .PP Unix makes everything harder. .SH SEE ALSO -.IR wintext (1) +.IM wintext (1) blob - ed0b24db98b61fd6df6935abff924c161a643a3c blob + a593f1c0282334d2f22cb1c856711cdc31eb085b --- man/man1/acid.1 +++ man/man1/acid.1 @@ -70,7 +70,7 @@ at startup; see below. .BI -m " machine Assume instructions are for the given CPU type (see -.IR mach (3)) +.IM mach (3) ) instead of using the executable header to select the CPU type. .TP @@ -145,7 +145,7 @@ subscripts counted from 0. .BI delete " list", " subscript .PP Format codes are the same as in -.IR db (1). +.IM db (1) . Formats may be attached to (unary) expressions with .BR \e , e.g. @@ -230,7 +230,7 @@ Print 10 lines of source around the program address. .BI Bsrc( address ) Get the source line for the program address into a window of a running -.IR sam (1) +.IM sam (1) and select it. .TP .BI line( address ) @@ -323,7 +323,7 @@ Make the given process current. .TP .BI rc( string ) Escape to the shell, -.IR rc (1), +.IM rc (1) , to execute the command string. .TP .BI include( string ) @@ -449,7 +449,7 @@ notation) .BR *array . .PP Trace the system calls executed by -.IR ls (1) +.IM ls (1) (neither does this one): .IP .EX @@ -503,8 +503,8 @@ acid: cont() .SH SOURCE .B \*9/src/cmd/acid .SH "SEE ALSO" -.IR mk (1), -.IR db (1) +.IM mk (1) , +.IM db (1) .br Phil Winterbottom, ``Acid Manual''. blob - f21566f913a17fa06476fd9195ba4eefd5446510 blob + a631d3c376f5f42f90ec3128d2c625ddd0838f6f --- man/man1/acme.1 +++ man/man1/acme.1 @@ -45,7 +45,7 @@ The interactive interface uses the keyboard and mouse; use a set of files served by .IR acme ; these are discussed in -.IR acme (4). +.IM acme (4) . .PP Any named .I files @@ -86,7 +86,7 @@ The option instructs .I acme to use FUSE (see -.IR 9pfuse (4)) +.IM 9pfuse (4) ) to mount itself at .IR mtpt . (Experimental.) @@ -98,10 +98,10 @@ windows are in two parts: a one-line above a multi-line .IR body . The body typically contains an image of a file, as in -.IR sam (1), +.IM sam (1) , or the output of a program, as in an -.IR rio (1) +.IM rio (1) window. The tag contains a number of blank-separated words, followed by a vertical bar character, followed by anything. @@ -118,9 +118,9 @@ a slash. .SS Scrolling Each window has a scroll bar to the left of the body. The scroll bar behaves much as in -.IR sam (1) +.IM sam (1) or -.IR rio (1) +.IM rio (1) except that scrolling occurs when the button is pressed, rather than released, and continues as long as the mouse button is held down in the scroll bar. @@ -131,7 +131,7 @@ down the scroll bar speeds up the rate of scrolling. .B -r reverses the scrolling behavior of buttons 1 and 3, to behave more like -.IR xterm (1).) +.IM xterm (1) .) .SS Layout .I Acme windows are arranged in columns. By default, it creates two columns when starting; @@ -164,7 +164,7 @@ pre-loads them with useful commands. Also, the tag across the top maintains a list of executing long-running commands. .SS Typing The behavior of typed text is similar to that in -.IR rio (1) +.IM rio (1) except that the characters are delivered to the tag or body under the mouse; there is no `click to type'. (The experimental option @@ -172,7 +172,7 @@ except that the characters are delivered to the tag or causes typing to go to the most recently clicked-at or made window.) The usual backspacing conventions apply. As in -.IR sam (1) +.IM sam (1) but not .IR rio , the ESC key selects the text typed since the last mouse action, @@ -249,7 +249,7 @@ is identified by the context of the command. These error windows are created when needed. .SS "Mouse button 1 Mouse button 1 selects text just as in -.IR sam (1) +.IM sam (1) or .IR rio (1) , including the usual double-clicking conventions. @@ -305,7 +305,7 @@ by default. .TP .B Edit Treat the argument as a text editing command in the style of -.IR sam (1). +.IM sam (1) . The full .B Sam language is implemented except for the commands @@ -379,7 +379,7 @@ With no arguments, prints the supplementary list. This command is largely superseded by plumbing (see -.IR plumb (7)). +.IM plumb (7) ). .TP .B Indent Set the autoindent mode according to the argument: @@ -507,7 +507,7 @@ If the text indicated with button 2 is not a recognize a shell command. For example, indicating .B date with button 2 runs -.IR date (1). +.IM date (1) . The standard and error outputs of commands are sent to the error window associated with the directory from which the command was run, which will be created if @@ -525,7 +525,7 @@ in a window containing executing .B mk will run -.IR mk (1) +.IM mk (1) in .BR /home/rob/sam , producing output in a window labeled @@ -539,12 +539,12 @@ and .B $winid set to the window's id number (see -.IR acme (4)). +.IM acme (4) ). .PP The environment variable .B $acmeshell determines which shell is used to execute such commands; the -.IR rc (1) +.IM rc (1) shell is used by default. .SS "Mouse button 3 Pointing at text with button 3 instructs @@ -574,7 +574,7 @@ command adds directories to the standard list.) .PP If the text begins with a colon, it is taken to be an address, in the style of -.IR sam (1), +.IM sam (1) , within the body of the window containing the text. The address is evaluated, the resulting text highlighted, and the mouse moved to it. Thus, in @@ -644,7 +644,7 @@ then execute clicking button 1 while 2 is held down. .PP When an external command (e.g. -.IR echo (1)) +.IM echo (1) ) is executed this way, the extra argument is passed as expected and an environment variable .B $acmeaddr @@ -677,7 +677,7 @@ window and runs a (default .BR $SHELL ) in it, turning the window into something analogous to an -.IR 9term (1) +.IM 9term (1) window. Executing text in a .I win @@ -686,7 +686,7 @@ window with button .BR Send . .I Win windows follow the same scrolling heuristic as in -.IR 9term (1): +.IM 9term (1) : the window scrolls on output only if the window is displaying the end of the buffer. .PP .I Awd @@ -774,7 +774,7 @@ MIPS-specific binaries for applications .br .B \*9/bin/awd .SH SEE ALSO -.IR acme (4) +.IM acme (4) .br Rob Pike, .I blob - d5ff0830ec6c631588fa73c59cfe8ca2e2f55bf0 blob + 52e6d60b8f5b6fb018f4e8f9f4131b734d596fe0 --- man/man1/acmeevent.1 +++ man/man1/acmeevent.1 @@ -61,7 +61,7 @@ acmeevent, acme.rc \- shell script support for acme cl and .I acme.rc make it easy to write simple -.IR acme (1) +.IM acme (1) client programs as shell scripts. .PP .I Acme @@ -69,14 +69,14 @@ clients read the .B event files (see -.IR acme (4)) +.IM acme (4) ) for the windows they control, reacting to the events. The events are presented in a format that is easy to read with C programs but hard to read with shell scripts. .PP .I Acmeevent reads an -.IR acme (4) +.IM acme (4) event stream from standard input, printing a shell-friendly version of the events, one per line, on standard output. Each output line from @@ -165,7 +165,7 @@ above); below). .I Flag remains from the -.IR acme (4) +.IM acme (4) event format. Because .IR eq0 , @@ -174,7 +174,7 @@ and .I chordarg are explicit in each event (unlike in -.IR acme (4) +.IM acme (4) events), .I flag can usually be ignored. @@ -221,7 +221,7 @@ window. .PP .I Acme.rc is a library of -.IR rc (1) +.IM rc (1) shell functions useful for writing acme clients. .PP .I Newwindow @@ -259,14 +259,14 @@ The most commonly-used command is .BR clean , which marks the window as clean. See -.IR acme (4) +.IM acme (4) for a full list of commands. .PP .I Windump sets the window's dump directory and dump command (see -.IR acme (4)). +.IM acme (4) ). If either argument is omitted or is .BR - , that argument is not set. @@ -381,9 +381,9 @@ for the full implementation. .br .B \*9/lib/acme.rc .SH SEE ALSO -.IR acme (1), -.IR acme (4), -.IR rc (1) +.IM acme (1) , +.IM acme (4) , +.IM rc (1) .SH BUGS There is more that could be done to ease the writing of complicated clients. blob - 0857805e9e1c7ae7131fdd6d33fba975241b1507 blob + 611c7c6dd840ac3fa3fd4c81bd2e3e3ddc506d6b --- man/man1/ascii.1 +++ man/man1/ascii.1 @@ -91,7 +91,7 @@ control characters or insert newlines. is similar; it converts between .SM UTF and character values from the Unicode Standard (see -.IR utf (7)). +.IM utf (7) ). If given a range of hexadecimal numbers, .I unicode prints a table of the specified Unicode characters \(em their values and @@ -126,7 +126,7 @@ The file contains a table of characters and descriptions, sorted in hexadecimal order, suitable for -.IR look (1) +.IM look (1) on the lower case .I hex values of characters. @@ -154,7 +154,7 @@ table of characters and descriptions. .br .B \*9/src/cmd/unicode.c .SH "SEE ALSO" -.IR look (1), -.IR tcs (1), -.IR utf (7), -.IR font (7) +.IM look (1) , +.IM tcs (1) , +.IM utf (7) , +.IM font (7) blob - af5e7afa4e664f984d3602f57f2ad3b0a014550b blob + a143f2cf5b75059db434de7501b731c4704e35f2 --- man/man1/astro.1 +++ man/man1/astro.1 @@ -114,7 +114,7 @@ default latitude (N), longitude (W), and elevation (me .SH SOURCE .B \*9/src/cmd/astro .SH SEE ALSO -.IR scat (1) +.IM scat (1) .SH BUGS The .B k blob - 9a933b709ee877fb9a846d41b7dbffe8e9158ca8 blob + da6389bf8148896bcf25de1a9c0ae6344187d37f --- man/man1/awk.1 +++ man/man1/awk.1 @@ -377,7 +377,7 @@ Patterns are arbitrary Boolean combinations of regular expressions and relational expressions. Regular expressions are as in -.IR regexp (7). +.IM regexp (7) . Isolated regular expressions in a pattern apply to the entire line. Regular expressions may also occur in @@ -534,8 +534,8 @@ BEGIN { # Simulate echo(1) .SH SOURCE .B \*9/src/cmd/awk .SH SEE ALSO -.IR sed (1), -.IR regexp (7), +.IM sed (1) , +.IM regexp (7) , .br A. V. Aho, B. W. Kernighan, P. J. Weinberger, .I blob - 571943409974219573793fea8ab07880d25ccfb6 blob + ee314735ca0c32fce2d674d0b0aea693b8c7ce21 --- man/man1/bc.1 +++ man/man1/bc.1 @@ -218,7 +218,7 @@ Assignment to .B scale influences the number of digits to be retained on arithmetic operations in the manner of -.IR dc (1). +.IM dc (1) . Assignments to .B ibase or @@ -235,7 +235,7 @@ empty square brackets must follow the array name. .PP .I Bc is actually a preprocessor for -.IR dc (1), +.IM dc (1) , which it invokes automatically, unless the .B -c (compile only) @@ -273,7 +273,7 @@ mathematical library .B \*9/src/cmd/bc.y .SH "SEE ALSO" .IR dc (1), -.IR hoc (1) +.IM hoc (1) .SH BUGS No .LR && , blob - 36bcd8d05f09dca67f9b390283299b5353747eda blob + b954fdb122a2619e0e367ab0d0453e3edae9051e --- man/man1/bundle.1 +++ man/man1/bundle.1 @@ -7,20 +7,20 @@ bundle \- collect files for distribution .SH DESCRIPTION .I Bundle writes on its standard output a shell script for -.IR rc (1) +.IM rc (1) or a Bourne shell which, when executed, will recreate the original .IR files . Its main use is for distributing small numbers of text files by -.IR mail (1). +.IM mail (1) . .PP Although less refined than standard archives from .I 9ar (see -.IR 9c (1)) +.IM 9c (1) ) or -.IR tar (1), +.IM tar (1) , a .IR bundle file @@ -49,7 +49,7 @@ cd gift; sh horse; mk (in .IR 9c (1)), .IR tar (1), -.IR mail (1) +.IM mail (1) .SH BUGS .I Bundle will not create directories and is unsatisfactory for non-text files. blob - 14c6f911c95de3ef066d39a8789356b89bda07af blob + 5c3b2760c707304c2a44f14b18bb03a0957ebc33 --- man/man1/calendar.1 +++ man/man1/calendar.1 @@ -43,7 +43,7 @@ processing at the end of the week. On Friday and Saturday, events through Monday are printed. .PP To have your calendar mailed to you every day, use -.IR cron (8). +.IM cron (8) . .SH FILES .TF $HOME/lib/calendar .TP blob - 0738206aa43a1c8f8585b65dbb148d13455dd8e0 blob + d44817927d711e54d347ea9d7ca97fef822d1809 --- man/man1/cat.1 +++ man/man1/cat.1 @@ -51,7 +51,7 @@ copies to standard output exactly one line from the na .IR file , default standard input. It is useful in interactive -.IR rc (1) +.IM rc (1) scripts. .PP The @@ -76,11 +76,11 @@ characters and the characters that precede them. It is useful to use as .B $PAGER with the Unix version of -.IR man (1) +.IM man (1) when run inside a .I win (see -.IR acme (1)) +.IM acme (1) ) window. .SH SOURCE .B \*9/src/cmd/cat.c @@ -89,7 +89,7 @@ window. .br .B \*9/bin/nobs .SH SEE ALSO -.IR cp (1) +.IM cp (1) .SH DIAGNOSTICS .I Read exits with status blob - 02ad0baa2d3bcfcd4a52cb7fae7c37725c56378c blob + 50e63f3c87aebb9a62c8406a08f341673a66ec92 --- man/man1/cleanname.1 +++ man/man1/cleanname.1 @@ -29,4 +29,4 @@ before processing. .SH SOURCE .B \*9/src/cmd/cleanname.c .SH SEE ALSO -.IR cleanname (3). +.IM cleanname (3) . blob - 1cdcbcba41cce5d04c7dcbe37aae0329afec4633 blob + 426bb7bc91e61cc50861e7641769449b1035bde1 --- man/man1/col.1 +++ man/man1/col.1 @@ -14,11 +14,11 @@ and half line feeds (ESC-9 and ESC-8) as produced by .I nroff for .2C in -.IR ms (7) +.IM ms (7) or -.IR man (7) +.IM man (7) and for -.IR tbl (1). +.IM tbl (1) . .I Col is a pure filter. It normally emits only full line feeds; @@ -47,7 +47,7 @@ paginate the output. .SH SOURCE .B \*9/src/cmd/col.c .SH SEE ALSO -.IR pr (1) +.IM pr (1) .SH BUGS .I Col can't back up more than 128 lines or blob - 9e850621a6cf445f21bde62a30cfd735fc368f8d blob + 27b439e915b6ed58e2a926dd46048567c2e0d5f5 --- man/man1/colors.1 +++ man/man1/colors.1 @@ -17,13 +17,13 @@ colors, cmapcube \- display color map .I Colors presents a grid showing the colors in the RGBV color map (see -.IR color (7)). +.IM color (7) ). .PP Clicking mouse button 1 over a color in the grid will display the map index for that color, its red, green, and blue components, and the 32-bit hexadecimal color value as defined in -.IR allocimage (3). +.IM allocimage (3) . If the .B -x option is specified, the components will also be listed in hexadecimal. @@ -53,4 +53,4 @@ to black or white. .SH SOURCE .B \*9/src/cmd/draw/colors.c .SH SEE ALSO -.IR color (7) +.IM color (7) blob - 1e5d24dc5c1f383ec993cb1d7701efb4cb3a4c75 blob + afb2dc257014dab313bfc486e1d3ca84d344f1d4 --- man/man1/comm.1 +++ man/man1/comm.1 @@ -41,7 +41,7 @@ Print lines common to two sorted files. .SH SOURCE .B \*9/src/cmd/comm.c .SH "SEE ALSO" -.IR sort (1), +.IM sort (1) , .IR cmp (1), .IR diff (1), -.IR uniq (1) +.IM uniq (1) blob - 51d235fbdcb73861cd14a96ae7a977ac1244f648 blob + e19c7520d1bb76f9b9143364ce402c771e5aee42 --- man/man1/core.1 +++ man/man1/core.1 @@ -35,7 +35,7 @@ The command, if run, prints a stack trace of the executing thread at the time of the core dump; see -.IR db (1). +.IM db (1) . .PP If no arguments are given, .I core @@ -50,6 +50,6 @@ searches the current directory. .SH SOURCE .B \*9/src/cmd/core.c .SH "SEE ALSO -.IR acid (1), -.IR db (1), -.IR core (5) +.IM acid (1) , +.IM db (1) , +.IM core (5) blob - 1df8bf91e4ebd0aa5c470288b9dea1bdfd2e1874 blob + a1cd59255fe446329dc81c9f03995a6239c3182b --- man/man1/crop.1 +++ man/man1/crop.1 @@ -53,9 +53,9 @@ crop, iconv \- frame, crop, and convert image .SH DESCRIPTION .I Crop reads an -.IR image (7) +.IM image (7) file (default standard input), crops it, and writes it as a compressed -.IR image (7) +.IM image (7) file to standard output. There are two ways to specify a crop, by color value or by geometry. They may be combined in a single run of @@ -65,7 +65,7 @@ in which case the color value crop will be done first. The .B -c option takes a red-green-blue triplet as described in -.IR color (3). +.IM color (3) . (For example, white is .B 255 @@ -118,7 +118,7 @@ changes the format of pixels in the image Pixels in the image are converted according to the channel descriptor .IR chandesc , (see -.IR image (7)). +.IM image (7) ). For example, to convert a 4-bit-per-pixel grey-scale image to an 8-bit-per-pixel color-mapped image, .I chandesc @@ -139,8 +139,8 @@ crop -c 255 255 255 -i -10 -b 255 150 150 imagefile > .SH SOURCE .B \*9/src/cmd/draw/crop.c .SH SEE ALSO -.IR image (7), -.IR color (3) +.IM image (7) , +.IM color (3) .SH BUGS .I Iconv should be able to do Floyd-Steinberg error diffusion or dithering blob - 10db8dfe8d7a894ba51ae9b8da645e97dbb0558c blob + b5ad47818612880038419acf3d284ebb90292744 --- man/man1/date.1 +++ man/man1/date.1 @@ -28,7 +28,7 @@ epoch, 00:00:00 GMT, January 1, 1970. The conversion from Greenwich Mean Time to local time depends on the .B $timezone environment variable; see -.IR ctime (3). +.IM ctime (3) . .PP If the optional argument .I seconds blob - 03355508c7bbb4f537291faa8c8330b6645e99d4 blob + c87ea4a30274099d83c74c7d96634b284861c75b --- man/man1/db.1 +++ man/man1/db.1 @@ -45,11 +45,11 @@ specifies the memory image of a process. A .I pid gives the id of an executing process to be accessed via -.IR ptrace (2). +.IM ptrace (2) . A .I corefile specifies the name of a core dump (see -.IR core (5) +.IM core (5) on your system of choice) containing the memory image of a terminated process. This manual refers to the memory image specified by @@ -628,7 +628,7 @@ Dot is assigned to the variable or register named. .TP .B ! The rest of the line is passed to -.IR rc (1) +.IM rc (1) for execution. .TP .BI $ modifier @@ -969,8 +969,8 @@ is one the breakpoint will fire. Beware that local variables may be stored in registers; see the BUGS section. .SH "SEE ALSO" -.IR acid (1), -.IR core (1) +.IM acid (1) , +.IM core (1) .SH SOURCE .B \*9/src/cmd/db .SH DIAGNOSTICS blob - 5394580a4e286f517f70ed1a55f73a8afd0fc37b blob + ad5cf310692a3f8a95431723fb2408726be0b913 --- man/man1/dc.1 +++ man/man1/dc.1 @@ -235,8 +235,8 @@ lyx .SH SOURCE .B \*9/src/cmd/dc.c .SH "SEE ALSO" -.IR bc (1), -.IR hoc (1) +.IM bc (1) , +.IM hoc (1) .SH DIAGNOSTICS .I x .LR "is unimplemented" , blob - 63b35e145bd180390c6a09206e47a6a17d1cf976 blob + 948e80cb4855f1f08e571431746c05fac685ce6e --- man/man1/dd.1 +++ man/man1/dd.1 @@ -191,7 +191,7 @@ options become a simple file copy. .SH SOURCE .B \*9/src/cmd/dd.c .SH "SEE ALSO" -.IR cp (1) +.IM cp (1) .SH DIAGNOSTICS .I Dd reports the number of full + partial input and output blob - 9d159f9e422582ee48e664dcb3ecaa793fc3a9c5 blob + 90fba52d527453cf3a38e2db3e722baf1dafa8e8 --- man/man1/deroff.1 +++ man/man1/deroff.1 @@ -16,13 +16,13 @@ reads each file in sequence and removes all .I nroff and -.IR troff (1) +.IM troff (1) requests and non-text arguments, backslash constructions, and constructs of preprocessors such as -.IR eqn (1), -.IR pic (1), +.IM eqn (1) , +.IM pic (1) , and -.IR tbl (1). +.IM tbl (1) . Remaining text is written on the standard output. .I Deroff follows files included by @@ -67,7 +67,7 @@ requests. Remove titles, attachments, etc., as well as ordinary .IR troff constructs, from -.IR ms (7) +.IM ms (7) or .I mm documents. @@ -84,7 +84,7 @@ does for and .I latex (see -.IR tex (1)) +.IM tex (1) ) files what .B deroff -wi does for @@ -96,8 +96,8 @@ files. .B \*9/src/cmd/delatex.lx .SH "SEE ALSO" .IR troff (1), -.IR tex (1), -.IR spell (1) +.IM tex (1) , +.IM spell (1) .SH BUGS These filters are not complete interpreters of .I troff blob - 009f5a94d5ab328b09c37b3cccc5f6df5fcb3013 blob + eda04893bcfb07335c3ed462d34823da8bc09d8c --- man/man1/devdraw.1 +++ man/man1/devdraw.1 @@ -5,7 +5,7 @@ devdraw \- draw device simulator invoked via .I initdraw (see -.IR graphics (3)) +.IM graphics (3) ) .SH DESCRIPTION .I Devdraw serves a custom graphics protocol and is the only program @@ -20,9 +20,9 @@ to use all available physical pixels on a retina displ .SH SOURCE .B \*9/src/cmd/devdraw .SH "SEE ALSO -.IR draw (3), -.IR drawfcall (3), -.IR graphics (3) +.IM draw (3) , +.IM drawfcall (3) , +.IM graphics (3) .SH BUGS .I Devdraw should probably present a standard 9P server blob - 7fc50bcdbf9ddb2a00a06215c28d946d892b23b5 blob + a27c2026b3c50a54c80e7705b84d2ab24714a216 --- man/man1/dial.1 +++ man/man1/dial.1 @@ -12,7 +12,7 @@ dial \- connect to a remote service connects to the network address .I addr (see -.IR dial (3)) +.IM dial (3) ) and then copies data from the connection to standard output, and from standard input to the connection. .PP @@ -27,4 +27,4 @@ to exit only in response to end of file on the network .SH SOURCE .B \*9/src/cmd/dial.c .SH SEE ALSO -.IR dial (3) +.IM dial (3) blob - d382acc4763660adbf6988eaf2f55b55679e3a9c blob + 209aca4103ebe4d85d273f5976c5197e0083039b --- man/man1/dict.1 +++ man/man1/dict.1 @@ -53,7 +53,7 @@ Print a pronunciation key. .PD .PP Patterns are regular expressions (see -.IR regexp (7)), +.IM regexp (7) ), with an implicit leading .L ^ and trailing @@ -154,7 +154,7 @@ searches for dictionaries in the directory named by .PP .I Adict is a dictionary browser for -.IR acme (1). +.IM acme (1) . When run with no arguments, it creates a new .I acme window named @@ -193,7 +193,7 @@ window. dictionaries .PD .SH "SEE ALSO" -.IR regexp (7) +.IM regexp (7) .SH SOURCE .B \*9/src/cmd/dict .br blob - fd42643d39258a86b457995ad98f18740dc28336 blob + cffbf0b650e1621b95e8a2b40828fe669eadfbdc --- man/man1/diff.1 +++ man/man1/diff.1 @@ -19,7 +19,7 @@ two directories are compared by the method of .I diff for text files and -.IR cmp (1) +.IM cmp (1) otherwise. If more than two file names are given, then each argument is compared to the last argument as above. @@ -140,9 +140,9 @@ differences. .SH SOURCE .B \*9/src/cmd/diff .SH "SEE ALSO" -.IR cmp (1), -.IR comm (1), -.IR ed (1) +.IM cmp (1) , +.IM comm (1) , +.IM ed (1) .SH DIAGNOSTICS Exit status is the empty string for no differences, blob - da33653aae8e572172a62a136e2ed870c1640428 blob + fb9d3b055159f839c6a77ce863b323da5c6bec80 --- man/man1/doctype.1 +++ man/man1/doctype.1 @@ -17,16 +17,16 @@ doctype \- intuit command line for formatting a docume .SH DESCRIPTION .I Doctype examines a -.IR troff (1) +.IM troff (1) input file to deduce the appropriate text formatting command and prints it on standard output. .I Doctype recognizes input for -.IR troff (1), +.IM troff (1) , related preprocessors like -.IR eqn (1), +.IM eqn (1) , and the -.IR ms (7) +.IM ms (7) and .I mm macro packages. @@ -56,8 +56,8 @@ Typeset files named .IR eqn (1), .IR tbl (1), .IR pic (1), -.IR grap (1), -.IR ms (7), -.IR man (7) +.IM grap (1) , +.IM ms (7) , +.IM man (7) .SH BUGS In true A.I. style, its best guesses are inspired rather than accurate. blob - 41071c7eabd0105359d1317fa9206c89c2f680aa blob + 64bf4860b705328854ddf651953d34dd81a8f564 --- man/man1/ed.1 +++ man/man1/ed.1 @@ -96,7 +96,7 @@ beginning of a line. supports the .I "regular expression" notation described in -.IR regexp (7). +.IM regexp (7) . Regular expressions are used in addresses to specify lines and in one command (see @@ -641,7 +641,7 @@ Dot is unchanged. Send the remainder of the line after the .L ! to -.IR rc (1) +.IM rc (1) to be interpreted as a command. Dot is unchanged. .TP @@ -679,9 +679,9 @@ and all characters after the last newline. .SH SOURCE .B \*9/src/cmd/ed.c .SH "SEE ALSO" -.IR sam (1), -.IR sed (1), -.IR regexp (7) +.IM sam (1) , +.IM sed (1) , +.IM regexp (7) .SH DIAGNOSTICS .BI ? name for inaccessible file; blob - bf4bac68f7c57b64515ed3b48583b94763347c07 blob + 723b2dc34db28f3e46cb982de93cb4c0426c60a1 --- man/man1/eqn.1 +++ man/man1/eqn.1 @@ -15,7 +15,7 @@ eqn \- typeset mathematics .SH DESCRIPTION .I Eqn is a -.IR troff (1) +.IM troff (1) preprocessor for typesetting mathematics on a typesetter. @@ -34,7 +34,7 @@ named in the option (default .BR -Tutf ; see -.IR troff (1)). +.IM troff (1) ). When run with other preprocessor filters, .I eqn usually comes last. @@ -299,7 +299,7 @@ Mathematical words like .LR cos , .L log are made Roman automatically. -.IR Troff (1) +.IM Troff (1) four-character escapes like .L \e(lh (\(lh) can be used anywhere. @@ -319,7 +319,7 @@ font descriptions for PostScript .B \*9/src/cmd/eqn .SH "SEE ALSO" .IR troff (1), -.IR tbl (1) +.IM tbl (1) .br J. F. Ossanna and B. W. Kernighan, ``Troff User's Manual''. blob - cbbd4152e91eb8e5b3821397512135a4d4bb138b blob + 3c9c0fac46d360a11ad32c459ce1d3ce34acc0ad --- man/man1/freq.1 +++ man/man1/freq.1 @@ -36,5 +36,5 @@ character, respectively. .SH SOURCE .B \*9/src/cmd/freq.c .SH SEE ALSO -.IR utf (7), -.IR wc (1) +.IM utf (7) , +.IM wc (1) blob - 9b29b5121a36e988eefa73c3a8ff65c73144a741 blob + 2583141c485efd6a43b1aa20b080bdaa948f2158 --- man/man1/git.1 +++ man/man1/git.1 @@ -1,5 +1,5 @@ .TH GIT 1 -.SH NAME +.SH NAME git, hg, cvs, codereview \- introduction to using plan9port Git repository .SH SYNOPSIS .B git @@ -17,7 +17,7 @@ git, hg, cvs, codereview \- introduction to using plan .I path ... ] .PP -.B gitk +.B gitk .PP .B web .B https://9fans.github.io/plan9port @@ -37,13 +37,13 @@ which it will create. After .B git .BR clone , -the other commands listed +the other commands listed should be run within the .B plan9 directory tree. .PP Git downloads the entire revision history -of Plan 9 from User Space +of Plan 9 from User Space in addition to the current tree. .PP .I Git @@ -55,7 +55,7 @@ current file tree. .I Git .I diff runs Unix's -.IR diff (1) +.IM diff (1) to compare the files in the local tree with the corresponding files in the revision history. The special revision @@ -76,7 +76,7 @@ directory containing Git local repository list of files and wildcards to exclude from Git operations .SH SEE ALSO Unix's -\fIgit\fR(1), +.IR git (1), .HR http://git-scm.com/doc .PP .HR https://9fans.github.io/plan9port/ blob - beda727df4a724ddc6e75675c2b7840ef2c25f09 blob + 40effe1272d69d7ee13507949405487c7eceb679 --- man/man1/grap.1 +++ man/man1/grap.1 @@ -9,7 +9,7 @@ grap \- pic preprocessor for drawing graphs .SH DESCRIPTION .I Grap is a -.IR pic (1) +.IM pic (1) preprocessor for drawing graphs on a typesetter. Graphs are surrounded by the .I troff @@ -407,7 +407,7 @@ definitions of standard plotting characters, e.g., bul .B \*9/src/cmd/grap .SH "SEE ALSO" .IR pic (1), -.IR troff (1) +.IM troff (1) .br J. L. Bentley and B. W. Kernighan, ``GRAP\(emA Language for Typesetting Graphs'', blob - bb6d25da9a974828ec4c5b1587233825f45dc3bd blob + 4f1fbed18f4f936a7c960d5db07d2107c821428f --- 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 (7). +.IM plot (7) . Successive curves will cycle through the colors in the given order. .TP .B -s @@ -145,7 +145,7 @@ is reversed. .B \*9/src/cmd/graph .SH "SEE ALSO" .IR plot (1), -.IR grap (1) +.IM grap (1) .SH BUGS Segments that run out of bounds are dropped, not windowed. Logarithmic axes may not be reversed. blob - 2389062187f3daf3bc415984ddcc1d4df9817cd4 blob + 18632766b67a2b4a16eb183e540656ac09a6df88 --- man/man1/grep.1 +++ man/man1/grep.1 @@ -27,7 +27,7 @@ searches the input for lines that match the .IR pattern , a regular expression as defined in -.IR regexp (7) +.IM regexp (7) with the addition of a newline character as an alternative (substitute for .BR | ) @@ -114,11 +114,11 @@ If no files are listed, it searches all files matching .br .B \*9/bin/g .SH SEE ALSO -.IR ed (1), -.IR awk (1), -.IR sed (1), -.IR sam (1), -.IR regexp (7) +.IM ed (1) , +.IM awk (1) , +.IM sed (1) , +.IM sam (1) , +.IM regexp (7) .SH DIAGNOSTICS Exit status is null if any lines are selected, or non-null when no lines are selected or an error occurs. blob - 6b0be4c7a919aa14511542d55af43e6c714a4b68 blob + 153299659440cea93a1ad8ac34c7ad07477d6d64 --- man/man1/gview.1 +++ man/man1/gview.1 @@ -144,7 +144,7 @@ awk 'BEGIN{for(x=.1;x<500;x+=.1)print x,sin(x)/x}' | g .SH SOURCE .B \*9/src/cmd/draw/gview.c .SH SEE ALSO -.IR awk (1) +.IM awk (1) .SH BUGS The user interface for the .I slant blob - 683ba3a5599984a3f716f563efd91739c419ebd3 blob + 593b713faa51636512f91be39db71f1e6f4825b4 --- man/man1/gzip.1 +++ man/man1/gzip.1 @@ -150,8 +150,8 @@ Produce debugging output. .br .B \*9/src/cmd/bzip2 .SH SEE ALSO -.IR tar (1), -.IR compress (1) +.IM tar (1) , +.IM compress (1) .SH BUGS .I Unzip can only extract files which are uncompressed or compressed blob - 82175e7e1868dacda36dde51007edd124e6966fc blob + 41a2b402cc8caba80cfdc09f369984628a8e0e0b --- man/man1/hist.1 +++ man/man1/hist.1 @@ -41,7 +41,7 @@ option enables verbose debugging printout. The .B -d option causes -.IR diff (1) +.IM diff (1) .B -c to be run for each adjacent pair of dump files, while .B -b @@ -73,11 +73,11 @@ by convention, root of dump file system .SH SOURCE .B \*9/src/cmd/hist.c .SH SEE ALSO -.IR yesterday (1), -.IR vbackup (8) +.IM yesterday (1) , +.IM vbackup (8) .SH BUGS Should be called .IR history , but that name is taken by -.IR sh (1). +.IM sh (1) . blob - f73ec8a8b2f4e491c821cc22fe441564cc6761d3 blob + 561752008b833f98f8fc72f9ddfc8158f1299d16 --- man/man1/hoc.1 +++ man/man1/hoc.1 @@ -133,8 +133,8 @@ for(i=1; i<12; i++) print gcd(i,12) .SH SOURCE .B \*9/src/cmd/hoc .SH "SEE ALSO" -.IR bc (1), -.IR dc (1) +.IM bc (1) , +.IM dc (1) .br B. W. Kernighan and R. Pike, .I blob - 4dff65c84cd53699c0747872358c4a6667f512f9 blob + 28d243c77a577b4d041f136f2521606543b75933 --- man/man1/htmlroff.1 +++ man/man1/htmlroff.1 @@ -21,7 +21,7 @@ htmlroff \- HTML formatting and typesetting .SH DESCRIPTION .I Htmlroff accepts -.IR troff (1) +.IM troff (1) input in the named .I files and formats it as HTML for viewing in a web browser. @@ -63,7 +63,7 @@ HTML entity sequences and so on). .I Htmlroff invokes -.IR tcs (1) +.IM tcs (1) for the conversion. .TP .B -v @@ -73,7 +73,7 @@ Generate debugging output and warnings about suspiciou Most .I troff input files, especially those using the -.IR ms (7) +.IM ms (7) macros, can be used unaltered. In general, the macro file .B tmac.html @@ -83,10 +83,10 @@ as in .B -ms .BR -mhtml . .PP -.IR Htmlroff (7) +.IM Htmlroff (7) describes the changes to the input language. .PP -.IR Mhtml (7) +.IM Mhtml (7) describes the new macros. .SH EXAMPLES Format the Plan 9 web page: @@ -113,7 +113,7 @@ to Unicode characters like α. .SH SOURCE .B \*9/src/cmd/htmlroff .SH "SEE ALSO -.IR tcs (1), -.IR troff (1), -.IR htmlroff (7), -.IR mhtml (7) +.IM tcs (1) , +.IM troff (1) , +.IM htmlroff (7) , +.IM mhtml (7) blob - e8d37615ddbe86ae14bdb0f5b5b22d0cfdad0631 blob + c0ffebcfe7f5e24605359c37ee56f25137658edd --- man/man1/idiff.1 +++ man/man1/idiff.1 @@ -50,7 +50,7 @@ and prompt again. .PP .I Idiff invokes -.IR diff (1) +.IM diff (1) to compare the files. The .B -b @@ -66,7 +66,7 @@ passed to .SH SOURCE .B \*9/src/cmd/idiff.c .SH "SEE ALSO -.IR diff (1) +.IM diff (1) .br Kernighan and Pike, .IR "The Unix Programming Environment" , blob - 17411af26752688ab074c31466da68b293f83dc1 blob + 6097f4358ecd20e7c7e91de948dd5adedf82bbaa --- man/man1/install.1 +++ man/man1/install.1 @@ -15,7 +15,7 @@ cd \*9; ./INSTALL .SH DESCRIPTION To obtain the Plan 9 tree, use Git (see -.IR git (1)) +.IM git (1) ) or download a tar file from .HR https://9fans.github.io/plan9port "" . .PP @@ -25,7 +25,7 @@ usual place is In the root of the tree, run .BR ./INSTALL . This script builds the Plan 9 build program -.IR mk (1) +.IM mk (1) if necessary, cleans all previously built object files and libraries out of the tree, rebuilds and installs everything, and then cleans up. @@ -109,7 +109,7 @@ can safely be repeated to rebuild the system from scra .PP Once the system is built for the first time, it can be maintained and rebuilt using -.IR mk (1). +.IM mk (1) . To rebuild individual commands or libraries, run .B mk @@ -119,7 +119,7 @@ and .B clean in the appropriate source directory (see -.IR src (1)). +.IM src (1) ). .SH FILES .TP .B \*9/lib/moveplan9.files @@ -132,7 +132,7 @@ the script that edits the files .TP .B \*9/src/mkmk.sh the shell script used to build -.IR mk (1) +.IM mk (1) .TP .B \*9/dist/manweb the shell script that builds the HTML manual @@ -148,5 +148,5 @@ logged output from the last run of a summary of .B install.log .SH SEE ALSO -.IR intro (1), -.IR git (1) +.IM intro (1) , +.IM git (1) blob - 1c0ec9f9cc4f53535af8a7b62e0462f352c89f07 blob + 13741be362d30d4d30b67db21a80c268f1936420 --- man/man1/join.1 +++ man/man1/join.1 @@ -114,7 +114,7 @@ birthdays empty. The layout of .B /adm/users is given in -.IR passwd (5); +.IM passwd (5) ; .B bdays contains sorted lines like .LR "ken:Feb\ 4,\ 1953" . @@ -132,7 +132,7 @@ Print all pairs of users with identical userids. .SH "SEE ALSO" .IR sort (1), .IR comm (1), -.IR awk (1) +.IM awk (1) .SH BUGS With default field separation, the collating sequence is that of blob - a59033b6b1c95957a972ed46de463209c6789189 blob + bdc9110bcf0aa2bb4499b1ad3c137303c740b076 --- man/man1/jpg.1 +++ man/man1/jpg.1 @@ -122,7 +122,7 @@ Typing a .BR q , DEL, or control-D exits the program. For a more user-friendly interface, use -.IR page (1), +.IM page (1) , which invokes these programs to convert the images to standard format, displays them, and offers scrolling, panning, and menu-driven navigation among the files. .PP @@ -147,7 +147,7 @@ any of the following options: .TP .B -c Convert the image to a Plan 9 representation, as defined by -.IR image (7), +.IM image (7) , and write it to standard output. .TP .B -9 @@ -156,7 +156,7 @@ Like but produce an uncompressed image. This saves processing time, particularly when the output is being piped to another program such as -.IR page (1), +.IM page (1) , since it avoids compression and decompression. .TP .B -t @@ -235,8 +235,8 @@ space in the image. The icon file is written to stand .SH SOURCE .B \*9/src/cmd/jpg .SH "SEE ALSO" -.IR page (1), -.IR image (7). +.IM page (1) , +.IM image (7) . .SH BUGS Writing an animated GIF using .I togif blob - 5b61d8a10937196a1614ccd68b9ffef19ee75f65 blob + ee311017c005fd1d120441ffa8445c06caeb2268 --- man/man1/kill.1 +++ man/man1/kill.1 @@ -19,18 +19,18 @@ prints commands that will cause all processes with .I name and owned by the current user to be terminated. Each command is commented with an output line from -.IR ps (1) +.IM ps (1) describing the process that would be killed. Use the .B send command of -.IR 9term (1), +.IM 9term (1) , or pipe the output of .I kill into -.IR rc (1) +.IM rc (1) or -.IR sh (1) +.IM sh (1) to execute the commands. .PP .I Kill @@ -60,8 +60,8 @@ signal. .SH SOURCE .B \*9/bin .SH "SEE ALSO" -.IR ps (1), -.IR notify (3) +.IM ps (1) , +.IM notify (3) .SH BUGS .I Stop and blob - 1748b0be9960c749e0789f1ae07336776a8b2bc5 blob + 92334f19782fee47c3e2941e6061282129c5d63a --- man/man1/label.1 +++ man/man1/label.1 @@ -14,12 +14,12 @@ label, awd \- set window label sets the label of the current .I win (see -.IR acme (1)) +.IM acme (1) ) or X terminal window .RI ( e.g., -.IR 9term (1) +.IM 9term (1) or -.IR xterm (1)) +.IM xterm (1) ) by echoing a special control sequence to standard output. .PP .I Acme @@ -38,7 +38,7 @@ sets the window name to the current directory with a suffix, using the name of the current system by default. .SH EXAMPLE One can use the following -.IR sh (1) +.IM sh (1) function to keep the label up-to-date in response to .I cd commands: @@ -55,7 +55,7 @@ alias cd=_cd cd . .EE .PP -.IR Rc (1) +.IM Rc (1) installs a similar .B fn .B cd @@ -77,4 +77,4 @@ fn cd { .SH BUGS .I Awd is also documented in -.IR acme (1). +.IM acme (1) . blob - 6955e7914a9d1fae8d1ddc361912adc78e0ba59a blob + fe99bd6c8ebe40c8606113e403f38fb473428bc3 --- man/man1/lex.1 +++ man/man1/lex.1 @@ -65,7 +65,7 @@ output template .SH "SEE ALSO" .IR yacc (1), -.IR sed (1) +.IM sed (1) .br M. E. Lesk and E. Schmidt, `LEX\(emLexical Analyzer Generator', blob - 02d2cb4b361b452e910461fd90461f00dbb86c3e blob + 20f46a9621882430b1289ee1e1459575aec80b11 --- man/man1/look.1 +++ man/man1/look.1 @@ -74,7 +74,7 @@ is assumed, with collating sequence .B \*9/src/cmd/look.c .SH "SEE ALSO" .IR sort (1), -.IR grep (1) +.IM grep (1) .SH DIAGNOSTICS The exit status is .RB `` "not found" '' blob - edaf11cfb7af974847ac1b5c4bfb3c544cba43cf blob + b4a5f77278faf6536dd6c25f20bb86b22bbad7e3 --- man/man1/ls.1 +++ man/man1/ls.1 @@ -29,7 +29,7 @@ is the same as but sets the .B -p option and pipes the output through -.IR mc (1). +.IM mc (1) . .PP There are a number of options: .TP @@ -42,7 +42,7 @@ List in long format, giving mode (see below), file sys (e.g., for devices, the .B # code letter that names it; see -.IR intro (3)), +.IM intro (3) ), the instance or subdevice number, owner, group, size in bytes, and time of last modification for each file. @@ -60,7 +60,7 @@ Print only the final path element of each file name. List the .I qid (see -.IR stat (3)) +.IM stat (3) ) of each file; the printed fields are in the order path, version, and type. .TP @@ -99,7 +99,7 @@ otherwise. .TP .B -Q By default, printed file names are quoted if they contain characters special to -.IR rc (1). +.IM rc (1) . The .B -Q flag disables this behavior. @@ -168,5 +168,5 @@ if none of the above permissions is granted. .br .B \*9/bin/lc .SH SEE ALSO -.IR stat (3), -.IR mc (1) +.IM stat (3) , +.IM mc (1) blob - ec35b7ad1b400be64bd2912917fd1200708ebf0c blob + cdab681ad7698e712c29d7c5598b850fe05b864f --- man/man1/man.1 +++ man/man1/man.1 @@ -45,7 +45,7 @@ The options are: .TP .B -h Print the pages to HTML and send to a web browser with -.IR web (1). +.IM web (1) . .TP .B -n (Default) @@ -54,17 +54,17 @@ Print the pages on the standard output using .TP .B -p Run -.IR proof (1) +.IM proof (1) on the specified man pages. .TP .B -P Run -.IR page (1) +.IM page (1) on the specified man pages. .TP .B -t Run -.IR troff (1) +.IM troff (1) and send its output to standard output. .TP @@ -106,8 +106,8 @@ index for .br .B \*9/bin/lookman .SH "SEE ALSO" -.IR page (1), -.IR proof (1) +.IM page (1) , +.IM proof (1) .SH BUGS The manual was intended to be typeset; some detail is sacrificed on text terminals. .PP blob - c0320021572208b924696fce452c70ed2b5291a8 blob + e5c25304136daeb3000b00c4dad70a019176b26e --- man/man1/map.1 +++ man/man1/map.1 @@ -305,7 +305,7 @@ tracks appear as dot-dashed lines if the plotting filt The .I file contains -.IR plot (7)-style +.IM plot (7) -style data for .L : or @@ -640,7 +640,7 @@ Map driver program .B \*9/src/cmd/map .SH "SEE ALSO" .IR map (7), -.IR plot (1) +.IM plot (1) .SH DIAGNOSTICS `Map seems to be empty'\(ema coarse survey found zero extent within the blob - e914cbabf283b8037b5c064f535758be57dbee78 blob + 4727df5fbef0c7a2e49e1b7dae2fe1f1f5d3e28b --- man/man1/mc.1 +++ man/man1/mc.1 @@ -18,10 +18,10 @@ splits the input into as many columns as will fit in .I N print positions. If run in a -.IR 9term (1), -.IR xterm (1), +.IM 9term (1) , +.IM xterm (1) , or -.IR acme (1) +.IM acme (1) window, the default .I N is the number of blanks that will fit across the window; @@ -36,14 +36,14 @@ is printed separately. .SH SOURCE .B \*9/src/cmd/draw/mc.c .SH "SEE ALSO" -.IR 9term (1), -.IR acme (1), -.IR acme (4), -.IR xterm (1), -.IR pr (1), +.IM 9term (1) , +.IM acme (1) , +.IM acme (4) , +.IM xterm (1) , +.IM pr (1) , .I lc in -.IR ls (1) +.IM ls (1) .SH BUGS On systems with high-DPI screens, .I 9term blob - 0698ef5b77d845b4ecded8cd4a27a0673aa8d91c blob + 4b5e94d4c3a9f4ce5aa9ae76a8a0e81e2d47a3c3 --- man/man1/mk.1 +++ man/man1/mk.1 @@ -29,7 +29,7 @@ contains a .I rule for each target that identifies the files and other targets upon which it depends and an -.IR sh (1) +.IM sh (1) script, a .IR recipe , to update the target. @@ -157,7 +157,7 @@ In the recipe of a meta-rule, the environment variable contains the string matched by the .BR % . For example, a meta-rule to compile a C program using -.IR 9c (1) +.IM 9c (1) might be: .IP .EX @@ -207,7 +207,7 @@ References to variables are replaced by the variables' Special characters may be quoted using single quotes .BR \&'' as in -.IR sh (1). +.IM sh (1) . .PP Assignments and rules are distinguished by the first unquoted occurrence of @@ -246,7 +246,7 @@ A legal reference of the form or .B ${name} is expanded as in -.IR sh (1). +.IM sh (1) . A reference of the form .BI ${name: A % B = C\fL%\fID\fL}\fR, where @@ -315,9 +315,9 @@ or .BR rcsh , .I mk uses -.IR rc (1)'s +.IM rc (1) 's quoting rules; otherwise it uses -.IR sh (1)'s. +.IM sh (1) 's. The .B MKSHELL variable is consulted when the mkfile is read, not when it is executed, @@ -523,7 +523,7 @@ of the aggregate Currently, the only aggregates supported are .I 9ar (see -.IR 9c (1)) +.IM 9c (1) ) archives. .SS Attributes The colon separating the target from the prerequisites @@ -567,12 +567,12 @@ In the rule, .B % has no special meaning. The target is interpreted as a regular expression as defined in -.IR regexp (7). +.IM regexp (7) . The prerequisites may contain references to subexpressions in form .BI \e n\f1, as in the substitute command of -.IR sed (1). +.IM sed (1) . .TP .B U The targets are considered to have been updated @@ -625,7 +625,7 @@ Regular expression meta-rules: .EE .PP A correct way to deal with -.IR yacc (1) +.IM yacc (1) grammars. The file .B lex.c @@ -656,8 +656,8 @@ x.tab.h:Pcmp -s: y.tab.h .SH SOURCE .B \*9/src/cmd/mk .SH SEE ALSO -.IR sh (1), -.IR regexp (7) +.IM sh (1) , +.IM regexp (7) .PP A. Hume, ``Mk: a Successor to Make'' blob - 0d655cf01f379653c50c46832bb0161bb2ca1792 blob + 34c21eb833c0e5d38b9b868ac2d5c7a5bd4dd4cc --- man/man1/mk9660.1 +++ man/man1/mk9660.1 @@ -71,11 +71,11 @@ the current directory). The .I proto file is formatted as described in -.IR proto (3). +.IM proto (3) . .PP The created CD image will be in ISO-9660 format, but by default the file names will -be stored in UTF-8 with no imposed length +be stored in UTF-8 with no imposed length or character restrictions. The .B -c @@ -84,7 +84,7 @@ flag causes to use only file names in ``8.3'' form that use digits, letters, and underscore. File names that do not conform are changed -to +to .BI D nnnnnn (for directories) or @@ -122,7 +122,7 @@ and .B \e are allowed in Plan 9 file names but not in Joliet file names; non-conforming file names are translated -and a +and a .B _CONFORM.MAP file written as in the case of the @@ -133,7 +133,7 @@ If the .B -r flag is given, Rock Ridge extensions are written in the format of the system use sharing protocol; -this format provides Posix-style file metadata and is +this format provides Posix-style file metadata and is common on Unix platforms. .PP The options @@ -155,13 +155,13 @@ if unspecified, the base name of .I proto is used. .PP -The +The .B -: -flag causes +flag causes .B mk9660 to replace colons in scanned file names with spaces; this is the inverse of the map applied by Plan 9's -\fIdossrv\fR(4) +.IR dossrv (4) and is useful for writing Joliet CDs containing data from FAT file systems. .PP @@ -189,10 +189,11 @@ on standard error. is similar in specification to .I mk9660 but creates and updates backup CD images in the style of -the +the .I dump file system -(see Plan 9's \fIfs\fR(4)). +(see Plan 9's +.IR fs (4)). The dump is file-based rather than block-based: if a file's contents have not changed since the last backup, only its directory entry will be rewritten. @@ -202,7 +203,7 @@ The option specifies a time (in seconds since January 1, 1970) to be used for naming the dump directory. .PP -The +The .B -m option specifies a maximum size for the image; if a backup would cause the image to grow larger than @@ -212,7 +213,7 @@ it will not be written, and will exit with a non-empty status. .SH EXAMPLE .PP -Create an image of the Plan 9 source tree, +Create an image of the Plan 9 source tree, including a conformant ISO-9660 directory tree, Plan 9 extensions in the system use fields, and a Joliet directory tree. @@ -223,7 +224,7 @@ mk9660 -9cj -s /n/bootes -p srcproto cdimage .SH SOURCE \*9/src/cmd/9660 .SH "SEE ALSO -.IR proto (3) +.IM proto (3) .\" .SH "SEE ALSO" .\" .I 9660srv .\" (in blob - e658847cfb80c4f9f02e736ba9e9cac8ff928bf4 blob + ece75f34705ff4bb3ac35ae432961cf310397f90 --- man/man1/mkdir.1 +++ man/man1/mkdir.1 @@ -28,11 +28,11 @@ The flag sets the permissions to be used when creating the directory. The default is 0777. .SH "SEE ALSO" -.IR rm (1) +.IM rm (1) .br .IR cd in -.IR rc (1) +.IM rc (1) .SH SOURCE .B \*9/src/cmd/mkdir.c .SH DIAGNOSTICS blob - ec9f016e47f16439801c01401baff67539a1f2b8 blob + 51f1c785f35dd02f1484f64fdb3c0c4314a89bb1 --- 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 (1)) +.IM namespace (1) ) or the name or IP address of a machine serving 9P over TCP port 564. .PP @@ -29,7 +29,7 @@ On Linux, .I mount uses the native 9P kernel module when present. Otherwise it tries to use -.IR 9pfuse (4) +.IM 9pfuse (4) with the FUSE file system module. Using the 9P kernel module requires root access. FUSE can often be used by regular users. @@ -45,7 +45,7 @@ should be invoked as .BR mount . .SH EXAMPLES Mount -.IR acme (4) +.IM acme (4) onto .B /mnt/acme : .IP @@ -64,6 +64,6 @@ cat /mnt/plumb/rules .br .B \*9/bin/unmount .SH SEE ALSO -.IR intro (4), +.IM intro (4) , .IR intro (9p), -.IR 9pfuse (4) +.IM 9pfuse (4) blob - e02a65097d8676880c9b0916f714ea6f8898db71 blob + 238877e1aca034eb4bda16862dfde07fe93103fd --- man/man1/namespace.1 +++ man/man1/namespace.1 @@ -7,9 +7,9 @@ namespace \- print name space directory .I Namespace prints the directory representing the current name space. See -.IR intro (4). +.IM intro (4) . .SH SOURCE .B \*9/src/cmd/namespace.c .SH SEE ALSO -.IR getns (3), -.IR intro (4) +.IM getns (3) , +.IM intro (4) blob - b37509c0b225fe4c11adefac3b401fe47fbf8f93 blob + a92b05b1ae32c56263fc26c0f4aec24d2dd85205 --- man/man1/ndb.1 +++ man/man1/ndb.1 @@ -24,9 +24,9 @@ ndbquery, ndbmkhash, ndbmkdb, ndbipquery, ndbmkhosts \ The network database holds administrative information used by .I authdial (see -.IR authsrv (3)) +.IM authsrv (3) ) and -.IR secstored (1). +.IM secstored (1) . .PP .I Ndbquery searches the database for an attribute of type @@ -46,7 +46,7 @@ of all the matched entries is returned. uses .I ndbipinfo (see -.IR ndb (3)) +.IM ndb (3) ) to search for the values of the attributes .I rattr corresponding to the system @@ -382,7 +382,7 @@ and by the ndb library routines. .PP .I Ndbmkdb is used in concert with -.IR awk (1) +.IM awk (1) scripts to convert uucp systems files and IP host files into database files. @@ -395,7 +395,7 @@ it is necessary to run .I ndbmkhash whenever the files are modified. It may be profitable to control this by a frequent -.IR cron (8) +.IM cron (8) job. .PP .I Ndbmkhosts @@ -439,5 +439,5 @@ hash files for .SH SOURCE .B \*9/src/cmd/ndb .SH SEE ALSO -.IR ndb (3), -.IR ndb (7) +.IM ndb (3) , +.IM ndb (7) blob - 69f519b11d872c26db3ab9b5d112a1b446f095c3 blob + 11ab979dcc76b754cba5728f83a960a675fd52e6 --- man/man1/netfiles.1 +++ man/man1/netfiles.1 @@ -21,7 +21,7 @@ Netfiles, netfileget, netfileput, netfilestat \- netwo .SH DESCRIPTION .B Netfiles presents remote file systems in -.IR acme (4) +.IM acme (4) windows. Each window is named .BI /n/ system / path @@ -35,7 +35,7 @@ reads names of windows to create from the plumbing channel .B netfileedit (see -.IR plumber (4) +.IM plumber (4) and the example section below). In a .IR netfiles -controlled @@ -60,13 +60,13 @@ The three first check to see if .I system is a service in the current name space (see -.IR intro (4)). +.IM intro (4) ). If so, they use -.IR 9p (1) +.IM 9p (1) to access it. Otherwise, they assume that the system is a network name and use -.IR ssh (1)'s +.IM ssh (1) 's .I sftp to access it. .PP @@ -100,7 +100,7 @@ or .SH EXAMPLES The following plumbing rule (see -.IR plumb (7)) +.IM plumb (7) ) passes .B /n/ paths to @@ -118,17 +118,17 @@ plumb client Netfiles .SH SOURCE .B \*9/src/cmd/netfiles .SH SEE ALSO -.IR 9p (1), -.IR ssh (1), -.IR ssh-agent (1), -.IR intro (4), -.IR acme (4), -.IR factotum (4), +.IM 9p (1) , +.IM ssh (1) , +.IM ssh-agent (1) , +.IM intro (4) , +.IM acme (4) , +.IM factotum (4) , .HR http://v9fs.sf.net .SH BUGS .I Netfiles depends on -.IR sftpcache (1), +.IM sftpcache (1) , which only works with OpenSSH versions 4.3 and earlier; later versions do not print the .B sftp> blob - 99fba2b3f03e753be7e7834c5600506b3d05cd98 blob + 4284bda2cc46f2c56a167216d3515d1ed0ada3b1 --- man/man1/page.1 +++ man/man1/page.1 @@ -1,7 +1,7 @@ .TH PAGE 1 .SH NAME -page \- view -FAX, +page \- view +FAX, image, graphic, PostScript, PDF, and typesetter output files @@ -24,23 +24,24 @@ It can be used to display the individual pages of a PostScript, PDF, -or -.IR troff (1) -or -Unix's \fItex\fR(1) +or +.IM troff (1) +or +Unix's +.IR tex (1) device-independent output file. .I Troff -or +or .I tex output is simply converted to PostScript in order to be viewed. It can also be used to view any number of graphics files -(such as a +(such as a FAX -page, +page, a Plan 9 -.IR image (7) +.IM image (7) file, an Inferno bitmap file, or other common format). .I Page displays these @@ -53,26 +54,26 @@ By default, .I page runs in the window in which it is started and leaves the window unchanged. -The +The .B -R -option causes -.I page +option causes +.I page to grow the window if necessary to display the page being viewed. The .B -w -option causes -.I page +option causes +.I page to create a new window for itself. The newly created window will grow as under the .B -R option. -If being used to display +If being used to display multipage documents, only one file may be specified on the command line. .PP -The -.B -p +The +.B -p option sets the resolution for PostScript and PDF files, in pixels per inch. The default is 100 ppi. @@ -85,13 +86,13 @@ When viewing a document, will try to guess the true bounding box, usually rounding up from the file's bounding box to 8½×11 or A4 size. -The +The .B -b option causes it to respect the bounding box given in the file. As a more general problem, some PostScript files claim to conform to Adobe's Document Structuring Conventions but do not. -The +The .B -P option enables a slightly slower and slightly more skeptical version of the PostScript processing code. @@ -101,34 +102,35 @@ that can only be viewed with the option, and there are PostScript documents that can only be viewed without it. .PP -When viewing images with +When viewing images with .IR page , -it listens to the +it listens to the .B image plumbing channel -(see -.IR plumber (4)) +(see +.IM plumber (4) ) for more images to display. -The +The .B -i -option causes +option causes .I page -to not load any graphics files nor to read +to not load any graphics files nor to read from standard input but rather to listen for ones to load from the plumbing channel. .PP -The +The .B -v option turns on extra debugging output, and the .B -V option turns on even more debugging output. -The +The .B -a -option causes +option causes .I page to call -Unix's \fIabort\fR(3) +Unix's +.IR abort (3) rather than exit cleanly on errors, to facilitate debugging. .PP @@ -145,7 +147,7 @@ The button 2 menu operations are: Restores the image to the original. All modifications are lost. .TP .B Zoom -Prompts the user to sweep a rectangle on the image which is +Prompts the user to sweep a rectangle on the image which is expanded proportionally to the rectangle. .TP .B Fit window @@ -164,7 +166,7 @@ Displays the next page. Displays the previous page. .TP .B Zerox -Displays the current image in a new page window. +Displays the current image in a new page window. Useful for selecting important pages from large documents. .TP .B Reverse @@ -189,14 +191,14 @@ toggles whether images are displayed upside-down. Typing a .B r reverses the order in which pages are displayed. -Typing a +Typing a .B w will write the currently viewed page to a new file as a compressed -.IR image (7) +.IM image (7) file. When possible, the filename is of the form .IR basename . pagenum . bit . -Typing a +Typing a .B d removes an image from the working set. .PP @@ -208,13 +210,14 @@ changing pages when panning off the top or bottom of t .PP .I Page calls -Unix's \fIgs\fR(1) +Unix's +.IR gs (1) to draw each page of PostScript and PDF .IR files . It also calls a variety of conversion programs, such as those described in -.IR jpg (1), +.IM jpg (1) , to convert the various raster graphics formats into Inferno bitmap files. Pages are converted ``on the fly,'' as needed. @@ -232,11 +235,11 @@ Browse the Inferno bitmap library. man -t page | page -w Preview this manual in a new window. .SH "SEE ALSO -.IR gs (1), -.IR jpg (1), -.IR proof (1), -.IR tex (1), -.IR troff (1) +.IM gs (1) , +.IM jpg (1) , +.IM proof (1) , +.IM tex (1) , +.IM troff (1) .SH SOURCE .B \*9/src/cmd/page .SH DIAGNOSTICS @@ -254,19 +257,19 @@ When viewing multipage PostScript files that do not co .RB `` %%Page '' comments, the button 3 menu only contains ``this page'' and ``next page'': -correctly determining +correctly determining page boundaries in Postscript code is not computable in the general case. .PP If .I page has trouble viewing a Postscript file, -it might not be exactly conforming: try viewing it with the +it might not be exactly conforming: try viewing it with the .B -P option. .PP The interface to the plumber is unsatisfactory. In particular, -document references cannot be sent +document references cannot be sent via plumbing messages. .PP There are too many keyboard commands and menu items. @@ -274,7 +277,7 @@ There are too many keyboard commands and menu items. Displaying a PostScript or PDF file depends both on having GhostScript (see -.IR gs (1)) +.IM gs (1) ) installed and on the underlying operating system providing a file descriptor device tree at .BR /dev/fd . blob - 2bcbf245cf91b71add49ae7aec54ec1ec7a1e9bf blob + fa37ceb74ad52aa7805a267d44009dea783da012 --- man/man1/paint.1 +++ man/man1/paint.1 @@ -19,7 +19,7 @@ If the optional argument is specified, then it is read and used as the canvas. .I Paint only recognizes Plan 9 bitmap format (see -.IR image (6)). +.IM image (6) ). .PP A number of immediate keyboard commands are recognized: .TP @@ -74,12 +74,12 @@ Quits the program. .SH SOURCE .B /sys/src/cmd/paint.c .SH "SEE ALSO" -.IR resample (1), -.IR rotate (1), -.IR crop (1), -.IR jpg (1), -.IR page (1), -.IR image (6) +.IM resample (1) , +.IM rotate (1) , +.IM crop (1) , +.IM jpg (1) , +.IM page (1) , +.IM image (6) .SH HISTORY .I Paint first appeared in 9front (October, 2011). blob - f6843b399b444aa70093eb331cb9e27cb694e472 blob + d31f3a8bc38afd8b4f3eaf327b742ff3c517a40b --- man/man1/passwd.1 +++ man/man1/passwd.1 @@ -36,7 +36,7 @@ It is a substitute for a SecureNet box. .br .B \*9/src/cmd/auth/passwd.c .SH "SEE ALSO" -.IR encrypt (3) +.IM encrypt (3) .PP Robert Morris and Ken Thompson, ``UNIX Password Security,'' blob - 391cd5cce0e945d94be4893e20c045107ea1d083 blob + b18ee2514dff8e8aa3fc2efd63d7b23961bc8d8d --- man/man1/pem.1 +++ man/man1/pem.1 @@ -20,7 +20,7 @@ Privacy Enhanced Mail program but now commonly used fo other applications, notably TLS. PEM encodes data in base 64 (see -.IR encode (3)) +.IM encode (3) ) between lines of the form: .IP .EX @@ -33,7 +33,7 @@ where may be any string describing the encoded data. The most common use of PEM format on Plan 9 is for encoding X.509 certificates; see -.IR rsa (1). +.IM rsa (1) . .PP .I Pemdecode extracts the named @@ -62,4 +62,4 @@ hello world .SH SOURCE .B \*9/src/cmd/auth .SH "SEE ALSO -.IR rsa (1) +.IM rsa (1) blob - 0ee526fe1905b2d17b2d178a132412a92b8c5bb2 blob + bacc1dcb649755f10dc4841bee80ecc49e7d1dff --- man/man1/pic.1 +++ man/man1/pic.1 @@ -31,7 +31,7 @@ pic, tpic, svgpic \- troff and tex preprocessors for d .SH DESCRIPTION .I Pic is a -.IR troff (1) +.IM troff (1) preprocessor for drawing figures on a typesetter. .I Pic code is contained between @@ -300,7 +300,7 @@ statement removes the definition of a macro. .PP .I Tpic is a -.IR tex (1) +.IM tex (1) preprocessor that accepts .IR pic language. @@ -345,8 +345,8 @@ A: ellipse .B \*9/src/cmd/pic .SH "SEE ALSO" .IR grap (1), -.IR doctype (1), -.IR troff (1) +.IM doctype (1) , +.IM troff (1) .br B. W. Kernighan, ``PIC\(ema Graphics Language for Typesetting'', blob - 3c8803f842b82fefeda9323cf3a7eec8ac50053d blob + 8485bcd5d5fd3e85f94332e09ef76a01925c5b26 --- man/man1/plot.1 +++ man/man1/plot.1 @@ -14,7 +14,7 @@ from the .I files or standard input, drawing the results in a newly created -.IR rio (1) +.IM rio (1) window. Plot persists until a newline is typed in the window. Various options may be interspersed with the @@ -31,7 +31,7 @@ Erase the screen. .TP .BI -c " col" Set the foreground color (see -.IR plot (7) +.IM plot (7) for color names). .TP .BI -f " fill" @@ -57,5 +57,5 @@ middle of the screen. .SH SOURCE .B \*9/src/cmd/plot .SH "SEE ALSO" -.IR rio (1), -.IR plot (7) +.IM rio (1) , +.IM plot (7) blob - 3fa162524f8d3fd7027ddc330295a6602dea1d58 blob + a6295342f4122736e335fe234f0952070d1ca3a1 --- man/man1/plumb.1 +++ man/man1/plumb.1 @@ -83,6 +83,6 @@ default rules file .SH SOURCE .B \*9/src/cmd/plumb .SH "SEE ALSO" -.IR plumb (3), -.IR plumber (4), -.IR plumb (7) +.IM plumb (3) , +.IM plumber (4) , +.IM plumb (7) blob - 860c026cc1f56e04f02fe6f1415b29bbdc9125ca blob + f7069ac0a039125eaa5dff81562c1833800ab4c1 --- man/man1/pr.1 +++ man/man1/pr.1 @@ -106,5 +106,5 @@ characters instead of the default 72. .SH SOURCE .B \*9/src/cmd/pr.c .SH "SEE ALSO" -.IR cat (1), -.IR lp (1) +.IM cat (1) , +.IM lp (1) blob - 2a1de08411fe06c4a5d56cb53cacc1095b1165b3 blob + fe5db6d3f8c523e62b8892505ac4ca8546423539 --- man/man1/proof.1 +++ man/man1/proof.1 @@ -22,7 +22,7 @@ proof \- troff output interpreter .SH DESCRIPTION .I Proof reads -.IR troff (1) +.IM troff (1) intermediate language from .I file or standard input @@ -126,8 +126,8 @@ into screen fonts and character numbers .B \*9/src/cmd/proof .SH SEE ALSO .IR lp (1), -.IR gs (1), -.IR page (1) +.IM gs (1) , +.IM page (1) .br J. F. Ossanna and B. W. Kernighan, ``Troff User's Manual'' blob - bb655d1812a9012e96196adb30907bfa2a6b7359 blob + c597060ff7de7653fdbdbbe1c8ec4b9aa768e62e --- man/man1/ps.1 +++ man/man1/ps.1 @@ -102,6 +102,6 @@ to print the arguments for the process. Newlines in a .br .B \*9/bin/psu .SH "SEE ALSO" -.IR acid (1), -.IR db (1), -.IR kill (1) +.IM acid (1) , +.IM db (1) , +.IM kill (1) blob - c408f54a7ddd7bdca4231afc4d5ff0bb28694db6 blob + 223c74f528ec4e65e30a32e255acd54fff55b257 --- man/man1/psfonts.1 +++ man/man1/psfonts.1 @@ -16,9 +16,9 @@ psfonts, psdownload \- add necessary fonts to PostScri ] .SH DESCRIPTION Plan 9's -.IR troff (1) +.IM troff (1) and -.IR tr2post (1) +.IM tr2post (1) use non-standard PostScript fonts (found in .BR \*9/postscript/font ). @@ -114,12 +114,12 @@ Continue running even after fatal errors occur. .PD .SH EXAMPLE See -.IR tr2post (1) +.IM tr2post (1) for an example. .SH SOURCE .B \*9/bin/psfonts .br .B \*9/src/cmd/postscript/download .SH SEE ALSO -.IR troff (1), -.IR tr2post (1) +.IM troff (1) , +.IM tr2post (1) blob - 0a3e0668453c0b39cb5948b13ef481fba2ade1d9 blob + 1464302df0a7123ac98618a5a951a0a9ef0883c0 --- man/man1/pwd.1 +++ man/man1/pwd.1 @@ -18,8 +18,8 @@ such as constructing shell prompts. .SH SEE ALSO .I cd in -.IR rc (1), -.IR getwd (3) +.IM rc (1) , +.IM getwd (3) .SH BUGS .I Pwd is not provided. blob - 7553707d0df346ea362aa18e2f09af14553b83ce blob + 1d6a008b201564bf1ad9b31b6483727be4666819 --- man/man1/rc.1 +++ man/man1/rc.1 @@ -50,7 +50,7 @@ exits or is terminated, the variable .B $status gets the process's wait message (see -.IR wait (3)); +.IM wait (3) ); it will be the null string if the command was successful. .PP A long command line may be continued on subsequent lines by typing @@ -83,7 +83,7 @@ in a directory in .B $path is the program to be executed. To be executable, the user must have execute permission (see -.IR stat (3)) +.IM stat (3) ) and the file must be either an executable binary for the current machine's CPU type, or a shell script. Shell scripts begin with a line containing the full path name of a shell @@ -350,7 +350,7 @@ or is a previously opened file descriptor and .I fd0 becomes a new copy (in the sense of -.IR dup (3)) +.IM dup (3) ) of it. A file descriptor may be closed by writing .BI >[ fd0 =] @@ -543,7 +543,7 @@ function definition. A function with a special name will be called when .I rc receives a corresponding note; see -.IR notify (3). +.IM notify (3) . The valid note names (and corresponding notes) are .B sighup .RB ( hangup ), @@ -662,7 +662,7 @@ is composed of the bitwise OR of the .B rfork flags specified by the option letters (see -.IR fork (2)). +.IM fork (2) ). If no .I flags are given, they default to @@ -829,7 +829,7 @@ parsing the .B $PATH variable (as in -.IR sh (1)) +.IM sh (1) ) or by .BR "path=(.\ /bin)" . The variables blob - 8fa1c392ee5c370c798b92c00dc6e3d9220467b8 blob + d85452b7c5d578de927c28b99333c2f1792a57de --- man/man1/readcons.1 +++ man/man1/readcons.1 @@ -27,4 +27,4 @@ is printed instead of an empty string. .SH SOURCE .B \*9/src/cmd/readcons.c .SH SEE ALSO -.IR readcons (3) +.IM readcons (3) blob - f41d9e5129aedb7ed024d79e943541178c0ba00f blob + 4b41ca081f741319a20fdbf41a5c8c54f0e46ba3 --- man/man1/resample.1 +++ man/man1/resample.1 @@ -40,19 +40,19 @@ and .PP The input should be a Plan 9 image as described in -.IR image (7), +.IM image (7) , and the output will be a compressed 24-bit .B r8g8b8 image. To uncompress the image or change the pixel format, use .I iconv (see -.IR crop (1)). +.IM crop (1) ). .PP .SH SOURCE .B \*9/src/cmd/resample.c .SH "SEE ALSO -.IR crop (1), -.IR image (7) +.IM crop (1) , +.IM image (7) .SH BUGS Faster algorithms exist, but this implementation produces correct pictures. blob - 1fc0619d8486f8b94c8a23e2ef0e529f23297b5f blob + d22ad3e412c22044f1b50f9c29922fce8db9a042 --- man/man1/rio.1 +++ man/man1/rio.1 @@ -68,15 +68,15 @@ specifies an alternative program to run when the .I New menu item is selected. The default is to try -.IR 9term (1) +.IM 9term (1) and then to fall back to -.IR xterm (1). +.IM xterm (1) . The .B \-s option has no effect. It formerly set the scrolling mode for new windows and is recognized to avoid breaking scripts. See -.IR 9term (1) +.IM 9term (1) for a description of scrolling behavior. .PP The @@ -137,11 +137,11 @@ Very small windows may not be created. The new window is created running .IR termprog , by default -.IR 9term (1) +.IM 9term (1) or, if .I 9term is not available, -.IR xterm (1). +.IM xterm (1) . .TP .B Resize Change the size and location of a window. @@ -165,7 +165,7 @@ Deleting a window causes a .L hangup note to be sent to all processes in the window's process group (see -.IR notify (3)). +.IM notify (3) ). .TP .B Hide Hide a window. Click in the window to be hidden (gunsight cursor); @@ -241,8 +241,8 @@ starts a particular program.) .PP There is a currently a compiled-in limit of 128 hidden windows. .SH "SEE ALSO" -.IR 9term (1), -.IR xterm (1) +.IM 9term (1) , +.IM xterm (1) .PP As mentioned above, .I rio blob - 83bc81727e21121b4e7ef26cb35c82c58f69d71e blob + ce0ea1c13c34e0812b77029cb7f54aef2c25785f --- man/man1/rm.1 +++ man/man1/rm.1 @@ -25,4 +25,4 @@ and the directory itself. .SH SOURCE .B \*9/src/cmd/rm.c .SH "SEE ALSO" -.IR remove (3) +.IM remove (3) blob - b01c979d9dc53a20e6155bd1a4397d4f4dd14e6d blob + 2ba0d8b034ceb3b35847753db913bbf2c5f98c5a --- man/man1/rsa.1 +++ man/man1/rsa.1 @@ -85,7 +85,7 @@ Plan 9 represents DSA and RSA keys as attribute-value prefixed with the string .BR key ; this is the generic key format used by -.IR factotum (4). +.IM factotum (4) . A full DSA private key has the following attributes: .TP .B proto @@ -334,9 +334,9 @@ scp auth.keys unix:.ssh/authorized_keys .SH SOURCE .B \*9/src/cmd/auth .SH "SEE ALSO -.IR factotum (4), -.IR pem (1), -.IR ssh (1) +.IM factotum (4) , +.IM pem (1) , +.IM ssh (1) .SH BUGS There are too many key formats. .PP blob - 8e771833f9eb42d54154b2db494ed7872ef10c57 blob + c928b667923b3166b1f9cb6eaf49882f2e844aa0 --- man/man1/sam.1 +++ man/man1/sam.1 @@ -51,7 +51,7 @@ copies leading white space on the current line to the Do not `download' the terminal part of .IR sam . Editing will be done with the command language only, as in -.IR ed (1). +.IM ed (1) . .TP .BI -r " machine Run the host part remotely @@ -69,7 +69,7 @@ for debugging. .PD .SS Regular expressions Regular expressions are as in -.IR regexp (7) +.IM regexp (7) with the addition of .BR \en to represent newlines. @@ -698,7 +698,7 @@ There is usually a `current window', marked with a dark border, to which typed text and editing commands apply. Text may be typed and edited as in -.IR rio (1); +.IM rio (1) ; also the escape key (ESC) selects (sets dot to) text typed since the last mouse button hit. .PP @@ -798,7 +798,7 @@ the white-space-delimited block of text is sent as a p with a .B click attribute defining where the selection lies (see -.IR plumb (7)). +.IM plumb (7) ). .TP .B look Search forward for the next occurrence of the literal text in dot. @@ -909,11 +909,11 @@ source for the separate terminal part .TP .B \*9/bin/E .SH SEE ALSO -.IR ed (1), -.IR sed (1), -.IR grep (1), -.IR rio (1), -.IR regexp (7). +.IM ed (1) , +.IM sed (1) , +.IM grep (1) , +.IM rio (1) , +.IM regexp (7) . .PP Rob Pike, ``The text editor sam''. blob - 57369ab5fe9073e40212be95be017c8ee7f31cfe blob + 1fef523362600187be2a79206be6b8e39f321b03 --- man/man1/scat.1 +++ man/man1/scat.1 @@ -10,7 +10,7 @@ outside the solar system and implements database-like manipulations on sets of such objects. It also provides an interface to -.IR astro (1) +.IM astro (1) to plot the locations of solar system objects. Finally, it displays images from the Space Telescope Science Institute's @@ -119,7 +119,7 @@ The names and .B comet refer to the earth's penumbra at lunar distance and the comet installed in the current -.IR astro (1). +.IM astro (1) . The output is the planet's name, right ascension and declination, azimuth and altitude, and phase for the moon and sun, as shown by .BR astro . @@ -182,7 +182,7 @@ collects all objects in the patches that cover the cur .TP .BI astro " option" Run -.IR astro (1) +.IM astro (1) with the specified .I options (to which will be appended @@ -324,7 +324,7 @@ Draw a map of the Pleiades. .SH SOURCE .B \*9/src/cmd/scat .SH SEE ALSO -.IR astro (1) +.IM astro (1) .br .B \*9/sky/constelnames\ \ the three-letter abbreviations of the constellation names. blob - 01c7903b0afcc860064cf0b36e34dab8e645573b blob + 6c25c7303b5f443b5fa151050e75b3ddd915d0e5 --- man/man1/secstore.1 +++ man/man1/secstore.1 @@ -97,7 +97,7 @@ Option .B -n says that the password should be read from NVRAM (see -.IR authsrv (3)) +.IM authsrv (3) ) instead of from .BR /dev/tty . .PP @@ -107,7 +107,7 @@ or the server specified by option .BR -s . .PP For example, to add a secret to the file read by -.IR factotum (4), +.IM factotum (4) , run .sp .EX @@ -192,8 +192,8 @@ block chaining (CBC) mode. .br .B \*9/src/cmd/auth/secstore .SH SEE ALSO -.IR factotum (4), -.IR secstored (1) +.IM factotum (4) , +.IM secstored (1) .SH BUGS There is deliberately no backup of files on the secstore, so .B -r blob - 3eee78bef36e0b92ce291a66a49be17cedfa2ab0 blob + d21ff5e59c5e185cbd896b0bf98622aa8a6e78f2 --- man/man1/secstored.1 +++ man/man1/secstored.1 @@ -18,7 +18,7 @@ username .PP .I Secstored serves requests from -.IR secstore (1). +.IM secstore (1) . The .B -R option supplements the password check with a @@ -61,4 +61,4 @@ for mapping local userid to RADIUS userid .SH SOURCE .B \*9/src/cmd/auth/secstore .SH SEE ALSO -.IR secstore (1) +.IM secstore (1) blob - 7f2b5f1344daf19e7515f2787fc6d75906ce2b37 blob + 8df5285e1a6904c2dc3c20b321c8d33d17bc79f3 --- man/man1/sed.1 +++ man/man1/sed.1 @@ -78,7 +78,7 @@ that addresses the last line of input, or a context address, .BI / regular-expression / \f1, in the style of -.IR regexp (7), +.IM regexp (7) , with the added convention that .L \en matches a @@ -235,7 +235,7 @@ in the pattern space. Any character may be used instead of .LR / . For a fuller description see -.IR regexp (7). +.IM regexp (7) . .I Flags is zero or more of .RS @@ -374,8 +374,8 @@ formatted manuscript. .IR grep (1), .IR awk (1), .IR lex (1), -.IR sam (1), -.IR regexp (7) +.IM sam (1) , +.IM regexp (7) .br L. E. McMahon, `SED \(em A Non-interactive Text Editor', blob - 3f295c0414762b8b004518353a313f46e09ef375 blob + eea10dfaf6a96c426e17a812bb9a32f270317c2f --- man/man1/seq.1 +++ man/man1/seq.1 @@ -38,7 +38,7 @@ The options are .TP "\w'\fL-f \fIformat\fLXX'u" .BI -f format Use the -.IR print (3)-style +.IM print (3) -style .I format .IR print for printing each (floating point) number. blob - 28499b48dea9f733f60ebdf73d589fe9366467cf blob + aec061f4b1ff03c21abc21767d7ee24fab510db7 --- man/man1/sftpcache.1 +++ man/man1/sftpcache.1 @@ -7,7 +7,7 @@ sftpcache \- cache sftp connections .SH DESCRIPTION .I Sftpcache multiplexes clients onto persistent -.IR sftp (1) +.IM sftp (1) connections. It runs .I sftp @@ -16,7 +16,7 @@ and posts a socket named .IB system .sftp in the name space directory (see -.IR intro (4)). +.IM intro (4) ). Clients can connect to the socket, one at a time, to interact with the .I sftp @@ -24,13 +24,13 @@ session. .PP .I Sftpcache is used by -.IR netfiles (1). +.IM netfiles (1) . .SH SOURCE .B \*9/src/cmd/sftpcache.c .SH SEE ALSO -.IR ssh (1), -.IR sftp (1), -.IR netfiles (1) +.IM ssh (1) , +.IM sftp (1) , +.IM netfiles (1) .SH BUGS .I Sftpcache only works with OpenSSH versions 4.3 and earlier; blob - 3eb617b462be201e9c5227c6aca3ef1a63736c4d blob + a6a19a3814e07602969bcf775d3717b38a562ed4 --- man/man1/sleep.1 +++ man/man1/sleep.1 @@ -28,4 +28,4 @@ while (){ .SH SOURCE .B \*9/src/cmd/sleep.c .SH "SEE ALSO" -.IR sleep (3) +.IM sleep (3) blob - 54200b4b242d4c2934671d620d752f68355f0fed blob + db8ce1987a871ba3fee40075e660702459272b88 --- man/man1/snarfer.1 +++ man/man1/snarfer.1 @@ -13,30 +13,31 @@ Each time a program changes the snarf buffer contents, .I snarfer copies the new contents and then takes over control of the buffer. -Because the snarf buffer contents are managed by +Because the snarf buffer contents are managed by .I snarfer instead of by individual programs, the contents remain available even after the program that wrote them exits. .PP -The +The .B -v option, intended for debugging, causes .I snarfer to print the new snarf buffer contents each time it changes. .PP -On Mac OS X, +On Mac OS X, running .I snarfer keeps the X11 snarf buffer in sync with the Carbon snarf buffer, working around a bug in the OS X X11 server. See -.IR getsnarf (3) +.IM getsnarf (3) for more details. .SH SOURCE .B \*9/src/cmd/snarfer .SH SEE ALSO -Unix's \fIxclipboard\fR(1), -.IR getsnarf (3) +Unix's +.IR xclipboard (1), +.IM getsnarf (3) .SH BUGS Both .I xclipboard blob - 6378d4149518cf8137dfff4a01a31137fd753b6f blob + 6b8f465275014fb5ef7ffd0b9e099de03a84e696 --- man/man1/soelim.1 +++ man/man1/soelim.1 @@ -11,19 +11,19 @@ soelim \- preprocess so inclusion commands in troff in .I Soelim reads the specified files or the standard input and performs the textual inclusion implied by -.IR troff (1) +.IM troff (1) directives of the form .TP .B "\&.so some_file .PP when they appear at the beginning of input lines. This is useful when using programs such as -.IR tbl (1) +.IM tbl (1) that do not normally do this, allowing placement of individual tables or other text objects in separate files to be run as a part of a large document. .SH SOURCE .B \*9/bin/soelim .SH "SEE ALSO" -.IR deroff (1), -.IR troff (1) +.IM deroff (1) , +.IM troff (1) blob - e68a53fcb4d51d75d69a55b2cf32f58a34cc21f2 blob + d732374c732a509f6d5f0091839b63df4242f516 --- man/man1/sort.1 +++ man/man1/sort.1 @@ -242,8 +242,8 @@ come out in their original order. .SH SOURCE .B \*9/src/cmd/sort.c .SH SEE ALSO -.IR uniq (1), -.IR look (1) +.IM uniq (1) , +.IM look (1) .SH DIAGNOSTICS .I Sort comments and exits with non-null status for various trouble blob - 5d27609bc2d44ece4e6aa31966ad5c1098bbbf97 blob + 3e7388eb387bda399cb761e9151e21929764c5a1 --- man/man1/spell.1 +++ man/man1/spell.1 @@ -31,7 +31,7 @@ not sanctioned there\(emon the standard output. .PP .I Spell ignores constructs of -.IR troff (1) +.IM troff (1) and its standard preprocessors. It understands these options: .TP @@ -82,10 +82,10 @@ the script source for .I sprog .SH SEE ALSO -.IR deroff (1) +.IM deroff (1) .SH BUGS The heuristics of -.IR deroff (1) +.IM deroff (1) used to excise formatting information are imperfect. .PP The spelling list's coverage is uneven; blob - 9b2c976f9ed315df4ffc16d0c5a24870254eed29 blob + 440cf7eb7003a0325e26c107c854d40e23ec6a33 --- man/man1/split.1 +++ man/man1/split.1 @@ -41,7 +41,7 @@ File divisions occur at each line that matches a regular .IR expression ; see -.IR regexp (7). +.IM regexp (7) . Multiple .B -e options may appear. @@ -77,6 +77,6 @@ to lower case. .B \*9/src/cmd/split.c .SH SEE ALSO .IR sed (1), -.IR awk (1), -.IR grep (1), -.IR regexp (7) +.IM awk (1) , +.IM grep (1) , +.IM regexp (7) blob - 5f6a29cffa0323d59771bf5e9770b10f3fa71da4 blob + 94f69b4f39a8a37e3e45558df5dfb86837040a3d --- man/man1/src.1 +++ man/man1/src.1 @@ -19,11 +19,11 @@ examines the named to find the corresponding source code, which is then sent to the editor using .B B (see -.IR sam (1)). +.IM sam (1) ). If .I file is an -.IR rc (1) +.IM rc (1) script, the source is the file itself. If .I file @@ -35,7 +35,7 @@ and will point the editor at the line that begins the definition. .I Src uses -.IR db (1) +.IM db (1) to extract the symbol table information that identifies the source. .PP .I Src @@ -78,6 +78,6 @@ src -s strcmp rc .SH SOURCE .B \*9/bin/src .SH "SEE ALSO" -.IR db (1), -.IR plumb (1), -.IR sam (1). +.IM db (1) , +.IM plumb (1) , +.IM sam (1) . blob - 6dbdc236484ca8af5c077c8e5dad0a93e4f96f4f blob + 17a105aa5eb1596189e6ce12f9e24d1ab7afeca6 --- man/man1/ssam.1 +++ man/man1/ssam.1 @@ -63,8 +63,8 @@ Count frequency of words read from standard input. .B \*9/bin/ssam .SH SEE ALSO .IR sed (1), -.IR sam (1), -.IR regexp (7) +.IM sam (1) , +.IM regexp (7) .PP Rob Pike, ``The text editor sam''. blob - 1617e17f6de52faed983665bda356e3fdd0766d9 blob + 2300ab9df1e4b7fe790e281036d88d4f71dddce0 --- man/man1/ssh-agent.1 +++ man/man1/ssh-agent.1 @@ -10,9 +10,9 @@ ssh-agent \- SSH authentication agent .SH DESCRIPTION .I Ssh-agent presents -.IR factotum (4) +.IM factotum (4) using the interface that -.IR ssh (1) +.IM ssh (1) requires. .PP Once @@ -33,7 +33,7 @@ via a Unix socket named .B ssh-agent.socket in the name space directory (see -.IR intro (4)). +.IM intro (4) ). Note that although the socket is posted in the name space directory, it is not for 9P conversations. .I Ssh @@ -81,10 +81,10 @@ Invoke this one with .B 9 .BR ssh-agent ; see -.IR 9 (1). +.IM 9 (1) . .SH EXAMPLES Assume -.IR factotum (4) +.IM factotum (4) is already running and initialized with keys. .PP Start a new agent, copying the commands by hand: @@ -103,7 +103,7 @@ $ .EE .PP Start the agent from -.IR sh (1): +.IM sh (1) : .IP .EX $ eval `9 ssh-agent -e` @@ -111,7 +111,7 @@ $ .EE .PP Start the agent from -.IR rc (1): +.IM rc (1) : .IP .EX % eval `{9 ssh-agent} @@ -128,9 +128,9 @@ tux% ^D .SH SOURCE .B \*9/src/cmd/auth/ssh-agent.c .SH SEE ALSO -.IR ssh (1), -.IR rsa (1), -.IR factotum (4) +.IM ssh (1) , +.IM rsa (1) , +.IM factotum (4) .SH BUGS A surprise rather than a bug: .I ssh-agent blob - d04dc41fe90a182403bb9d635e5b3fdfb78b04e3 blob + c4d950ed67d285a18e4c03a238f4f500aa6fb5bc --- man/man1/strings.1 +++ man/man1/strings.1 @@ -25,4 +25,4 @@ line with the offset of the continuation line. .SH SOURCE .B \*9/src/cmd/strings.c .SH SEE ALSO -.IR nm (1) +.IM nm (1) blob - b95851db03bff2ee33b4b762a37445e4d4a05f2b blob + 3d674cb31ccfea1c330256395dab5864d01efbab --- man/man1/sum.1 +++ man/man1/sum.1 @@ -73,5 +73,5 @@ summed. .br .B \*9/src/cmd/sha1sum.c .SH "SEE ALSO" -.IR cmp (1), -.IR wc (1) +.IM cmp (1) , +.IM wc (1) blob - 80e3f40b02b605c77afd9fb6e4de5c4df53c96e5 blob + a7455fbe14fa633f7f7f937e03fb132467526a1e --- man/man1/tar.1 +++ man/man1/tar.1 @@ -112,14 +112,14 @@ archive entries. .B z Operate on compressed tar archives. The type of compression is inferred from the file name extension: -.IR gzip (1) +.IM gzip (1) for .B .tar.gz and .BR .tgz ; .I bzip2 (see -.IR gzip (1)) +.IM gzip (1) ) for .BR .tar.bz , .BR .tbz , @@ -153,8 +153,8 @@ can be used to copy hierarchies thus: .SH SEE ALSO .I 9ar in -.IR 9c (1), -.IR bundle (1) +.IM 9c (1) , +.IM bundle (1) .SH BUGS There is no way to ask for any but the last occurrence of a file. blob - ce13a4a49ef984edf29235933bdbab74f215425e blob + c727fb2bd1e00ea43971928c4679ac77129d1f80 --- man/man1/tbl.1 +++ man/man1/tbl.1 @@ -11,7 +11,7 @@ tbl \- format tables for nroff or troff is a preprocessor for formatting tables for .I nroff or -.IR troff (1). +.IM troff (1) . The input .I files are copied to the standard output, @@ -74,7 +74,7 @@ recognize and .I y as -.IR eqn (1) +.IM eqn (1) delimiters .PD .RE @@ -275,8 +275,8 @@ Bernardsville 2018 3.30 .B \*9/src/cmd/tbl .SH SEE ALSO .IR troff (1), -.IR eqn (1), -.IR doctype (1) +.IM eqn (1) , +.IM doctype (1) .br M. E. Lesk and L. L. Cherry, ``TBL\(ema Program to Format Tables'', blob - f23d1ceef0c262c104125123c7d1b1a1ec034453 blob + 6e32b5f1df1ba117a1b4491430728d36d3f93a0d --- man/man1/tcs.1 +++ man/man1/tcs.1 @@ -36,7 +36,7 @@ is the .SM UTF encoding described in -.IR utf (7). +.IM utf (7) . The .B -l option lists the character sets known to @@ -164,4 +164,4 @@ Print an up to date list of the supported character se .SH SEE ALSO .IR ascii (1), .IR rune (3), -.IR utf (7). +.IM utf (7) . blob - 9957b29d766d61cf5255caa672479d7f5436770a blob + 3553804fd64fdb946f13ae18692cd7509cf0635a --- man/man1/test.1 +++ man/man1/test.1 @@ -182,7 +182,7 @@ and must be enclosed in quotes. .I Test is a dubious way to check for specific character strings: it uses a process to do what an -.IR rc (1) +.IM rc (1) match or switch statement can do. The first example is not only inefficient but wrong, because .I test blob - 57a0a5668147cf6d8ed60742650f6f1ae9c78ea7 blob + 91e3383199a59b4698bb60304492450bc4407846 --- man/man1/time.1 +++ man/man1/time.1 @@ -18,4 +18,4 @@ followed by the command line. .SH SOURCE .B \*9/src/cmd/time.c .SH "SEE ALSO" -.IR prof (1) +.IM prof (1) blob - a02440d2cbc42dd39424d912e1cb272cec2c3ddd blob + 086d4a8280c9f44ce5f93c77ced7eac71482fd91 --- man/man1/touch.1 +++ man/man1/touch.1 @@ -27,9 +27,9 @@ is present. .SH SOURCE .B \*9/src/cmd/touch.c .SH SEE ALSO -.IR ls (1), -.IR stat (3), -.IR chmod (1) +.IM ls (1) , +.IM stat (3) , +.IM chmod (1) .SH BUGS .I Touch will not touch directories. blob - cef4a177573b9927ca732a906c8fa4099b4e79d6 blob + 3746e48eb00521c69cf38bcd41e931aaa81a2bc5 --- man/man1/tr.1 +++ man/man1/tr.1 @@ -94,4 +94,4 @@ tr -cs A-Za-z ' .SH SOURCE .B \*9/src/cmd/tr.c .SH "SEE ALSO" -.IR sed (1) +.IM sed (1) blob - 3a54e4d22a600a215b311a16df0c663b1112e71c blob + 4d047f4ff64a3a5d3c0a39a4d010970bcf5b1462 --- man/man1/tr2post.1 +++ man/man1/tr2post.1 @@ -15,7 +15,7 @@ converts .I files (or standard input), which should be the device-independent output of -.IR troff (1), +.IM troff (1) , into the PostScript printer language. .PP The options are: @@ -29,7 +29,8 @@ to stretch the PostScript output (default 1.0). Set a comment in the PostScript output marking the number of copies that should be printed. The comment is intended for ancient versions of the Unix -\fIlp\fR(1) and is not recognized by any current printer +.IR lp (1) +and is not recognized by any current printer or print spooler. .TP .BI -d @@ -46,11 +47,11 @@ logical pages per physical page Using this option emits PostScript with invalid document structuring comments. It will print fine but will not view correctly in -.IR gv (1) +.IM gv (1) or .I psv (see -.IR page (1)). +.IM page (1) ). .TP .BI -o " pagelist Print only the pages in the @@ -109,5 +110,5 @@ psv /tmp/a.ps .SH SOURCE .B \*9/src/cmd/postscript/tr2post .SH SEE ALSO -.IR troff (1), -.IR psfonts (1) +.IM troff (1) , +.IM psfonts (1) blob - 7af3f3c1cc5c48d29bbb1b37f077685fdbfa8a6c blob + acce30a73b3be1bfbc4605ff8c53b80fe38cc06c --- man/man1/troff.1 +++ man/man1/troff.1 @@ -176,18 +176,18 @@ font width tables for .SH SOURCE .B \*9/src/cmd/troff .SH "SEE ALSO" -.IR lpr (1), -.IR proof (1), -.IR tr2post (1), +.IM lpr (1) , +.IM proof (1) , +.IM tr2post (1) , .IR eqn (1), .IR tbl (1), .IR pic (1), -.IR grap (1), +.IM grap (1) , .IR doctype (1), -.IR ms (7), -.IR image (7), -.IR tex (1), -.IR deroff (1) +.IM ms (7) , +.IM image (7) , +.IM tex (1) , +.IM deroff (1) .br J. F. Ossanna and B. W. Kernighan, ``Troff User's Manual'' blob - a40e22f0eb661d43ef35cc6411bedf7ca2d55188 blob + 98ea62a8f792158572be5227c764a76323af4cc2 --- man/man1/troff2html.1 +++ man/man1/troff2html.1 @@ -13,7 +13,7 @@ troff2html \- convert troff output into HTML .SH DESCRIPTION .I Troff2html reads the -.IR troff (1) +.IM troff (1) output in the named .IR files , default standard input, @@ -25,12 +25,13 @@ does a tolerable job with straight output, but it is helped by annotations, described below. Its main use is for .B man2html -(see Plan 9's \fIhttpd\fR(8)), +(see Plan 9's +.IR httpd (8)), which converts -.IR man (1) +.IM man (1) pages into HTML and depends on a specially annotated set of -.IR man (7) +.IM man (7) macros, invoked by .B troff .BR -manhtml . @@ -57,25 +58,25 @@ x X html manref end cp 1 .EE .PP which are used to create HTML hyperlinks around text of the form -.IR cp (1) +.IM cp (1) pointing to .BR /magic/man2html/1/cp . .PP .I Troff2html is new and experimental; in time, it may improve and subsume Plan 9's -\fIms2html\fR(1). +.IR ms2html (1). On the one hand, because it uses the input, .B ms2html can handle -.IR pic (1), -.IR eqn (1), +.IM pic (1) , +.IM eqn (1) , etc., which .I troff2html does not handle at all; on the other hand, .B ms2html understands only -.IR ms (7) +.IM ms (7) documents and is easily confused by complex .B troff constructions. @@ -83,13 +84,13 @@ constructions. has the reverse properties: it does not handle the preprocessors but its output is reliable and (modulo helper annotations) is independent of macro package. .SH SEE ALSO -.IR troff (1), +.IM troff (1) , Plan 9's -\fIms2html\fR(1), +.IR ms2html (1), .I man2html in Plan 9's -\fIhttpd\fR(8). +.IR httpd (8). .SH BUGS .B Troff and HTML have different models, and they don't mesh well in all cases. blob - ac52a9b59e1314a95e7f92b97860a5b62f03d91f blob + 09b96af3741eaee4f15e38cbd100d4e1c441be81 --- man/man1/tweak.1 +++ man/man1/tweak.1 @@ -35,14 +35,14 @@ If the file is a subfont, a second line presents a hex .B offset to be applied to character values from the subfont (typically as stored in a font file; see -.IR font (7)); +.IM font (7) ); and the subfont's .BR n , .BR height , and .B ascent as defined in -.IR cachechars (3). +.IM cachechars (3) . .PP By means described below, magnified views of portions of the images may be displayed. @@ -61,7 +61,7 @@ default font; the character's and .BR width as defined in -.IR cachechars (3); +.IM cachechars (3) ; and .BR iwidth , the physical width of the image in the subfont's image. @@ -158,9 +158,9 @@ The program will complain once about modified but unwr .SH SOURCE .B \*9/src/cmd/draw/tweak.c .SH "SEE ALSO" -.IR cachechars (3), -.IR image (7), -.IR font (7) +.IM cachechars (3) , +.IM image (7) , +.IM font (7) .SH BUGS For a program written to adjust width tables in fonts, .I tweak blob - ae17f0955630a526f553af4ffd82542f12700e42 blob + 98e2cc7bbfb2d9f425fe811a3238496bc8270cd9 --- man/man1/uniq.1 +++ man/man1/uniq.1 @@ -56,4 +56,4 @@ Fields are skipped before characters. .IR sort (1) .SH BUGS Field selection and comparison should be compatible with -.IR sort (1). +.IM sort (1) . blob - 39f7c00ffe1e03d2f0b7e9e442b22ca8b04fe0be blob + 489e677f2ea2276e560f7d7abedc9c21add7e91f --- man/man1/vac.1 +++ man/man1/vac.1 @@ -53,7 +53,7 @@ is used on a file tree that shares data with an existi storage will be approximately equal to an incremental backup. This reduction in storage consumption occurs transparently to the user. .PP -As an optimization, the +As an optimization, the .B -d and .B -q @@ -78,7 +78,8 @@ the files under an extra two levels of directory hiera .I yyyy/mmdd (year, month, day) in the style of the dump file system -(see Plan 9's \fIfs\fR(4)). +(see Plan 9's +.IR fs (4)). If .I vacfile already exists, an additional backup day is added to the @@ -89,7 +90,7 @@ Typically, this option is used as part of a nightly backup script. This option cannot be used with .B -d -or +or .BR -f . .TP .BI -b " blocksize @@ -114,13 +115,13 @@ Do not include the file or directory specified by This option may be repeated multiple times. .I Exclude can be a shell pattern as accepted by -.IR rc (1), -with one extension: +.IM rc (1) , +with one extension: .B \&... matches any sequence of characters including slashes. .TP .BI -f " vacfile -The results of +The results of .I vac are placed in .IR vacfile , @@ -136,7 +137,7 @@ The network address of the Venti server. The default is taken from the environment variable .BR venti . .\" If this variable does not exist, then the default is the -.\" metaname +.\" metaname .\" .BR $venti , .\" which can be configured via .\" .IR ndb (6). @@ -155,7 +156,7 @@ the archive to be unpacked. .TP .B -q Increase the performance of the -.B -a +.B -a or .B -d options by detecting unchanged files based on a match of the files name and other meta data, @@ -169,9 +170,9 @@ Produce more verbose output on standard error, includi and the vac archives that are expanded and merged. .TP .BI -x " excfile -Read exclude patterns from the file +Read exclude patterns from the file .IR excfile . -Blank lines and lines beginning with +Blank lines and lines beginning with .B # are ignored. All other lines should be of the form @@ -224,5 +225,5 @@ If listing files, print metadata in addition to the na .SH SOURCE .B \*9/src/cmd/vac .SH "SEE ALSO" -.IR vacfs (4), -.IR venti (8) +.IM vacfs (4) , +.IM venti (8) blob - e14052aa704929e69c0fe8500493072741db8b15 blob + 6231e40bae3a8e81672972c71a5129192150ded9 --- man/man1/venti.1 +++ man/man1/venti.1 @@ -40,7 +40,7 @@ read, write, copy \- simple Venti clients .SH DESCRIPTION Venti is a SHA1-addressed block storage server. See -.IR venti (7) +.IM venti (7) for a full introduction. .PP .I Read @@ -167,13 +167,13 @@ messages send/received. .SH SOURCE .B \*9/src/cmd/venti .SH SEE ALSO -.IR vac (1), -.IR venti (3), -.IR vacfs (4), -.IR venti (7), -.IR vbackup (8), -.IR venti (8), -.IR venti-fmt (8) +.IM vac (1) , +.IM venti (3) , +.IM vacfs (4) , +.IM venti (7) , +.IM vbackup (8) , +.IM venti (8) , +.IM venti-fmt (8) .SH BUGS There should be programs to read and write venti files and directories. blob - 06d304df1132416c78cbdcfa49e5c8750e8e8dcf blob + 1abdcc009f8d0c8c49d4ceda34aacfefbf242880 --- man/man1/web.1 +++ man/man1/web.1 @@ -81,7 +81,7 @@ URL passed to and .I wmail are invoked as start commands in the -.IR plumber (4)'s +.IM plumber (4) 's rules for opening web pages and writing mail messages. .SH FILES .TP @@ -93,4 +93,4 @@ and .SH SOURCE .B \*9/bin .SH SEE ALSO -.IR plumber (4) +.IM plumber (4) blob - 966b307b48a65ccfba3dae8b28e42d0b645b6e03 blob + 269db2e0e514d284d9d2594dffff3b97340ab346 --- man/man1/wintext.1 +++ man/man1/wintext.1 @@ -22,11 +22,11 @@ wintext, ", "" \- access text in current window prints the text of the current .I win (see -.IR acme (1)), -.IR 9term (1), +.IM acme (1) ), +.IM 9term (1) , or (Unix's) -.IR tmux (1) +.IM tmux (1) window to standard output. .PP .I \*y @@ -43,7 +43,7 @@ prints the last command executed. prints the last command that .I \*y would print and then executes it by piping it into -.IR rc (1). +.IM rc (1) . .PP Both .I \*y @@ -61,7 +61,7 @@ or .BR # . .SH EXAMPLES Print the -.IR ls (1) +.IM ls (1) and .I lc commands executed in this window: @@ -87,8 +87,8 @@ ramfs rc read rio rm % .EE .SH SEE ALSO -.IR 9term (1), -.IR acme (1) +.IM 9term (1) , +.IM acme (1) .SH SOURCE .B \*9/bin .SH BUGS @@ -96,5 +96,5 @@ ramfs rc read rio rm and .I \*(yy are hard to type in shells other than -.IR rc (1). +.IM rc (1) . .\" and in troff! blob - afbf541daa67973756e41247875134fd1e3dda22 blob + fc4afbacf64dc260f57a3f8a516062699ba3a54d --- man/man1/winwatch.1 +++ man/man1/winwatch.1 @@ -17,7 +17,7 @@ winwatch \- monitor rio windows .SH DESCRIPTION .I Winwatch displays the labels of all current -.IR rio (1) +.IM rio (1) windows, refreshing the display every second. Right clicking a window's label unhides, raises and gives focus to that window. Typing @@ -53,5 +53,5 @@ Excluding winwatch and stats from being shown. .SH SOURCE .B \*9/src/cmd/winwatch.c .SH SEE ALSO -.IR rio (1), -.IR regexp (7). +.IM rio (1) , +.IM regexp (7) . blob - 5ec167bdc6a0d2c6639b8b620022f745f397cf91 blob + d291210b4525fb34477c1033833e58168fd236ae --- man/man1/xd.1 +++ man/man1/xd.1 @@ -91,7 +91,7 @@ followed by an asterisk. .SH SOURCE .B \*9/src/cmd/xd.c .SH "SEE ALSO" -.IR db (1) +.IM db (1) .SH BUGS The various output formats don't line up properly in the output of .IR xd . blob - cbd1eb73ad3c880bca697e547be296500814e178 blob + 3fbd47c2dccffbab07457228fecf98cf62f687a5 --- man/man1/yacc.1 +++ man/man1/yacc.1 @@ -23,7 +23,7 @@ to produce a program This program must be loaded with a lexical analyzer function, .B yylex(void) (often generated by -.IR lex (1)), +.IM lex (1) ), with a .B main(int argc, char *argv[]) program, and with an error handling routine, @@ -115,7 +115,7 @@ option reverses this. The parser accepts .SM UTF input text (see -.IR utf (7)), +.IM utf (7) ), which has a couple of effects. First, the return value of .B yylex() @@ -156,7 +156,7 @@ parser prototype using stdio .SH SOURCE .B \*9/src/cmd/yacc.c .SH "SEE ALSO" -.IR lex (1) +.IM lex (1) .br S. C. Johnson and R. Sethi, ``Yacc: A parser generator'', blob - 665c7b22134210760b9ff3dce27fe48df553dd8c blob + f18cf375676807efb3840893e00bb516c36c3892 --- man/man1/yesterday.1 +++ man/man1/yesterday.1 @@ -91,8 +91,8 @@ by convention, root of the dump file system .SH SOURCE .B \*9/bin/yesterday .SH SEE ALSO -.IR diff (1), -.IR hist (1), -.IR vbackup (8) +.IM diff (1) , +.IM hist (1) , +.IM vbackup (8) .SH BUGS It's hard to use this command without singing. blob - e544cc8d8b2e5a6204ef854b6acf444aae8a3018 blob + 0fe209c68706cb59fbaa2dd803f764706d986107 --- man/man3/0intro.3 +++ man/man3/0intro.3 @@ -49,7 +49,7 @@ automatically, so it is rarely necessary to tell the l which libraries a program needs; see -.IR 9c (1). +.IM 9c (1) . .PP The library to which a function belongs is defined by the header file that defines its interface. @@ -121,7 +121,7 @@ and plus macros that define the layout of .IR jmp_buf (see -.IR setjmp (3)); +.IM setjmp (3) ); .\" definitions of the bits in the floating-point control register .\" as used by .\" .IR getfcr (2); @@ -198,27 +198,27 @@ by or .I create (see -.IR open (3)). +.IM open (3) ). These calls return an integer called a .IR "file descriptor" which identifies the file to subsequent I/O calls, notably -.IR read (3) +.IM read (3) and .IR write . The system allocates the numbers by selecting the lowest unused descriptor. They are allocated dynamically; there is no visible limit to the number of file descriptors a process may have open. They may be reassigned using -.IR dup (3). +.IM dup (3) . File descriptors are indices into a kernel resident .IR "file descriptor table" . Each process has an associated file descriptor table. In threaded programs (see -.IR thread (3)), +.IM thread (3) ), the file descriptor table is shared by all the procs. .PP By convention, @@ -236,22 +236,22 @@ Files are normally read or written in sequential order The I/O position in the file is called the .IR "file offset" and may be set arbitrarily using the -.IR seek (3) +.IM seek (3) system call. .PP Directories may be opened like regular files. Instead of reading them with -.IR read (3), +.IM read (3) , use the .B Dir structure-based routines described in -.IR dirread (3). +.IM dirread (3) . The entry corresponding to an arbitrary file can be retrieved by .IR dirstat (see -.IR stat (3)) +.IM stat (3) ) or .IR dirfstat ; .I dirwstat @@ -262,9 +262,9 @@ write back entries, thus changing the properties of a New files are made with .I create (see -.IR open (3)) +.IM open (3) ) and deleted with -.IR remove (3). +.IM remove (3) . Directories may not directly be written; .IR create , .IR remove , @@ -273,27 +273,27 @@ and .I fwstat alter them. .PP -.IR Pipe (3) +.IM Pipe (3) creates a connected pair of file descriptors, useful for bidirectional local communication. .SS "Process execution and control" A new process is created when an existing one calls -.IR fork (2). +.IM fork (2) . The new (child) process starts out with copies of the address space and most other attributes of the old (parent) process. In particular, the child starts out running the same program as the parent; -.IR exec (3) +.IM exec (3) will bring in a different one. .PP Each process has a unique integer process id; a set of open files, indexed by file descriptor; and a current working directory (changed by -.IR chdir (2)). +.IM chdir (2) ). .PP Each process has a set of attributes \(em memory, open files, name space, etc. \(em that may be shared or unique. @@ -302,9 +302,9 @@ Flags to control the sharing of these attributes. .PP A process terminates by calling -.IR exits (3). +.IM exits (3) . A parent process may call -.IR wait (3) +.IM wait (3) to wait for some child to terminate. A bit of status information may be passed from @@ -317,14 +317,14 @@ The Plan 9 interface persists here, although the funct Instead, empty strings are converted to exit status 0 and non-empty strings to 1. .PP A process can go to sleep for a specified time by calling -.IR sleep (3). +.IM sleep (3) . .PP There is a .I notification mechanism for telling a process about events such as address faults, floating point faults, and messages from other processes. A process uses -.IR notify (3) +.IM notify (3) to register the function to be called (the .IR "notification handler" ) when such events occur. @@ -334,12 +334,12 @@ the main C library works properly in multiprocess prog .IR malloc , .IR print , and the other routines use locks (see -.IR lock (3)) +.IM lock (3) ) to synchronize access to their data structures. The graphics library defined in .B is also multi-process capable; details are in -.IR graphics (3). +.IM graphics (3) . In general, though, multiprocess programs should use some form of synchronization to protect shared data. .PP @@ -365,12 +365,12 @@ Therefore, a program that shouldn't block unexpectedly to serve the I/O request, passing the result to the main processes over a channel when the request completes. For examples of this design, see -.IR ioproc (3) +.IM ioproc (3) or -.IR mouse (3). +.IM mouse (3) . .SH SEE ALSO .IR nm (1), -.IR 9c (1) +.IM 9c (1) .SH DIAGNOSTICS Math functions in .I libc @@ -378,14 +378,14 @@ return special values when the function is undefined for the given arguments or when the value is not representable (see -.IR nan (3)). +.IM nan (3) ). .PP Some of the functions in .I libc are system calls and many others employ system calls in their implementation. All system calls return integers, with \-1 indicating that an error occurred; -.IR errstr (3) +.IM errstr (3) recovers a string describing the error. Some user-level library functions also use the .I errstr blob - 6aca825bb8cd62b132bf13f57cddfe710b0ad41e blob + 804f6332cf093b0dbf26592f18dd498cff4cd0e1 --- man/man3/9p-cmdbuf.3 +++ man/man3/9p-cmdbuf.3 @@ -44,7 +44,7 @@ bytes at using .I tokenize (see -.IR getfields (3)). +.IM getfields (3) ). It returns a .B Cmdbuf structure holding pointers to each field in the message. @@ -116,4 +116,4 @@ is a good example. .SH SOURCE .B \*9/src/lib9p/parse.c .SH SEE ALSO -.IR 9p (3) +.IM 9p (3) blob - ddc3e093cd043547e6d4ef5ee688a2a879fa96d4 blob + b87ea2538edb817de754ec19402b96a0af24aa0d --- man/man3/9p-fid.3 +++ man/man3/9p-fid.3 @@ -73,7 +73,7 @@ and .BR Reqpool s. They are primarily used by the 9P server loop described in -.IR 9p (3). +.IM 9p (3) . .PP .B Fid structures are intended to represent @@ -115,7 +115,7 @@ element points at a .B File structure (see -.IR 9p-file (3)) +.IM 9p-file (3) ) corresponding to the fid. The .B aux @@ -200,5 +200,5 @@ structures. .SH SOURCE .B \*9/src/lib9p .SH SEE ALSO -.IR 9p (3), -.IR 9p-file (3) +.IM 9p (3) , +.IM 9p-file (3) blob - 80866177dae27cee4a30edd8c5ffb9d6a1aaffde blob + 52c19bfdf8240d7d9b77769ee34c9240d568db67 --- man/man3/9p-file.3 +++ man/man3/9p-file.3 @@ -144,7 +144,7 @@ When creating new file references by copying pointers, call .I incref (see -.IR lock (3)) +.IM lock (3) ) to update the reference count. To note the removal of a reference to a file, call .IR closefile . @@ -218,6 +218,6 @@ return nf; .SH SOURCE .B \*9/src/lib9p/file.c .SH SEE ALSO -.IR 9p (3) +.IM 9p (3) .SH BUGS The reference counting is cumbersome. blob - 9d4dfef0b7f020f50fab9628dd998476bd8773ba blob + 7e7db303f1c9bd8f3dbd72e6c28d9e92e4a54b1d --- man/man3/9p-intmap.3 +++ man/man3/9p-intmap.3 @@ -122,5 +122,5 @@ and .SH SOURCE .B \*9/src/lib9p/intmap.c .SH SEE ALSO -.IR 9p (3), -.IR 9p-fid (3) +.IM 9p (3) , +.IM 9p-fid (3) blob - 6dc4c9c1767e7a6a923812e7146226a2d0300a37 blob + eac5a3d60fe767afee55315531da68e5262c169d --- man/man3/9p.3 +++ man/man3/9p.3 @@ -110,13 +110,13 @@ and .B Fid structures are allocated one-to-one with uncompleted requests and active fids, and are described in -.IR 9p-fid (3). +.IM 9p-fid (3) . .PP The behavior of .I srv depends on whether there is a file tree (see -.IR 9p-file (3)) +.IM 9p-file (3) ) associated with the server, that is, whether the .B tree @@ -178,11 +178,11 @@ as .BI /srv/ name . .IP Fork a child process via -.IR rfork (3) +.IM rfork (3) or .I procrfork (see -.IR thread (3)), +.IM thread (3) ), using the .BR RFFDG , .RR RFNOTEG , @@ -214,7 +214,7 @@ The parent returns to the caller. .LP If any error occurs during this process, the entire process is terminated by calling -.IR sysfatal (3). +.IM sysfatal (3) . .SS Service functions The functions in a .B Srv @@ -332,7 +332,7 @@ where is the program name variable as set by .I ARGBEGIN (see -.IR arg (3)). +.IM arg (3) ). .TP .I Attach The @@ -707,7 +707,7 @@ the service loop (which runs in a separate process from its caller) terminates using .I _exits (see -.IR exits (3)). +.IM exits (3) ). .PD .PP If the @@ -752,6 +752,6 @@ or is maintained elsewhere. .SH SOURCE .B \*9/src/lib9p .SH SEE ALSO -.IR 9p-fid (3), -.IR 9p-file (3), +.IM 9p-fid (3) , +.IM 9p-file (3) , .IR intro (9p) blob - 1bb868cced37d3dd4d76cf72a88525d29f9cdd20 blob + a4c80d8bea332abcebe06a6d6a7f32673efaeabf --- man/man3/9pclient.3 +++ man/man3/9pclient.3 @@ -149,7 +149,7 @@ connects to a service named .I name in the current name space directory (see -.IR intro (4)). +.IM intro (4) ). Both attach to the root of the file system using the attach name .IR aname . @@ -228,7 +228,7 @@ the allocated structures will be freed and the file descriptor corresponding to the connection will be closed (see -.IR close (2)). +.IM close (2) ). Fids are not reference counted: when .I fsclose is called, the clunk transaction and freeing of storage @@ -308,7 +308,7 @@ sets the offset; the and .I type arguments are used as in -.IR seek (3). +.IM seek (3) . Calling .I fspread or @@ -340,7 +340,7 @@ for the given fid. .PP .I Fsaccess behaves like Unix's -.IR access (2). +.IM access (2) . .I Fsremove removes the named path. .I Fsfremove @@ -358,7 +358,7 @@ are like and .I vfprint (see -.IR print (3)) +.IM print (3) ) but write to .BR CFid* s. .PP @@ -376,7 +376,7 @@ is similar but reads the entire directory. The returned pointer should be freed with .I free (see -.IR malloc (3)) +.IM malloc (3) ) when no longer needed. .PP .I Fsdirfstat @@ -396,7 +396,7 @@ structure returned by should be freed with .I free (see -.IR malloc (3)) +.IM malloc (3) ) when no longer needed. .PP .I Fsdirstat @@ -418,7 +418,7 @@ opens a file on the 9P server for reading or writing but returns a Unix file descriptor instead of a fid structure. The file descriptor is actually one end of a -.IR pipe (2). +.IM pipe (2) . A proxy process on the other end is ferrying data between the pipe and the 9P fid. Because of the implementation as a pipe, @@ -443,18 +443,18 @@ If the flag is set, the library calls .I threadexitsall (see -.IR thread (3)) +.IM thread (3) ) when it detects EOF on a 9P connection. .SH SOURCE .B \*9/src/lib9pclient .SH SEE ALSO -.IR intro (4), +.IM intro (4) , .IR intro (9p), .I fsaopen and .I nsaopen in -.IR auth (3) +.IM auth (3) .SH BUGS The implementation should use a special version string to distinguish between blob - 1683061a191202920b60434e894828512f9e51d2 blob + d2f116ae691aa1564e4c783bcba1ba06cb6732d8 --- man/man3/acme.3 +++ man/man3/acme.3 @@ -141,7 +141,7 @@ char* evsmprint(char *fmt, va_list arg) .SH DESCRIPTION .I Libacme provides a simple C interface for interacting with -.IR acme (1) +.IM acme (1) windows. .PP A @@ -168,7 +168,7 @@ Most of the library routines access files in the windo .I acme directory. See -.IR acme (4) +.IM acme (4) for details. Many library routines take a format string .I fmt @@ -179,11 +179,11 @@ denotes the result of formatting the string and argume using .I smprint (see -.IR print (3)). +.IM print (3) ). .PP .I Pipetowin runs the -.IR rc (1) +.IM rc (1) command line .I fmt\fR, \fP... with @@ -199,7 +199,7 @@ Otherwise the command inherits the caller's standard e .PP .I Pipewinto runs the -.IR rc (1) +.IM rc (1) command line .I fmt\fR, \fP... with the window's @@ -300,7 +300,7 @@ to position relative to .I type (see -.IR seek (3)). +.IM seek (3) ). .PP .I Winwrite writes the @@ -317,7 +317,7 @@ The fields correspond to the fields in .IR acme 's event messages. See -.IR acme (4) +.IM acme (4) for detailed explanations. The fields are: .TP @@ -384,7 +384,7 @@ that it should be handled internally. returns a pointer to a .B Channel (see -.IR thread (3)) +.IM thread (3) ) on which event structures (not pointers) can be read. The first call to .I wineventchan @@ -404,20 +404,20 @@ after calling and .I evsmprint are like -.IR malloc (3), +.IM malloc (3) , .IR realloc , .IR strdup (see -.IR strcat (3)), +.IM strcat (3) ), and .IR vsmprint (see -.IR print (3)), +.IM print (3) ), but they call -.IR sysfatal (3) +.IM sysfatal (3) on error rather than returning nil. .SH SOURCE .B \*9/src/libacme .SH SEE ALSO -.IR acme (1), -.IR acme (4) +.IM acme (1) , +.IM acme (4) blob - c00a1de1ce563d3f0991d947238d26ff33dbf627 blob + 5a22abeb3a4ac11836fdcb0339e44a6841079976 --- man/man3/addpt.3 +++ man/man3/addpt.3 @@ -185,4 +185,4 @@ They are implemented as macros. .SH SOURCE .B \*9/src/libdraw .SH SEE ALSO -.IR graphics (3) +.IM graphics (3) blob - 06f42de54af7aa9a22702f2c41881a31142c5c1a blob + c9c74155bfc41f5f89eb941c7bed292e4937b3e2 --- man/man3/aes.3 +++ man/man3/aes.3 @@ -39,13 +39,13 @@ cryptographically strongly unpredictable. .SH SOURCE .B \*9/src/libsec .SH SEE ALSO -.IR mp (3), -.IR blowfish (3), -.IR des (3), -.IR dsa (3), -.IR elgamal (3), -.IR rc4 (3), -.IR rsa (3), -.IR sechash (3), -.IR prime (3), -.IR rand (3) +.IM mp (3) , +.IM blowfish (3) , +.IM des (3) , +.IM dsa (3) , +.IM elgamal (3) , +.IM rc4 (3) , +.IM rsa (3) , +.IM sechash (3) , +.IM prime (3) , +.IM rand (3) blob - 8bfd323dc5f81c9e3f89ff92d557f547b75caeef blob + 72ee805e603cb5c729a7a515bb9ff3ce4c776997 --- man/man3/allocimage.3 +++ man/man3/allocimage.3 @@ -135,7 +135,7 @@ The field will have been set to the identifying number used by .B /dev/draw (see -.IR draw (3)), +.IM draw (3) ), and the .I cache field will be zero. @@ -148,7 +148,7 @@ The field will be set to the number of bits per pixel specified by the channel descriptor (see -.IR image (7)). +.IM image (7) ). .I Allocimage returns 0 if the server has run out of image memory. .PP @@ -191,7 +191,7 @@ These routines permit unrelated applications sharing a for example they provide the mechanism behind .B getwindow (see -.IR graphics (3)). +.IM graphics (3) ). .PP The RGB values in a color are .I premultiplied @@ -214,7 +214,7 @@ values between image and user space or external files. There is a fixed format for the exchange and storage of image data (see -.IR image (7)). +.IM image (7) ). .PP .I Unloadimage reads a rectangle of pixels from image @@ -271,7 +271,7 @@ but for bytes of compressed image .I data (see -.IR image (7)). +.IM image (7) ). On each call to .IR cloadimage, the @@ -289,7 +289,7 @@ return the number of bytes copied. .PP .I Readimage creates an image from data contained in an external file (see -.IR image (7) +.IM image (7) for the file format); .I fd is a file descriptor obtained by opening such a file for reading. @@ -333,10 +333,10 @@ To allocate a single-pixel replicated image that may b .SH SOURCE .B \*9/src/libdraw .SH "SEE ALSO" -.IR graphics (3), -.IR draw (3), -.IR draw (3), -.IR image (7) +.IM graphics (3) , +.IM draw (3) , +.IM draw (3) , +.IM image (7) .SH DIAGNOSTICS These functions return pointer 0 or integer \-1 on failure, usually due to insufficient memory. blob - 3124930dcd060a76322dbe03333f1dcf1812f2dc blob + 1d6dbab1584e3f882a711248f749f55a13d85539 --- man/man3/arg.3 +++ man/man3/arg.3 @@ -20,7 +20,7 @@ These macros assume the names and .I argv are in scope; see -.IR exec (3). +.IM exec (3) . .I ARGBEGIN and .I ARGEND @@ -58,7 +58,7 @@ but instead of returning zero runs .I code and, if that returns, calls -.IR abort (3). +.IM abort (3) . A typical value for .I code is blob - 1e764c7b91d5403c57386f58cf22c6a44ca0d3a0 blob + 198cce35fee755de467b4f59aac4b2faec4202f5 --- man/man3/arith3.3 +++ man/man3/arith3.3 @@ -266,4 +266,4 @@ Subtract the coordinates of two points. .SH SOURCE .B \*9/src/libgeometry .SH "SEE ALSO -.IR matrix (3) +.IM matrix (3) blob - 0da223796cde84666291a3d225430de93148eb17 blob + ce2ca723e70502c568a530f64a6f70ef3671d0d8 --- man/man3/atof.3 +++ man/man3/atof.3 @@ -129,7 +129,7 @@ after calling .SH SOURCE .B \*9/src/lib9 .SH SEE ALSO -.IR fscanf (3) +.IM fscanf (3) .SH DIAGNOSTICS Zero is returned if the beginning of the input string is not interpretable as a number; even in this case, @@ -175,4 +175,4 @@ are preprocessor macros defined as and .IR p9atoll ; see -.IR intro (3). +.IM intro (3) . blob - 24189822e4ea818256778ffe84ccfcced542da93 blob + 747b9555d2adbe7836567768df0263418cab332c --- man/man3/auth.3 +++ man/man3/auth.3 @@ -95,7 +95,7 @@ CFsys* nsamount(char *name, char *aname); .SH DESCRIPTION .PP This library, in concert with -.IR factotum (4), +.IM factotum (4) , is used to authenticate users. It provides the primary interface to .IR factotum . @@ -168,7 +168,7 @@ It provides the primary interface to The following routines use the .B AuthInfo structure returned after a successful authentication by -.IR factotum (4). +.IM factotum (4) . .PP .ne 8 .EX @@ -212,11 +212,11 @@ file, as opened by An .B sprint (see -.IR print (3)) +.IM print (3) ) of .I fmt and the variable arg list yields a key template (see -.IR factotum (4)) +.IM factotum (4) ) specifying the key to use. The template must specify at least the protocol ( .BI proto= xxx ) @@ -258,7 +258,7 @@ arranges a connection to either by opening .B /mnt/factotum/rpc or by using -.IR 9pclient (3) +.IM 9pclient (3) to connect to a .B factotum service posted in the current name space. @@ -266,7 +266,7 @@ The returned connection is freed using .IR auth_freerpc . Individual commands can be sent to -.IR factotum (4) +.IM factotum (4) by invoking .IR auth_rpc . .PP @@ -418,7 +418,7 @@ and but execute the protocol on a .B CFid* (see -.IR 9pclient (3)) +.IM 9pclient (3) ) instead of a file descriptor. .PP .I Fsamount @@ -429,15 +429,15 @@ are like and .I nsmount (see -.IR 9pclient (3)) +.IM 9pclient (3) ) but use .I factotum to authenticate to the file servers. .SH SOURCE .B \*9/src/libauth .SH SEE ALSO -.IR factotum (4), -.IR authsrv (3) +.IM factotum (4) , +.IM authsrv (3) .SH DIAGNOSTICS These routines set .IR errstr . blob - a0b68578e41cbc7364ee8bbdff67f52f451fb777 blob + 2b2113bc287f205eb3c6b1fc7f61dcd3e4d373ae --- man/man3/authsrv.3 +++ man/man3/authsrv.3 @@ -68,7 +68,7 @@ If is non-nil, the network database (see -.IR ndb (1)) +.IM ndb (1) ) is queried for an entry which contains .B authdom=\fIad\fP or @@ -212,10 +212,10 @@ to recieve an answer. .SH SOURCE .B \*9/src/libauthsrv .SH SEE ALSO -.IR passwd (1), -.IR dial (3), +.IM passwd (1) , +.IM dial (3) , Plan 9's -\fIauthsrv\fR(6). +.IR authsrv (6). .SH DIAGNOSTICS These routines set .IR errstr . blob - c888193f81c1e229fa77d18bdf377dd54234dcc3 blob + 3ab9ba90c5a5211ff682a271bdaa673ac8d6183e --- man/man3/bin.3 +++ man/man3/bin.3 @@ -82,7 +82,7 @@ are ignored, and the result is the same as calling and .I bingrow allocate large chunks of memory using -.IR malloc (3) +.IM malloc (3) and return pieces of these chunks. The chunks are .IR free 'd @@ -91,7 +91,7 @@ upon a call to .SH SOURCE .B \*9/src/libbin .SH SEE ALSO -.IR malloc (3) +.IM malloc (3) .SH DIAGNOSTICS .I binalloc and blob - 0c48bea6e135321f1614ee0b1b3a29de7e733d12 blob + 1f7b822129de603b33e7e6801b1977fbdedd21a9 --- man/man3/bio.3 +++ man/man3/bio.3 @@ -93,7 +93,7 @@ for mode or creates for mode .BR OWRITE . It calls -.IR malloc (3) +.IM malloc (3) to allocate a buffer. .PP .I Bfdopen @@ -104,7 +104,7 @@ for mode or .BR OWRITE . It calls -.IR malloc (3) +.IM malloc (3) to allocate a buffer. .PP .I Binit @@ -173,7 +173,7 @@ of the most recent string returned by .PP .I Brdstr returns a -.IR malloc (3)-allocated +.IM malloc (3) -allocated buffer containing the next line of input delimited by .IR delim , terminated by a NUL (0) byte. @@ -225,7 +225,7 @@ may back up a maximum of five bytes. uses .I charstod (see -.IR atof (3)) +.IM atof (3) ) and .I Bgetc to read the formatted @@ -246,7 +246,7 @@ and a negative value is returned if a read error occur .PP .I Bseek applies -.IR seek (3) +.IM seek (3) to .IR bp . It returns the new file offset. @@ -278,7 +278,7 @@ on the output stream. .PP .I Bprint is a buffered interface to -.IR print (3). +.IM print (3) . If this causes a .IR write to occur and there is an error, @@ -325,10 +325,10 @@ written. .SH SOURCE .B \*9/src/libbio .SH SEE ALSO -.IR open (3), -.IR print (3), -.IR exits (3), -.IR utf (7), +.IM open (3) , +.IM print (3) , +.IM exits (3) , +.IM utf (7) , .SH DIAGNOSTICS .I Bio routines that return integers yield blob - 20d43f6627fdf767f448a0b7c1cabfc87cd2df00 blob + 2ae83f4d37cd10a92d07240f4c70aba602bb70c2 --- man/man3/blowfish.3 +++ man/man3/blowfish.3 @@ -40,13 +40,13 @@ must be a multiple of eight bytes as padding is curren .SH SOURCE .B \*9/src/libsec .SH SEE ALSO -.IR mp (3), -.IR aes (3), -.IR des (3), -.IR dsa (3), -.IR elgamal (3), -.IR rc4 (3), -.IR rsa (3), -.IR sechash (3), -.IR prime (3), -.IR rand (3) +.IM mp (3) , +.IM aes (3) , +.IM des (3) , +.IM dsa (3) , +.IM elgamal (3) , +.IM rc4 (3) , +.IM rsa (3) , +.IM sechash (3) , +.IM prime (3) , +.IM rand (3) blob - f2d82f1905711bd066525f0ca13645330be4ad68 blob + 95b172e924087272f3cebb96b70fd08d3e722249 --- man/man3/cachechars.3 +++ man/man3/cachechars.3 @@ -30,7 +30,7 @@ A may contain too many characters to hold in memory simultaneously. The graphics library and draw device (see -.IR draw (3)) +.IM draw (3) ) cooperate to solve this problem by maintaining a cache of recently used character images. The details of this cooperation need not be known by most programs: @@ -127,7 +127,7 @@ A .B Font consists of an overall height and ascent and a collection of subfonts together with the ranges of runes (see -.IR utf (7)) +.IM utf (7) ) they represent. Fonts are described by the following structures. .IP @@ -181,7 +181,7 @@ The and .LR ascent fields of Font are described in -.IR graphics (3). +.IM graphics (3) . .L Sub contains .L nsub @@ -302,12 +302,12 @@ for replacement when the cache is full. .SH SOURCE .B \*9/src/libdraw .SH SEE ALSO -.IR graphics (3), -.IR allocimage (3), -.IR draw (3), -.IR subfont (3), -.IR image (7), -.IR font (7) +.IM graphics (3) , +.IM allocimage (3) , +.IM draw (3) , +.IM subfont (3) , +.IM image (7) , +.IM font (7) .SH DIAGNOSTICS All of the functions use the graphics error function (see -.IR graphics (3)). +.IM graphics (3) ). blob - efb7d8231c1abb6cf0166e21e575538f47369e3a blob + 8486cd90fd4a665daad1f5d3bc9cc00e35166f8a --- man/man3/cleanname.3 +++ man/man3/cleanname.3 @@ -31,4 +31,4 @@ must contain room for at least two bytes. .SH SOURCE .B \*9/src/lib9/cleanname.c .SH SEE ALSO -.IR cleanname (1) +.IM cleanname (1) blob - 5428337b37ef80e92bf1306ac6c0bacb97deb8c8 blob + 0c1b88213e8c0a10d9b370a6e521dd59ee5012c2 --- man/man3/color.3 +++ man/man3/color.3 @@ -19,7 +19,7 @@ int cmap2rgba(int col) .SH DESCRIPTION These routines convert between `true color' red/green/blue triples and the Plan 9 color map. See -.IR color (7) +.IM color (7) for a description of RGBV, the standard color map. .PP .I Rgb2cmap @@ -41,16 +41,16 @@ and the next 8 representing blue, then green, then red .I cmap2rgba shifted up 8 bits. This 32-bit representation is the format used by -.IR draw (3) +.IM draw (3) and -.IR memdraw (3) +.IM memdraw (3) library routines that take colors as arguments. .SH SOURCE .B \*9/src/libdraw .SH SEE ALSO -.IR graphics (3), -.IR allocimage (3), -.IR draw (3), -.IR image (7), -.IR color (7) +.IM graphics (3) , +.IM allocimage (3) , +.IM draw (3) , +.IM image (7) , +.IM color (7) blob - 52702acca8a964334e84f37c97cfb5dfe834b01f blob + b0f9fcea8620c4ecfec3ffa236eb0c5b54b235ec --- man/man3/complete.3 +++ man/man3/complete.3 @@ -86,15 +86,15 @@ function frees a structure and its contents. .PP In -.IR rio (1) +.IM rio (1) and -.IR acme (1), +.IM acme (1) , file name completion is triggered by a control-F character or an Insert character. .SH SOURCE .B \*9/src/libcomplete .SH SEE ALSO -.IR rio (1), -.IR acme (1) +.IM rio (1) , +.IM acme (1) .SH DIAGNOSTICS The .I complete blob - 5491d39fd7d5cfe4f390f7ab68fee719e25cb302 blob + db6591343a276180685f2a461fb1f93061b8f0f6 --- man/man3/ctime.3 +++ man/man3/ctime.3 @@ -26,7 +26,7 @@ long tm2sec(Tm *tm) converts a time .I clock such as returned by -.IR time (3) +.IM time (3) into .SM ASCII (sic) @@ -85,8 +85,8 @@ is not .br .B \*9/src/lib9/tm2sec.c .SH "SEE ALSO" -.IR date (1), -.IR time (3) +.IM date (1) , +.IM time (3) .SH BUGS The return values point to static data whose content is overwritten by each call. @@ -112,4 +112,4 @@ are preprocessor macros defined as and .IR p9tm2sec ; see -.IR intro (3). +.IM intro (3) . blob - 3c3cd20148056f63410c511bcf2daa90d7977407 blob + 5381f2e378dba48a4151dc941410b07b186a38e6 --- man/man3/des.3 +++ man/man3/des.3 @@ -132,13 +132,13 @@ using .SH SOURCE .B \*9/src/libsec .SH SEE ALSO -.IR mp (3), -.IR aes (3), -.IR blowfish (3), -.IR dsa (3), -.IR elgamal (3), -.IR rc4 (3), -.IR rsa (3), -.IR sechash (3), -.IR prime (3), -.IR rand (3) +.IM mp (3) , +.IM aes (3) , +.IM blowfish (3) , +.IM dsa (3) , +.IM elgamal (3) , +.IM rc4 (3) , +.IM rsa (3) , +.IM sechash (3) , +.IM prime (3) , +.IM rand (3) blob - 39092ae098818ef791bc1668117a63c2e7460718 blob + f34b1c54d37a84fff303d752f68105bc86721cd3 --- man/man3/dial.3 +++ man/man3/dial.3 @@ -264,7 +264,7 @@ int callkremvax(void) .EE .PP Connect to a Unix socket served by -.IR acme (4): +.IM acme (4) : .IP .EX int dialacme(void) @@ -346,4 +346,4 @@ are preprocessor macros defined as .IR p9announce , and so on; see -.IR intro (3). +.IM intro (3) . blob - 2522e9a6908ccfb4df6cdd4a61c527233b5feade blob + b0386a23a32b326acdad0d3beb30d1d3f780a27a --- man/man3/dirread.3 +++ man/man3/dirread.3 @@ -19,11 +19,11 @@ long dirreadall(int fd, Dir **buf) #define DIRMAX (sizeof(Dir)+STATMAX) .SH DESCRIPTION The data returned by a -.IR read (3) +.IM read (3) on a directory is a set of complete directory entries in a machine-independent format, exactly equivalent to the result of a -.IR stat (3) +.IM stat (3) on each file or subdirectory in the directory. .I Dirread decodes the directory entries into a machine-dependent form. @@ -35,11 +35,11 @@ structures whose address is returned in .B *buf (see -.IR stat (3) +.IM stat (3) for the layout of a .BR Dir ). The array is allocated with -.IR malloc (3) +.IM malloc (3) each time .I dirread is called. @@ -50,7 +50,7 @@ is like but reads in the entire directory; by contrast, .I dirread steps through a directory one -.IR read (3) +.IM read (3) at a time. .PP Directory entries have variable length. @@ -85,9 +85,9 @@ The file offset is advanced by the number of bytes act .SH SOURCE .B \*9/src/lib9/dirread.c .SH SEE ALSO -.IR intro (3), -.IR open (3), -.IR read (3) +.IM intro (3) , +.IM open (3) , +.IM read (3) .SH DIAGNOSTICS .I Dirread and blob - 1fa5dea1da9176cb8d7a5beeb5df4d46be20de36 blob + c91ab541fc62f68467b15a6a5e8e23d188200194 --- man/man3/draw.3 +++ man/man3/draw.3 @@ -259,7 +259,7 @@ The clipping region may be modified dynamically using .TP .B chan The pixel channel format descriptor, as described in -.IR image (7). +.IM image (7) . The value should not be modified after the image is created. .TP .B depth @@ -268,7 +268,7 @@ number of bits per pixel in the picture; it is identically .B chantodepth(chan) (see -.IR graphics (3)) +.IM graphics (3) ) and is provided as a convenience. The value should not be modified after the image is created. .TP @@ -712,7 +712,7 @@ what is to .B atan (see -.IR sin (3)). +.IM sin (3) ). .TP .BI border( dst\fP,\fP\ r\fP,\fP\ i\fP,\fP\ color\fP,\fP\ sp\fP) .I Border @@ -810,11 +810,11 @@ is non-zero. .SH SOURCE .B \*9/src/libdraw .SH SEE ALSO -.IR graphics (3), -.IR stringsize (3), -.IR color (7), -.IR utf (7), -.IR addpt (3) +.IM graphics (3) , +.IM stringsize (3) , +.IM color (7) , +.IM utf (7) , +.IM addpt (3) .PP T. Porter, T. Duff. ``Compositing Digital Images'', blob - 1c8d376b127b442b008e127c22a6db0b684d7d3e blob + ecdc272ae0f81b1fe5e094390bbb053044ccaa1c --- man/man3/drawfcall.3 +++ man/man3/drawfcall.3 @@ -30,15 +30,15 @@ int readwsysmsg(int fd, uchar *buf, uint nbuf) uint sizeW2M(Wsysmsg *w) .SH DESCRIPTION These routines are analogues of the routines described in -.IR fcall (3). +.IM fcall (3) . They manipulate graphics device protocol messages rather than 9P protocol messages. The graphics device protocol is used for internal communication between the -.IR devdraw (1) +.IM devdraw (1) graphics server and the -.IR draw (3) +.IM draw (3) library. A .B Wsysmsg @@ -48,6 +48,6 @@ The protocol is intentionally undocumented and may cha .SH SOURCE .B \*9/src/libdraw/drawfcall.c .SH SEE ALSO -.IR devdraw (1), -.IR draw (3), -.IR graphics (3) +.IM devdraw (1) , +.IM draw (3) , +.IM graphics (3) blob - 41532b89ee32a6533185f19c97f2911a9259f951 blob + 0a3c34a12a4f525869ece192987e20bbce011c0e --- man/man3/dsa.3 +++ man/man3/dsa.3 @@ -84,7 +84,7 @@ and generated by .IR DSAprimes (see -.IR prime (3)). +.IM prime (3) ). Otherwise, .B p and @@ -128,17 +128,17 @@ are provided to manage signature storage. converts an ASN1 formatted DSA private key into the corresponding .B DSApriv structure; see -.IR rsa (3) +.IM rsa (3) for other ASN1 routines. .SH SOURCE .B \*9/src/libsec .SH SEE ALSO -.IR mp (3), -.IR aes (3), -.IR blowfish (3), -.IR des (3), -.IR rc4 (3), -.IR rsa (3), -.IR sechash (3), -.IR prime (3), -.IR rand (3) +.IM mp (3) , +.IM aes (3) , +.IM blowfish (3) , +.IM des (3) , +.IM rc4 (3) , +.IM rsa (3) , +.IM sechash (3) , +.IM prime (3) , +.IM rand (3) blob - 392e6fe633e114e81762ecbfe3895a47fd041920 blob + e313c06821205cf5d3db14ccb3d7381fe482a1be --- man/man3/dup.3 +++ man/man3/dup.3 @@ -36,4 +36,4 @@ To avoid name conflicts with the underlying system, is a preprocessor macro defined as .IR p9dup ; see -.IR intro (3). +.IM intro (3) . blob - 2fc75ac64f5b559f9ec0feb98b8db607a105dd35 blob + 9fe4e69872676d5ff6b04a18294857512ba43e21 --- man/man3/elgamal.3 +++ man/man3/elgamal.3 @@ -113,13 +113,13 @@ are provided to manage signature storage. .SH SOURCE .B \*9/src/libsec .SH SEE ALSO -.IR mp (3), -.IR aes (3), -.IR blowfish (3), -.IR des (3), -.IR dsa (3), -.IR rc4 (3), -.IR rsa (3), -.IR sechash (3), -.IR prime (3), -.IR rand (3) +.IM mp (3) , +.IM aes (3) , +.IM blowfish (3) , +.IM des (3) , +.IM dsa (3) , +.IM rc4 (3) , +.IM rsa (3) , +.IM sechash (3) , +.IM prime (3) , +.IM rand (3) blob - fde8296c8499b33613b05fa580a59f426820db32 blob + e3a94860d9394881535fea1a5822b6d1c17de3b6 --- man/man3/encode.3 +++ man/man3/encode.3 @@ -49,9 +49,9 @@ of 8. .PP .I Encodefmt can be used with -.IR fmtinstall (3) +.IM fmtinstall (3) and -.IR print (3) +.IM print (3) to print encoded representations of byte arrays. The verbs are .TP blob - 1f44689d3fdb7b818d5dd302e96eccfcc81346f4 blob + 70ff003ed93a1be9e5a6848b496795ba1841dfcc --- man/man3/encrypt.3 +++ man/man3/encrypt.3 @@ -84,4 +84,4 @@ are preprocessor macros defined as and .IR p9decrypt ; see -.IR intro (3). +.IM intro (3) . blob - 3964d8d5ceafe2fc6e5db6e1af44bfc37d026da5 blob + 5bc7bf091990dd8c2a68fc471387749c75eb039d --- man/man3/errstr.3 +++ man/man3/errstr.3 @@ -53,7 +53,7 @@ the result is an empty string. The verb .B r in -.IR print (3) +.IM print (3) calls .I errstr and outputs the error string. @@ -92,8 +92,8 @@ will reset .I Errstr always returns 0. .SH SEE ALSO -.IR intro (3), -.IR perror (3) +.IM intro (3) , +.IM perror (3) .SH BUGS The implementation sets .I errno @@ -104,4 +104,4 @@ When .I errno is set to other values, the error string is synthesized using -.IR strerror (3). +.IM strerror (3) . blob - 5991a17d36d6f578eaa26805307b68b43b07de54 blob + 56ddeb34656932122b8153907be3ff5689981ce7 --- man/man3/event.3 +++ man/man3/event.3 @@ -93,12 +93,12 @@ enum{ These routines provide an interface to multiple sources of input for unthreaded programs. Threaded programs (see -.IR thread (3)) +.IM thread (3) ) should instead use the threaded mouse and keyboard interface described in -.IR mouse (3) +.IM mouse (3) and -.IR keyboard (3). +.IM keyboard (3) . .PP .I Einit must be called first. @@ -113,7 +113,7 @@ the mouse and keyboard events will be enabled; in this case, .IR initdraw (see -.IR graphics (3)) +.IM graphics (3) ) must have already been called. The user must provide a function called .IR eresized @@ -123,7 +123,7 @@ is running has been resized; the argument is a flag specifying whether the program must call .I getwindow (see -.IR graphics (3)) +.IM graphics (3) ) to re-establish a connection to its window. After resizing (and perhaps calling .IR getwindow ), @@ -266,7 +266,7 @@ The return is the same as for .IR eread . .PP As described in -.IR graphics (3), +.IM graphics (3) , the graphics functions are buffered. .IR Event , .IR eread , @@ -370,15 +370,15 @@ changes the cursor image to that described by the .B Cursor .I c (see -.IR mouse (3)). +.IM mouse (3) ). If .B c is nil, it restores the image to the default arrow. .SH SOURCE .B \*9/src/libdraw .SH "SEE ALSO" -.IR rio (1), -.IR graphics (3), -.IR plumb (3), +.IM rio (1) , +.IM graphics (3) , +.IM plumb (3) , .\" .IR cons (3), -.IR draw (3) +.IM draw (3) blob - 1a0a8a87180977fb67499497aa1ec1607119b0ed blob + cc921dbddc14dfac5eab58a0fde19bed16ab889d --- man/man3/exec.3 +++ man/man3/exec.3 @@ -25,11 +25,11 @@ points to the name of the file to be executed; it must not be a directory, and the permissions must allow the current user to execute it (see -.IR stat (3)). +.IM stat (3) ). It should also be a valid binary image, as defined by the local operating system, or a shell script (see -.IR rc (1)). +.IM rc (1) ). The first line of a shell script must begin with .L #! @@ -92,24 +92,24 @@ files remain open across .B OCEXEC OR'd into the open mode; see -.IR open (3)); +.IM open (3) ); and the working directory and environment (see -.IR getenv (3)) +.IM getenv (3) ) remain the same. However, a newly .I exec'ed process has no notification handlers (see -.IR notify (3)). +.IM notify (3) ). .SH SOURCE .B \*9/src/lib9/exec.c .br .B \*9/src/lib9/execl.c .SH SEE ALSO -.IR prof (1), -.IR intro (3), -.IR stat (3) +.IM prof (1) , +.IM intro (3) , +.IM stat (3) .SH DIAGNOSTICS If these functions fail, they return and set .IR errstr . @@ -138,4 +138,4 @@ are preprocessor macros defined as and .IR p9execl ; see -.IR intro (3). +.IM intro (3) . blob - 1bab40af8d182b7e1497999729437a6c7f749307 blob + c1d47ea8752734581e1fe06d13d755761f1403a3 --- man/man3/exits.3 +++ man/man3/exits.3 @@ -39,7 +39,7 @@ explanation of the reason for exiting, or a null pointer or empty string to indicate normal termination. The string is passed to the parent process, prefixed by the name and process id of the exiting process, when the parent does a -.IR wait (3). +.IM wait (3) . .PP Before calling .I _exits @@ -85,8 +85,8 @@ cancels a previous registration of an exit function. .br .B \*9/src/lib9/_exits.c .SH "SEE ALSO" -.IR fork (2), -.IR wait (3) +.IM fork (2) , +.IM wait (3) .SH BUGS Because of limitations of Unix, the exit status of a process can only be an 8-bit integer. @@ -117,4 +117,4 @@ are preprocessor macros defined as and .IR p9atexitdont ; see -.IR intro (3). +.IM intro (3) . blob - fe696a4ba74a411d2547f7dc780782b9e4742ec7 blob + 6dc4bf5ccca91e50ad1c313ae9275512969bf8a2 --- man/man3/fcall.3 +++ man/man3/fcall.3 @@ -225,7 +225,7 @@ by a successful call to Another structure is .BR Dir , used by the routines described in -.IR stat (3). +.IM stat (3) . .I ConvM2D converts the machine-independent form starting at .I ap @@ -293,7 +293,7 @@ contain a validly formatted machine-independent entry suitable as an argument, for example, for the .B wstat (see -.IR stat (3)) +.IM stat (3) ) system call. It checks that the sizes of all the elements of the the entry sum to exactly .IR nbuf , @@ -321,7 +321,7 @@ for an incorrectly formatted entry. and .I dirmodefmt are formatting routines, suitable for -.IR fmtinstall (3). +.IM fmtinstall (3) . They convert .BR Dir* , .BR Fcall* , @@ -343,7 +343,7 @@ with format letter .PP .I Read9pmsg calls -.IR read (3) +.IM read (3) multiple times, if necessary, to read an entire 9P message into .BR buf . The return value is 0 for end of file, or -1 for error; it does not return @@ -351,7 +351,7 @@ partial messages. .SH SOURCE .B \*9/src/lib9 .SH SEE ALSO -.IR intro (3), -.IR 9p (3), -.IR stat (3), +.IM intro (3) , +.IM 9p (3) , +.IM stat (3) , .IR intro (9p) blob - b7b1a197517606dd215c5e7495a790dc6c170e28 blob + cd90c1f2ad09d9688fcd761b2e03df580609e399 --- man/man3/flate.3 +++ man/man3/flate.3 @@ -173,7 +173,7 @@ The block functions return the number of bytes produce .I Mkcrctab allocates (using -.IR malloc (3)), +.IM malloc (3) ), initializes, and returns a table for rapid computation of 32 bit CRC values using the polynomial .IR poly . .I Blockcrc blob - da766d77649f1e20d777b92f44e5b9f261ea61df blob + 93bded76160220c83cf8d012152c17e15ce21531 --- man/man3/fmtinstall.3 +++ man/man3/fmtinstall.3 @@ -94,16 +94,16 @@ int fmtrunestrcpy(Fmt *f, Rune *s); int errfmt(Fmt *f); .SH DESCRIPTION The interface described here allows the construction of custom -.IR print (3) +.IM print (3) verbs and output routines. In essence, they provide access to the workings of the formatted print code. .PP The -.IR print (3) +.IM print (3) suite maintains its state with a data structure called .BR Fmt . A typical call to -.IR print (3) +.IM print (3) or its relatives initializes a .B Fmt structure, passes it to subsidiary routines to process the output, @@ -154,7 +154,7 @@ to generate the output. These behave like .B fprint (see -.IR print (3)) +.IM print (3) ) or .B vfprint except that the characters are buffered until @@ -207,7 +207,7 @@ In are the width and precision, and .IB fp ->flags the decoded flags for the verb (see -.IR print (3) +.IM print (3) for a description of these items). The standard flag values are: .B FmtSign @@ -282,7 +282,7 @@ produced. .PP Some internal functions may be useful to format primitive types. They honor the width, precision and flags as described in -.IR print (3). +.IM print (3) . .I Fmtrune formats a single character .BR r . @@ -307,7 +307,7 @@ regardless of whether the output is bytes or runes. This function prints an error message with a variable number of arguments and then quits. Compared to the corresponding example in -.IR print (3), +.IM print (3) , this version uses a smaller buffer, will never truncate the output message, but might generate multiple .B write @@ -364,9 +364,9 @@ main(...) .SH SOURCE .B \*9/src/lib9/fmt .SH SEE ALSO -.IR print (3), -.IR utf (7), -.IR errstr (3) +.IM print (3) , +.IM utf (7) , +.IM errstr (3) .SH DIAGNOSTICS These routines return negative numbers or nil for errors and set .IR errstr . blob - 1e063802c0c85908d10ecc0fe1d945f9c9114b57 blob + 4fb2f8b69116a4db425787a58aaa5b91947fe201 --- man/man3/frame.3 +++ man/man3/frame.3 @@ -73,9 +73,9 @@ enum{ This library supports .I frames of editable text in a single font on raster displays, such as in -.IR sam (1) +.IM sam (1) and -.IR 9term (1). +.IM 9term (1) . Frames may hold any character except NUL (0). Long lines are folded and tabs are at fixed intervals. .PP @@ -239,7 +239,7 @@ If a .B Frame is being moved but not resized, that is, if the shape of its containing rectangle is unchanged, it is sufficient to use -.IR draw (3) +.IM draw (3) to copy the containing rectangle from the old to the new location and then call .I frsetrects to establish the new geometry. @@ -357,6 +357,6 @@ and .SH SOURCE .B \*9/src/libframe .SH SEE ALSO -.IR graphics (3), -.IR draw (3), -.IR cachechars (3). +.IM graphics (3) , +.IM draw (3) , +.IM cachechars (3) . blob - ddf481e4c5127289cc14ab42c65e93f7950f83d2 blob + 320ecd14fe3372e473cd9f17bbd25e3be146cc6d --- man/man3/genrandom.3 +++ man/man3/genrandom.3 @@ -25,11 +25,11 @@ number generator. The X9.17 generator is seeded by 24 truly random bytes read via .I truerand (see -.IR rand (3)). +.IM rand (3) ). .PP .I Prng uses the native -.IR rand (3) +.IM rand (3) pseudo-random number generator to fill the buffer. Used with .IR srand , this function can produce a reproducible stream of pseudo random @@ -38,8 +38,8 @@ numbers useful in testing. Both functions may be passed to .I mprand (see -.IR mp (3)). +.IM mp (3) ). .SH SOURCE .B \*9/src/libsec .SH SEE ALSO -.IR mp (3) +.IM mp (3) blob - 52fb6f0945401ee13cebf05e060643809676aed8 blob + 343ad9d6dd3bcd4b68769b34a6e1e7287ba96f45 --- man/man3/get9root.3 +++ man/man3/get9root.3 @@ -49,7 +49,7 @@ if different from should be freed with .I free (see -.IR malloc (3)) +.IM malloc (3) ) when no longer needed. .PP As a convention, programs should never @@ -57,7 +57,7 @@ As a convention, programs should never paths obtained from user input. .SH EXAMPLE The -.IR plumber (4) +.IM plumber (4) uses this code to find unrooted file names included by plumb rules. .IP .EX @@ -69,7 +69,7 @@ fd = open(unsharp(buf), OREAD); .br .B \*9/src/lib9/unsharp.c .SH SEE ALSO -.IR intro (4) +.IM intro (4) .SH BUGS .I Get9root could be smarter about finding the tree when blob - a817b6ef79870839cf49ae3463cd958ff54ea1d3 blob + 3ce0a316b6cb39ded9a159f8667d7e02f834acff --- man/man3/getenv.3 +++ man/man3/getenv.3 @@ -18,7 +18,7 @@ int putenv(char *name, char *val) fetches the environment value associated with .I name into memory allocated with -.IR malloc (3), +.IM malloc (3) , 0-terminates it, and returns a pointer to that area. If no file exists, 0 @@ -44,4 +44,4 @@ are preprocessor macros defined as and .IR p9putenv ; see -.IR intro (3). +.IM intro (3) . blob - feaf10d85197c0cf870abfa7271e7192f157ed01 blob + 19741b855714ff4c0736e045c3730f6dcb671503 --- man/man3/getfields.3 +++ man/man3/getfields.3 @@ -75,9 +75,9 @@ with non-zero, except that fields may be quoted using single quotes, in the manner of -.IR rc (1). +.IM rc (1) . See -.IR quote (3) +.IM quote (3) for related quote-handling software. .PP .I Tokenize @@ -91,5 +91,5 @@ set to \f5"\et\er\en "\fP. .SH SEE ALSO .I strtok in -.IR strcat (3), -.IR quote (3). +.IM strcat (3) , +.IM quote (3) . blob - b2e03f93daabebdbd4e5db918830c02bd2eca2d6 blob + a23a856b1d59836c8910a54f49665aec76010bba --- man/man3/getns.3 +++ man/man3/getns.3 @@ -14,9 +14,9 @@ returns a pointer to a malloced string that contains t path to the name space directory for the current process. The name space directory is a clumsy substitute for Plan 9's per-process name spaces; see -.IR intro (4) +.IM intro (4) for details. .SH SOURCE .B \*9/src/lib9/getns.c .SH SEE ALSO -.IR intro (4) +.IM intro (4) blob - 938aae3f201ade00ac4f3790d424abb78f4a1260 blob + 323b6ab542788aabc6362f21aebf48cf92f91485 --- man/man3/getsnarf.3 +++ man/man3/getsnarf.3 @@ -20,7 +20,7 @@ returns a copy of the current buffer; the returned pointer should be freed with .I free (see -.IR malloc (3)) +.IM malloc (3) ) when no longer needed. .PP .I Putsnarf @@ -36,4 +36,4 @@ will convert as necessary. .SH SOURCE .B \*9/src/libdraw/snarf.c .SH SEE ALSO -.IR snarfer (1) +.IM snarfer (1) blob - 41e78e3d9e2d9544268481bd7c822371c8fb79df blob + dae84a2300c4d40592aecef6c01f5c2a7c715dc2 --- man/man3/getuser.3 +++ man/man3/getuser.3 @@ -19,7 +19,7 @@ name of the user who owns the current process. .I Getuser calls -.IR getuid (2) +.IM getuid (2) and then reads .B /etc/passwd to find the corresponding name. @@ -33,7 +33,7 @@ looks first for an environment variable If there is no such variable, .I sysname calls -.IR gethostname (2) +.IM gethostname (2) and truncates the returned name at the first dot. If .I gethostname blob - 245914f34e0651bc7c358a9b5fbde6070bba554b blob + 9bb36d3097cd2ed22a72c29f221287e96d96cb3b --- man/man3/getwd.3 +++ man/man3/getwd.3 @@ -23,10 +23,10 @@ bytes in the buffer provided. .SH SOURCE .B \*9/src/lib9/getwd.c .SH "SEE ALSO" -.IR pwd (1) +.IM pwd (1) .SH DIAGNOSTICS On error, zero is returned. -.IR Errstr (3) +.IM Errstr (3) may be consulted for more information. .SH BUGS To avoid name conflicts with the underlying system, @@ -34,4 +34,4 @@ To avoid name conflicts with the underlying system, is a preprocessor macro defined as .IR p9getwd ; see -.IR intro (3). +.IM intro (3) . blob - 4f58451a041a9d3b14b0333570c0c3889f07d0e5 blob + 42b797f441b84ab0c6a1624fd4922ba5580a707b --- man/man3/graphics.3 +++ man/man3/graphics.3 @@ -107,7 +107,7 @@ extern Font *font A .B Display structure represents a connection to the graphics device, -.IR draw (3), +.IM draw (3) , holding all graphics resources associated with the connection, including in particular raster image data in use by the client program. The structure is defined (in part) as: @@ -135,7 +135,7 @@ A .B Point is a location in an Image (see below and -.IR draw (3)), +.IM draw (3) ), such as the display, and is defined as: .IP .EX @@ -184,18 +184,18 @@ contains the coordinates of the first point beyond the The .B Image data structure is defined in -.IR draw (3). +.IM draw (3) . .PP A .B Font is a set of character images, indexed by runes (see -.IR utf (7)). +.IM utf (7) ). The images are organized into .BR Subfonts , each containing the images for a small, contiguous set of runes. The detailed format of these data structures, which are described in detail in -.IR cachechars (3), +.IM cachechars (3) , is immaterial for most applications. .B Font and @@ -210,7 +210,7 @@ and the distance from the top of the highest character to the bottom of the lowest character (and hence, the interline spacing). See -.IR cachechars (3) +.IM cachechars (3) for more details. .PP .I Buildfont @@ -221,7 +221,7 @@ returning a pointer that can be used by .B string (see -.IR draw (3)) +.IM draw (3) ) to draw characters from the font. .I Openfont does the same, but reads the description @@ -231,7 +231,7 @@ frees a font. In contrast to Plan 9, font names in Plan 9 from User Space are a small language describing the desired font. See -.IR font (7) +.IM font (7) for details. .PP A @@ -274,7 +274,7 @@ structure representing the connection), (an .B Image representing the display memory itself or, if -.IR rio (1) +.IM rio (1) is running, the client's window), and .B font @@ -287,7 +287,7 @@ which is written to .B /dev/label if non-nil so that it can be used to identify the window when hidden (see -.IR rio (1)). +.IM rio (1) ). The font is created by reading the named .I font file. If @@ -301,7 +301,7 @@ if is not set, it imports the default (usually minimal) font from the operating system. (See -.IR font (7) +.IM font (7) for a full discussion of font syntaxes.) The global .I font @@ -322,7 +322,7 @@ is nil, the library provides a default, called Another effect of .I initdraw is that it installs -.IR print (3) +.IM print (3) formats .I Pfmt and @@ -360,9 +360,9 @@ and files; and .I ref specifies the refresh function to be used to create the window, if running under -.IR rio (1) +.IM rio (1) (see -.IR window (3)). +.IM window (3) ). .\" .PP .\" The function .\" .I newwindow @@ -435,11 +435,11 @@ by looking in to find the name of the window and opening it using .B namedimage (see -.IR allocimage (3)). +.IM allocimage (3) ). The resulting window will be created using the refresh method .I ref (see -.IR window (3)); +.IM window (3) ); this should almost always be .B Refnone because @@ -456,7 +456,7 @@ defining the window (or the overall display, if no win a pointer to the .B Screen representing the root of the window's hierarchy. (See -.IR window (3). +.IM window (3) . The overloading of the .B screen word is an unfortunate historical accident.) @@ -528,15 +528,15 @@ the window boundaries; otherwise is a no-op. .PP The graphics functions described in -.IR draw (3), -.IR allocimage (3), -.IR cachechars (3), +.IM draw (3) , +.IM allocimage (3) , +.IM cachechars (3) , and -.IR subfont (3) +.IM subfont (3) are implemented by writing commands to files under .B /dev/draw (see -.IR draw (3)); +.IM draw (3) ); the writes are buffered, so the functions may not take effect immediately. .I Flushimage flushes the buffer, doing all pending graphics operations. @@ -546,7 +546,7 @@ is non-zero, any changes are also copied from the `sof driver to the visible frame buffer. The various allocation routines in the library flush automatically, as does the event package (see -.IR event (3)); +.IM event (3) ); most programs do not need to call .IR flushimage . It returns \-1 on error. @@ -563,13 +563,13 @@ and .I chantostr convert between the channel descriptor strings used by -.IR image (7) +.IM image (7) and the internal .B ulong representation used by the graphics protocol (see -.IR draw (3)'s +.IM draw (3) 's .B b message). .B Chantostr @@ -599,7 +599,7 @@ if(getwindow(display, Refnone) < 0) .EE .PP To create and set up a new -.IR rio (1) +.IM rio (1) window, .IP .EX @@ -630,23 +630,23 @@ if(gengetwindow(display, "/tmp/winname", .SH SOURCE .B \*9/src/libdraw .SH "SEE ALSO" -.IR rio (1), -.IR addpt (3), -.IR allocimage (3), -.IR cachechars (3), -.IR subfont (3), -.IR draw (3), -.IR event (3), -.IR frame (3), -.IR print (3), -.IR window (3), -.IR draw (3), +.IM rio (1) , +.IM addpt (3) , +.IM allocimage (3) , +.IM cachechars (3) , +.IM subfont (3) , +.IM draw (3) , +.IM event (3) , +.IM frame (3) , +.IM print (3) , +.IM window (3) , +.IM draw (3) , .\" .IR rio (4), -.IR image (7), -.IR font (7) +.IM image (7) , +.IM font (7) .SH DIAGNOSTICS An error function may call -.IR errstr (3) +.IM errstr (3) for further diagnostics. .SH BUGS The names blob - 7dc486ae42e73225ae74a44c4213be4b0f887cdc blob + f99fda1b499b140c016351edb2167025a93d6705 --- man/man3/html.3 +++ man/man3/html.3 @@ -1411,7 +1411,7 @@ would not otherwise fit), and .SH SOURCE .B \*9/src/libhtml .SH SEE ALSO -.IR fmt (1) +.IM fmt (1) .PP W3C World Wide Web Consortium, ``HTML 4.01 Specification''. blob - a87fa775b90a0a20cdee8373323f1830daf53410 blob + 2645a228f3562b39aff60623627484e32209da5d --- man/man3/ioproc.3 +++ man/man3/ioproc.3 @@ -80,14 +80,14 @@ and execute the similarly named library or system calls (see -.IR close (2), -.IR dial (3), -.IR open (3), -.IR read (3), -.IR fcall (3), -.IR sendfd (3), +.IM close (2) , +.IM dial (3) , +.IM open (3) , +.IM read (3) , +.IM fcall (3) , +.IM sendfd (3) , and -.IR sleep (3)) +.IM sleep (3) ) in the slave process associated with .IR io . It is an error to execute more than one call @@ -187,10 +187,10 @@ ioread(Ioproc *io, int fd, void *a, long n) .SH SOURCE .B \*9/src/libthread .SH SEE ALSO -.IR dial (3), -.IR open (3), -.IR read (3), -.IR thread (3) +.IM dial (3) , +.IM open (3) , +.IM read (3) , +.IM thread (3) .SH BUGS .I Iointerrupt is currently unimplemented. blob - 2d9e8289d0d5fd3c9e7680a92ba4b64739d09070 blob + c8305dea42e4da4a68efe31be8516a43ee701966 --- man/man3/ip.3 +++ man/man3/ip.3 @@ -126,7 +126,7 @@ The string representation of Ethernet addresses is exa .PP .I Eipfmt is a -.IR print (3) +.IM print (3) formatter for Ethernet (verb .BR E ) addresses, @@ -340,4 +340,4 @@ point to point. .SH SOURCE .B \*9/src/libip .SH SEE ALSO -.IR print (3) +.IM print (3) blob - 7b5cf301f4ad616d532eb32830c4550081f18b51 blob + eeaf3ebcb40abd415dc2d1477b8cad3b7932642a --- man/man3/isalpharune.3 +++ man/man3/isalpharune.3 @@ -35,7 +35,7 @@ in particular a subset of their properties as defined Unicode defines some characters as alphabetic and specifies three cases: upper, lower, and title. Analogously to -.IR isalpha (3) +.IM isalpha (3) for .SM ASCII\c , blob - 4641b86dc43a0183081012036e9f13b477b5b202 blob + 6c1bf026e07b44a96990915116bbb8ce6de31c64 --- man/man3/keyboard.3 +++ man/man3/keyboard.3 @@ -23,14 +23,14 @@ void closekeyboard(Keyboard *kc) .SH DESCRIPTION These functions access and control a keyboard interface for character-at-a-time I/O in a multi-threaded environment, usually in combination with -.IR mouse (3). +.IM mouse (3) . They use the message-passing .B Channel interface in the threads library (see -.IR thread (3)); +.IM thread (3) ); programs that wish a more event-driven, single-threaded approach should use -.IR event (3). +.IM event (3) . .PP .I Initkeyboard opens a connection to the keyboard and returns a @@ -86,10 +86,10 @@ structure. .SH SOURCE .B \*9/src/libdraw .SH SEE ALSO -.IR graphics (3), -.IR draw (3), -.IR event (3), -.IR thread (3). +.IM graphics (3) , +.IM draw (3) , +.IM event (3) , +.IM thread (3) . .SH BUGS Because the interface delivers complete runes, there is no way to report lesser actions such as blob - adc75d1fc1ab37dcf69d5c361e559775ef91aedb blob + 31882bb0ccdd77282cc7d734628233c5db1dc5e4 --- man/man3/lock.3 +++ man/man3/lock.3 @@ -80,7 +80,7 @@ are rendezvous points. Locks and rendezvous points have trivial implementations in programs not using the thread library (see -.IR thread (3)), +.IM thread (3) ), since such programs have no concurrency. .PP Used carelessly, spin locks can be expensive and can easily generate deadlocks. blob - ac6b3bbdf6891e36c82b619b6c88d88f78e70d36 blob + 08563eb7599de10a1a779b93c7d6706cf8c2fcae --- man/man3/mach-cmd.3 +++ man/man3/mach-cmd.3 @@ -64,7 +64,7 @@ fields) of all currently open headers (see .I symopen in -.IR mach-symbol (3)). +.IM mach-symbol (3) ). When dynamically linked objects have been attached, they are present in this linked list, and therefore included in searches by @@ -73,7 +73,7 @@ and therefore included in searches by and .I findsym (see -.IR mach-symbol (3)). +.IM mach-symbol (3) ). .TP .I corhdr The file header for the core dump, if any. @@ -118,9 +118,9 @@ loaded. uses all of these functions while parsing an argument vector as would be passed to a debugger like -.IR db (1) +.IM db (1) or -.IR acid (1). +.IM acid (1) . It expects a list of executable files, core dump files, or process ids, given in any order. If extra arguments are given (for example, more than one executable, or both @@ -133,9 +133,9 @@ fills them in as best it can. .SH SOURCE .B \*9/src/libmach .SH "SEE ALSO -.IR mach (3), -.IR mach-file (3), -.IR mach-map (3) +.IM mach (3) , +.IM mach-file (3) , +.IM mach-map (3) .SH BUGS The interface needs to be changed to support multiple threads, each with its own register set. blob - 19a10b81350d3106f9b2105835a22404874ef39f blob + 22a61aa0d0076e341e07ea54aa552e0eba333465 --- man/man3/mach-file.3 +++ man/man3/mach-file.3 @@ -161,10 +161,10 @@ The memory at should be freed via .I free (see -.IR malloc (3)) +.IM malloc (3) ) when no longer needed. .SH SOURCE .B \*9/src/libmach .SH "SEE ALSO" -.IR mach (3), -.IR mach-map (3) +.IM mach (3) , +.IM mach-map (3) blob - c5822572103bc59c7204e5b429e083d9cab554a4 blob + 94e73a223901883cca16f8b3a3c937b063847f54 --- man/man3/mach-map.3 +++ man/man3/mach-map.3 @@ -133,10 +133,10 @@ via data structures that provides access to an address space and register set. The functions described in -.IR mach-file (3) +.IM mach-file (3) are typically used to construct these maps. Related library functions described in -.IR mach-symbol (3) +.IM mach-symbol (3) provide similar access to symbol tables. .PP Each @@ -178,7 +178,7 @@ The .B rw function is most commonly used to provide access to executing processes via -.IR ptrace (2) +.IM ptrace (2) and to zeroed segments. .PP .I Allocmap @@ -346,7 +346,7 @@ such locations are useful for passing specific constan functions expect locations, such as .I unwind (see -.IR mach-stack (3)). +.IM mach-stack (3) ). .PP .I Loccmp compares two locations, returning negative, zero, or positive @@ -360,7 +360,7 @@ which are ordered before indirections. .PP .I Locfmt is a -.IR print (3)-verb +.IM print (3) -verb that formats a .B Loc structure @@ -371,7 +371,7 @@ Indirection locations are needed in some contexts (e.g using .I findlsym (see -.IR mach-symbol (3))), +.IM mach-symbol (3) )), but bothersome in most. .I Locsimplify rewrites indirections as absolute memory addresses, by evaluating @@ -397,8 +397,8 @@ function families as necessary. .SH SOURCE .B \*9/src/libmach .SH "SEE ALSO" -.IR mach (3), -.IR mach-file (3) +.IM mach (3) , +.IM mach-file (3) .SH DIAGNOSTICS These routines set .IR errstr . blob - d75f641f51d2319b8d330a56c3737a74287bf392 blob + abf413943787ebcd7a9d42b668af81aea194487b --- man/man3/mach-stack.3 +++ man/man3/mach-stack.3 @@ -68,7 +68,7 @@ a new .I rget function, and a symbol (see -.IR mach-symbol (3)) +.IM mach-symbol (3) ) describing the current function (nil if no symbol is known). The value returned by the tracer @@ -180,6 +180,6 @@ trace(Map *map, ulong pc, ulong callerpc, .SH SOURCE .B \*9/src/libmach .SH SEE ALSO -.IR mach (3) +.IM mach (3) .SH BUGS Need to talk about Regs blob - eb6091f3263acaa366448546a8d7d98473fa72f4 blob + 39b18ef9dccc40e94583ae23dd841c7accca885d --- man/man3/mach-swap.3 +++ man/man3/mach-swap.3 @@ -114,4 +114,4 @@ and low 32-bits are in .SH SOURCE .B \*9/src/libmach .SH "SEE ALSO" -.IR mach (3) +.IM mach (3) blob - e14a7b2e00828c1c9ea2a3f5c92110d5f1430233 blob + fc7bbd28188d28fae0a215616abdd172d1d487b8 --- man/man3/mach-symbol.3 +++ man/man3/mach-symbol.3 @@ -61,10 +61,10 @@ int fnbound(ulong pc, ulong bounds[2]) .SH DESCRIPTION These functions provide machine-independent access to the symbol table of an executable file or executing process. -.IR Mach (3), -.IR mach-file (3), +.IM Mach (3) , +.IM mach-file (3) , and -.IR mach-map (3) +.IM mach-map (3) describe additional library functions for accessing executable files and executing processes. .PP @@ -74,7 +74,7 @@ uses the data in the structure filled by .I crackhdr (see -.IR mach-file (3)) +.IM mach-file (3) ) to initialize in-memory structures used to access the symbol tables contained in the file. .IR Symclose @@ -371,6 +371,6 @@ in the system error buffer where it is available via .SH SOURCE .B \*9/src/libmach .SH "SEE ALSO" -.IR mach (3), -.IR mach-file (3), -.IR mach-map (3) +.IM mach (3) , +.IM mach-file (3) , +.IM mach-map (3) blob - 9c065d00280aea84ae24f1d3df2e289e33f4b554 blob + 71742155c205b5490cf637e9e8e0811155977259 --- man/man3/mach.3 +++ man/man3/mach.3 @@ -40,7 +40,7 @@ points at the structure for the architecture being deb It is set implicitly by .I crackhdr (see -.IR mach-file (3)) +.IM mach-file (3) ) and can be set explicitly by calling .I machbyname or @@ -66,31 +66,31 @@ Mac OS X). Other manual pages describe the library functions in detail. .PP -.IR Mach-cmd (3) +.IM Mach-cmd (3) describes some convenience routines for attaching to processes and core files. .PP -.IR Mach-file (3) +.IM Mach-file (3) describes the manipulation of binary files. .PP -.IR Mach-map (3) +.IM Mach-map (3) describes the interface to address spaces and register sets in executable files and executing programs. .PP -.IR Mach-stack (3) +.IM Mach-stack (3) describes support for unwinding the stack. .PP -.IR Mach-swap (3) +.IM Mach-swap (3) describes helper functions for accessing data in a particular byte order. .PP -.IR Mach-symbol (3) +.IM Mach-symbol (3) describes the interface to debugging symbol information. .SH SOURCE .B \*9/src/libmach .SH "SEE ALSO -.IR mach-file (3), -.IR mach-map (3), -.IR mach-stack (3), -.IR mach-swap (3), -.IR mach-symbol (3) +.IM mach-file (3) , +.IM mach-map (3) , +.IM mach-stack (3) , +.IM mach-swap (3) , +.IM mach-symbol (3) blob - 1cdff577663ebd4484274b710fdbf740dfdbf9f1 blob + 300b9c5b0e9baedca4a548162b382a93f4ee75ed --- man/man3/malloc.3 +++ man/man3/malloc.3 @@ -132,8 +132,8 @@ the source of allocation. .SH SEE ALSO .I trump (in -.IR acid (1)), -.IR getcallerpc (3) +.IM acid (1) ), +.IM getcallerpc (3) .SH DIAGNOSTICS .I Malloc, realloc and @@ -153,7 +153,7 @@ The library for .I acid can be used to obtain traces of malloc execution; see -.IR acid (1). +.IM acid (1) . .SH BUGS The different specification of .I calloc @@ -182,4 +182,4 @@ are preprocessor macros defined as and .IR p9free ; see -.IR intro (3). +.IM intro (3) . blob - 7291725c62ed4f89f0a57dfebd6ce95f6d96f097 blob + b66170efdc705e7ed91e60d478acf80eb65bf6db --- man/man3/matrix.3 +++ man/man3/matrix.3 @@ -347,4 +347,4 @@ coordinates. .SH SOURCE .B \*9/src/libgeometry/matrix.c .SH "SEE ALSO -.IR arith3 (3) +.IM arith3 (3) blob - 243cfe161286b431925fbf77562e7ed4eb47ad69 blob + 89e073b92a8697ae46e8bdd7cac1ef8bc416a627 --- man/man3/memdraw.3 +++ man/man3/memdraw.3 @@ -168,46 +168,46 @@ type defines memory-resident rectangular pictures and differ from .BR Image s (see -.IR draw (3)) +.IM draw (3) ) in that they are manipulated directly in user memory rather than by RPCs to the .B /dev/draw hierarchy. The .Bmemdraw -library is the basis for the kernel -.IR draw (3) +library is the basis for the kernel +.IM draw (3) driver and also used by a number of programs that must manipulate images without a display. .PP -The -.BR r, +The +.BR r, .BR clipr , .BR depth , .BR nchan , and -.BR chan +.BR chan structure elements are identical to the ones of the same name -in the +in the .B Image structure. .PP The .B flags -element of the +element of the .B Memimage structure holds a number of bits of information about the image. In particular, it subsumes the purpose of the .B repl -element of +element of .B Image structures. .PP .I Memimageinit initializes various static data that the library depends on, -as well as the replicated solid color images +as well as the replicated solid color images .BR memopaque , .BR memtransparent , .BR memblack , @@ -216,15 +216,15 @@ and It should be called before referring to any of these images and before calling any of the other library functions. .PP -Each +Each .B Memimage -points at a +points at a .B Memdata structure that in turn points at the actual pixel data for the image. -This allows multiple images to be associated with the same +This allows multiple images to be associated with the same .BR Memdata . The first word of the data pointed at by -the +the .B base element of .B Memdata @@ -232,18 +232,19 @@ points back at the .B Memdata structure, so that in the Plan 9 kernel, the memory allocator (see -Plan 9's \fIpool\fR(3)) +Plan 9's +.IR pool (3)) can compact image memory using .IR memimagemove . .PP Because images can have different coordinate systems, -the +the .B zero -element of the +element of the .B Memimage structure contains the offset that must be added -to the +to the .B bdata element of the corresponding .B Memdata @@ -261,18 +262,18 @@ do not include the origin, although one should only de pointers corresponding to pixels within the image rectangle. .I Wordaddr and -.IR byteaddr -perform these calculations, +.IR byteaddr +perform these calculations, returning pointers to the word and byte, respectively, that contain the beginning of the data for a given pixel. .PP .I Allocmemimage -allocates +allocates images with a given rectangle and channel descriptor -(see +(see .B strtochan in -.IR graphics (3)), +.IM graphics (3) ), creating a fresh .B Memdata structure and associated storage. @@ -282,7 +283,7 @@ is similar but uses the supplied structure rather than a new one. The .I readmemimage -function reads an uncompressed bitmap +function reads an uncompressed bitmap from the given file descriptor, while .I creadmemimage @@ -293,7 +294,7 @@ writes a compressed representation of to file descriptor .IR fd . For more on bitmap formats, see -.IR image (7). +.IM image (7) . .I Freememimage frees images returned by any of these routines. The @@ -315,7 +316,7 @@ data, respectively. When calling .IR cloadmemimage , the buffer must contain an -integral number of +integral number of compressed chunks of data that exactly cover the rectangle. .I Unloadmemimage retrieves the uncompressed pixel data for a given rectangle of an image. @@ -324,8 +325,8 @@ and \-1 in case of an error. .PP .I Memfillcolor fills an image with the given color, a 32-bit number as -described in -.IR color (3). +described in +.IM color (3) . .PP .IR Memarc , .IR mempoly , @@ -334,7 +335,7 @@ described in .IR memimageline , and .I memimagedraw -are identical to the +are identical to the .IR arc , .IR poly , .IR ellipse , @@ -343,40 +344,40 @@ are identical to the and .IR gendraw , routines described in -.IR draw (3), +.IM draw (3) , except that they operate on .BR Memimage s -rather than +rather than .BR Image s. -Similarly, +Similarly, .IR allocmemsubfont , .IR openmemsubfont , .IR freememsubfont , .IR memsubfontwidth , and .I memimagestring -are the +are the .B Memimage -analogues of +analogues of .IR allocsubfont , .IR openfont , .IR freesubfont , .IR strsubfontwidth , and .B string -(see -.IR subfont (3) +(see +.IM subfont (3) and -.IR graphics (3)), +.IM graphics (3) ), except that they operate -only on +only on .BR Memsubfont s rather than .BR Font s. .PP .I Drawclip takes the images involved in a draw operation, -together with the destination rectangle +together with the destination rectangle .B dr and source and mask alignment points @@ -407,7 +408,7 @@ an end of a given style. .PP The .I hwdraw -and +and .I iprint functions are no-op stubs that may be overridden by clients of the library. @@ -415,7 +416,7 @@ of the library. is called at each call to .I memimagedraw with the current request's parameters. -If it can satisfy the request, it should do so +If it can satisfy the request, it should do so and return 1. If it cannot satisfy the request, it should return 0. This allows (for instance) the kernel to take advantage @@ -432,15 +433,15 @@ prints to a serial line rather than the screen, for ob .SH SOURCE .B \*9/src/libmemdraw .SH SEE ALSO -.IR addpt (3), -.IR color (3), -.IR draw (3), -.IR graphics (3), -.IR memlayer (3), -.IR stringsize (3), -.IR subfont (3), -.IR color (7), -.IR utf (7) +.IM addpt (3) , +.IM color (3) , +.IM draw (3) , +.IM graphics (3) , +.IM memlayer (3) , +.IM stringsize (3) , +.IM subfont (3) , +.IM color (7) , +.IM utf (7) .SH BUGS .I Memimagestring is unusual in using a subfont rather than a font, blob - a40efdc7aaf19b04485df7c44ebe307794d4713d blob + c13a72a453598b270a777f393a441956ad91e1a5 --- man/man3/memlayer.3 +++ man/man3/memlayer.3 @@ -97,18 +97,18 @@ int memunload(Memimage *i, Rectangle r, .PP .SH DESCRIPTION These functions build upon the -.IR memdraw (3) +.IM memdraw (3) interface to maintain overlapping graphical windows on in-memory images. They are used by the kernel to implement the windows interface presented by -.IR draw (3) +.IM draw (3) and -.IR window (3) +.IM window (3) and probably have little use outside of the kernel. .PP The basic function is to extend the definition of a .B Memimage (see -.IR memdraw (3)) +.IM memdraw (3) ) to include overlapping windows defined by the .B Memlayer type. @@ -270,7 +270,7 @@ They have the signatures of and .I memimageline (see -.IR memdraw (3)) +.IM memdraw (3) ) but accept .B Memlayer or @@ -294,12 +294,12 @@ bytes of data in .I buf are in compressed image format (see -.IR image (7)). +.IM image (7) ). .SH SOURCE .B \*9/src/libmemlayer .SH SEE ALSO -.IR graphics (3), -.IR memdraw (3), -.IR stringsize (3), -.IR window (3), -.IR draw (3) +.IM graphics (3) , +.IM memdraw (3) , +.IM stringsize (3) , +.IM window (3) , +.IM draw (3) blob - 51e54479f024299cefe3f0a9ed11e025a557d4f5 blob + fefb9ba3ad660f0c54eca738758839fb7503b318 --- man/man3/memory.3 +++ man/man3/memory.3 @@ -109,7 +109,7 @@ All these routines have portable C implementations in .\" Most also have machine-dependent assembly language implementations in .\" .BR \*9/lib9/$objtype . .SH SEE ALSO -.IR strcat (3) +.IM strcat (3) .SH BUGS ANSI C does not require .I memcpy blob - b5061fd9268a955ab46cb4ca699973b9a2a531ad blob + 6974dfa632e7298767c24e324829e8f8fd717cf8 --- man/man3/mouse.3 +++ man/man3/mouse.3 @@ -49,9 +49,9 @@ They use the message-passing .B Channel interface in the threads library (see -.IR thread (3)); +.IM thread (3) ); programs that wish a more event-driven, single-threaded approach should use -.IR event (3). +.IM event (3) . .PP The state of the mouse is recorded in a structure, .BR Mouse , @@ -107,7 +107,7 @@ are a naming the device file connected to the mouse and an .I Image (see -.IR draw (3)) +.IM draw (3) ) on which the mouse will be visible. Typically the file is nil, @@ -136,7 +136,7 @@ The actual value sent may be discarded; the receipt of tells the program that it should call .B getwindow (see -.IR graphics (3)) +.IM graphics (3) ) to reconnect to the window. .PP .I Readmouse @@ -152,7 +152,7 @@ or message sent on the channel. It calls .B flushimage (see -.IR graphics (3)) +.IM graphics (3) ) before blocking, so any buffered graphics requests are displayed. .PP .I Closemouse @@ -174,14 +174,14 @@ is nil, the cursor is set to the default. The format of the cursor data is spelled out in .B and described in -.IR graphics (3). +.IM graphics (3) . .PP .I Getrect returns the dimensions of a rectangle swept by the user, using the mouse, in the manner -.IR rio (1) +.IM rio (1) or -.IR sam (1) +.IM sam (1) uses to create a new window. The .I but @@ -220,7 +220,7 @@ struct Menu behaves the same as its namesake .I emenuhit described in -.IR event (3), +.IM event (3) , with two exceptions. First, it uses a .B Mousectl @@ -230,7 +230,7 @@ it creates the menu as a true window on the .B Screen .I scr (see -.IR window (3)), +.IM window (3) ), permitting the menu to be displayed in parallel with other activities on the display. If .I scr @@ -244,8 +244,8 @@ restoring the display when the menu is removed. .SH SOURCE .B \*9/src/libdraw .SH SEE ALSO -.IR graphics (3), -.IR draw (3), -.IR event (3), -.IR keyboard (3), -.IR thread (3). +.IM graphics (3) , +.IM draw (3) , +.IM event (3) , +.IM keyboard (3) , +.IM thread (3) . blob - 9814735684ac4ea832ecee7f69b69544666acfe8 blob + 4595a68d5b6e21683e9c8d202d3f025a04d899f4 --- man/man3/mousescrollsize.3 +++ man/man3/mousescrollsize.3 @@ -28,15 +28,15 @@ causes a half-window scroll increment. .PP .I Mousescrollsize is used by -.IR 9term (1) +.IM 9term (1) and -.IR acme (1) +.IM acme (1) to set their scrolling behavior. .SH SOURCE .B \*9/src/libdraw/scroll.c .SH SEE ALSO -.IR 9term (1), -.IR acme (1) +.IM 9term (1) , +.IM acme (1) .SH BUGS .I Libdraw expects up and down scroll wheel events to be expressed as clicks of mouse buttons 4 and 5, blob - f0028c3f64fc891ffa722e2439e6b85d0c0885e2 blob + ad61ed9048a29305c47edfe3f4f98574e2be8f86 --- man/man3/mp.3 +++ man/man3/mp.3 @@ -315,9 +315,9 @@ is the buffer is allocated. .I Mpfmt can be used with -.IR fmtinstall (3) +.IM fmtinstall (3) and -.IR print (3) +.IM print (3) to print hexadecimal representations of .BR mpint s. .PP blob - 0c429fba9fc42ac9f6f3bfbb64fb83cdd21cdec4 blob + 180528b9e93fae685bc5f62608a3d094ac910388 --- man/man3/mux.3 +++ man/man3/mux.3 @@ -123,7 +123,7 @@ nil if an error occurred. .I Muxprocs allocates new procs (see -.IR thread (3)) +.IM thread (3) ) in which to run .I send and @@ -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 (3)-based +.IM select (3) -based main loop. .I Muxrpcstart runs the first half of @@ -176,7 +176,7 @@ with .SH SOURCE .B \*9/src/libmux .SH SEE ALSO -.IR thread (3), +.IM thread (3) , .IR intro (9p) .SH BUGS .I Libmux blob - 14c845b65d2b0f89ac6bf38b7c26f16d2d9c2113 blob + 2392f3ff5c75d5b5a2b5051cd4461bdcf59b0b3d --- man/man3/ndb.3 +++ man/man3/ndb.3 @@ -88,13 +88,13 @@ Ndbtuple* ndbsubstitute(Ndbtuple *t, Ndbtuple *from, N These routines are used by network administrative programs to search the network database. They operate on the database files described in -.IR ndb (7). +.IM ndb (7) . .PP .I Ndbopen opens the database .I file and calls -.IR malloc (3) +.IM malloc (3) to allocate a buffer for it. If .I file @@ -128,7 +128,7 @@ is used to find each successive match. On a successful search both return a linked list of .I Ndbtuple structures acquired by -.IR malloc (3) +.IM malloc (3) that represent the attribute/value pairs in the entry. On failure they return zero. @@ -450,8 +450,8 @@ directory of network database files .SH SOURCE .B \*9/src/libndb .SH SEE ALSO -.IR ndb (1) -.IR ndb (7) +.IM ndb (1) +.IM ndb (7) .SH DIAGNOSTICS .IR Ndbgetvalue and blob - 071b89165e9061a99fc4a6ffeeee210d81ee8806 blob + c19d15534166bcd9b6572f6ae0d8f6e6e27c99be --- man/man3/needstack.3 +++ man/man3/needstack.3 @@ -45,7 +45,7 @@ is a no-op. .I Needstack should be thought of as a comment checked at run time, like -.IR assert (3). +.IM assert (3) . .SH EXAMPLE The X Window library implementation of .I XLookupString @@ -57,7 +57,7 @@ before making calls to .IR XLookupString . If a thread (in this case, the keyboard-reading thread used inside the -.IR draw (3) +.IM draw (3) library) does not allocate a large enough stack, the problem is diagnosed immediately rather than left to corrupt memory. @@ -66,4 +66,4 @@ immediately rather than left to corrupt memory. .br .B \*9/src/libthread .SH SEE ALSO -.IR thread (3) +.IM thread (3) blob - 7dd768e7483e03978906b3deb2c02189034d0beb blob + 269fe4b07ec0b7a4e6e768fea5c1f1c3e27aa41f --- man/man3/notify.3 +++ man/man3/notify.3 @@ -33,12 +33,12 @@ or writing on a closed pipe, a is posted to communicate the exception. A note may also be posted by another process via -.IR postnote (3). +.IM postnote (3) . On Unix, notes are implemented as signals. .PP When a note is received, the action taken depends on the note. See -.IR signal (7) +.IM signal (7) for the full description of the defaults. .PP The default actions may be overridden. @@ -53,10 +53,10 @@ replaces the previous handler, if any. An argument of zero cancels a previous handler, restoring the default action. A -.IR fork (2) +.IM fork (2) system call leaves the handler registered in both the parent and the child; -.IR exec (3) +.IM exec (3) restores the default behavior. Handlers may not perform floating point operations. .PP @@ -112,17 +112,17 @@ set up with using the .I notejmp function (see -.IR setjmp (3)). +.IM setjmp (3) ). .PP Unix provides a fixed set of notes (typically there are 32) called .IR signals . It also allows a process to block certain notes from being delivered (see -.IR sigprocmask (2)) +.IM sigprocmask (2) ) and to ignore certain notes by setting the signal hander to the special value .B SIG_IGN (see -.IR signal (2)). +.IM signal (2) ). .I Noteenable and .I notedisable @@ -137,7 +137,7 @@ is called upon receipt of the note; if the handler is Regardless of the origin of the note or the presence of a handler, if the process is being debugged (see -.IR ptrace (2)) +.IM ptrace (2) ) the arrival of a note puts the process in the .B Stopped state and awakens the debugger. @@ -252,7 +252,7 @@ are usually generated by the operating system. .br .B \*9/src/lib9/atnotify.c .SH SEE ALSO -.IR intro (3), +.IM intro (3) , .I notejmp in -.IR setjmp (3) +.IM setjmp (3) blob - 750aa65c728eb7243beb8c562aab9efec1731a5b blob + adc38feb109a5ce04f6712a611fc7459f857ede8 --- man/man3/open.3 +++ man/man3/open.3 @@ -34,7 +34,7 @@ says to truncate the file to zero length before opening it; .B OCEXEC says to close the file when an -.IR exec (3) +.IM exec (3) or .I execl system call is made; @@ -48,7 +48,7 @@ are always appended to the end of the file. fails if the file does not exist or the user does not have permission to open it for the requested purpose (see -.IR stat (3) +.IM stat (3) for a description of permissions). The user must have write permission on the .I file @@ -61,7 +61,7 @@ system call (unlike the implicit .I open in -.IR exec (3)), +.IM exec (3) ), .B OEXEC is actually identical to .BR OREAD . @@ -143,8 +143,8 @@ allows the file descriptor to be reused. .SH SOURCE .B \*9/src/lib9 .SH SEE ALSO -.IR intro (3), -.IR stat (3) +.IM intro (3) , +.IM stat (3) .SH DIAGNOSTICS These functions set .IR errstr . @@ -169,4 +169,4 @@ are preprocessor macros defined as and .IR p9create ; see -.IR intro (3). +.IM intro (3) . blob - 63af2da7faf069a05014cdcaff4fcf3062959e40 blob + 33c0b060a9a516c2642e217c07aee688de74e510 --- man/man3/opentemp.3 +++ man/man3/opentemp.3 @@ -25,7 +25,7 @@ to .L z are tried until the name of a file that does not yet exist (see -.IR access (2)) +.IM access (2) ) is generated. .I Opentemp then opens the file for the given @@ -49,4 +49,4 @@ will never return the same name. .SH "SEE ALSO .I create in -.IR open (3) +.IM open (3) blob - 10decb696e264969df45c65e6ddafc4ab020119d blob + c134eaa27ffc10d0436015247771ab9d67560212 --- man/man3/pipe.3 +++ man/man3/pipe.3 @@ -25,7 +25,7 @@ is available for reading from After the pipe has been established, cooperating processes created by subsequent -.IR fork (2) +.IM fork (2) calls may pass data through the pipe with .I read @@ -53,14 +53,14 @@ calls. .\" .IR stat (3)). .PP When all the data has been read from a pipe and the writer has closed the pipe or exited, -.IR read (3) +.IM read (3) will return 0 bytes. Writes to a pipe with no reader will generate a note .BR "sys: write on closed pipe" . .SH SOURCE .B \*9/src/lib9/pipe.c .SH SEE ALSO -.IR intro (3), -.IR read (3) +.IM intro (3) , +.IM read (3) .SH DIAGNOSTICS Sets .IR errstr . @@ -79,7 +79,7 @@ Unix pipes are not guaranteed to be bidirectional. In order to ensure a bidirectional channel, .I p9pipe creates Unix domain sockets via the -.IR socketpair (2) +.IM socketpair (2) instead of Unix pipes. .PP The implementation of pipes as Unix domain sockets @@ -89,11 +89,11 @@ Unix's dup device. If a Unix domain socket is open as descriptor 0, some implementations disallow the opening of .BR /dev/fd/0 ; instead one must -.IR connect (2) +.IM connect (2) to it. If this functionality is important (as it is for -.IR rc (1)), +.IM rc (1) ), one must .B #undef .B pipe blob - fa78a2b5ab91ce1772a683266b906e2c9e88aad1 blob + 28185a882422a70438a8162e4e118f3bd8010b9c --- man/man3/plumb.3 +++ man/man3/plumb.3 @@ -68,7 +68,7 @@ Plumbmsg* plumbrecvfid(CFid *fid) int plumbsendtofid(CFid *fid, Plumbmsg *m) .SH DESCRIPTION These routines manipulate -.IR plumb (7) +.IM plumb (7) messages, transmitting them, receiving them, and converting them between text and these data structures: .IP @@ -99,7 +99,7 @@ struct Plumbattr opens the named plumb .IR port , using -.IR open (3) +.IM open (3) mode .IR omode . If @@ -108,11 +108,11 @@ begins with a slash, it is taken as a literal file nam otherwise .I plumbopen searches for the location of the -.IR plumber (4) +.IM plumber (4) service and opens the port there. .PP For programs using the -.IR event (3) +.IM event (3) interface, .I eplumb registers, using the given @@ -121,9 +121,9 @@ receipt of messages from the named .IR port . .PP The library mounts the -.IR plumber (4) +.IM plumber (4) service on demand (using the -.IR 9pclient (3)) +.IM 9pclient (3) ) library and reuses the mount instance for future calls to .IR plumbopen . @@ -157,7 +157,7 @@ to frees all the data associated with the message .IR m , all the components of which must therefore have been allocated with -.IR malloc (3). +.IM malloc (3) . .PP .I Plumbrecv returns the next message available on the file descriptor @@ -259,7 +259,7 @@ The file descriptor returned by is created with .I fsopenfd (see -.IR 9pclient (3)), +.IM 9pclient (3) ), which masks information about read and write errors. This is acceptable for use in .I plumbrecv @@ -276,10 +276,10 @@ that preserves the exact error details. .SH SOURCE .B \*9/src/libplumb .SH SEE ALSO -.IR plumb (1), -.IR event (3), -.IR plumber (4), -.IR plumb (7) +.IM plumb (1) , +.IM event (3) , +.IM plumber (4) , +.IM plumb (7) .SH DIAGNOSTICS When appropriate, including when a .I plumbsend blob - c3b69d71c679dfe335d2b91913b88518f1577d24 blob + 4bf1a68b13a8b7a56a898b811e0fcb16d160aedb --- man/man3/post9pservice.3 +++ man/man3/post9pservice.3 @@ -11,11 +11,11 @@ int post9pservice(int fd, char *name, char *mtpt) .SH DESCRIPTION .I Post9pservice invokes -.IR 9pserve (4) +.IM 9pserve (4) to post a new 9P service in the current ``name space'' (see -.IR intro (4)) +.IM intro (4) ) named .IR name . Clients connecting to the posted service @@ -30,10 +30,10 @@ is non-nil, mounts the service on .IR mtpt , using -.IR 9pfuse (4). +.IM 9pfuse (4) . .SH "SEE ALSO -.IR intro (4), -.IR 9pfuse (4), -.IR 9pserve (4) +.IM intro (4) , +.IM 9pfuse (4) , +.IM 9pserve (4) .SH SOURCE .B \*9/src/lib9/post9p.c blob - 7c323964e9026e105ce4026616ab241ca8e7ad48 blob + 3dd7796d0c52df77fa5620d099cd41f503efe2d8 --- man/man3/postnote.3 +++ man/man3/postnote.3 @@ -38,8 +38,8 @@ Returns zero if the write succeeds, otherwise \-1. .SH SOURCE .B \*9/src/lib9/postnote.c .SH "SEE ALSO" -.IR notify (3), -.IR intro (3) +.IM notify (3) , +.IM intro (3) .SH DIAGNOSTICS Sets .IR errstr . blob - 01a308e8a5551c3dfb36def28717ae9486ee3caa blob + 4e4987d3fcb57685a2c4a88528926323ce5e08f2 --- man/man3/prime.3 +++ man/man3/prime.3 @@ -93,8 +93,8 @@ slow algorithm. .SH SOURCE .B \*9/src/libsec .SH SEE ALSO -.IR aes (3) -.IR blowfish (3), -.IR des (3), -.IR elgamal (3), -.IR rsa (3), +.IM aes (3) +.IM blowfish (3) , +.IM des (3) , +.IM elgamal (3) , +.IM rsa (3) , blob - a701bc040a5aefbfc0e89513ec416a3aa9e01c48 blob + 997b5cb3a91ac87c1f2c949c1a39184384cfa438 --- man/man3/print.3 +++ man/man3/print.3 @@ -67,7 +67,7 @@ writes to the named output file descriptor: a buffered form is described in -.IR bio (3). +.IM bio (3) . .I Sprint places text followed by the NUL character @@ -104,7 +104,7 @@ is like .IR sprint , except that it prints into and returns a string of the required length, which is allocated by -.IR malloc (3). +.IM malloc (3) . .PP The routines .IR runesprint , @@ -361,7 +361,7 @@ The .B S verb is similar, but it interprets its pointer as an array of runes (see -.IR utf (7)); +.IM utf (7) ); the runes are converted to .SM UTF before output. @@ -389,10 +389,10 @@ but that will change if pointers and integers are diff The .B r verb takes no arguments; it copies the error string returned by a call to -.IR errstr (3). +.IM errstr (3) . .PP Custom verbs may be installed using -.IR fmtinstall (3). +.IM fmtinstall (3) . .SH EXAMPLE This function prints an error message with a variable number of arguments and then quits. @@ -415,9 +415,9 @@ void fatal(char *msg, ...) .SH SOURCE .B \*9/src/lib9/fmt .SH SEE ALSO -.IR fmtinstall (3), -.IR fprintf (3), -.IR utf (7) +.IM fmtinstall (3) , +.IM fprintf (3) , +.IM utf (7) .SH DIAGNOSTICS Routines that write to a file descriptor or call .IR malloc @@ -425,7 +425,7 @@ set .IR errstr . .SH BUGS The formatting is close to that specified for ANSI -.IR fprintf (3); +.IM fprintf (3) ; the main difference is that .B b and blob - 2d5da3afc7968f9f15c77a396a599cae5e0fc2a8 blob + eceb6381322fd8d130de275125bf9318362dcb34 --- man/man3/proto.3 +++ man/man3/proto.3 @@ -24,7 +24,7 @@ int rdproto(char *proto, char *root, Protoenum *enm, .I Rdproto reads and interprets the named .I proto -file relative to the +file relative to the root directory .IR root . .PP @@ -45,9 +45,9 @@ The fifth field is the name of the file from which to this file is read from the current name space, not the source file tree. All fields except the first are optional. -Specifying +Specifying .B - -for permissions, owner, or group +for permissions, owner, or group causes .I rdproto to fetch the corresponding information @@ -92,29 +92,29 @@ Only the and .B length fields are guaranteed to be valid. -The argument +The argument .I a is the same argument passed to .IR rdproto ; typically it points at some extra state used by the enumeration function. .PP -When files or directories do not exist or -cannot be read by +When files or directories do not exist or +cannot be read by .IR rdproto , -it formats a warning message, calls +it formats a warning message, calls .IR warn , -and continues processing; +and continues processing; if .I warn -is nil, +is nil, .I rdproto prints the warning message to standard error. .PP .I Rdproto returns zero if -.I proto +.I proto was processed, \-1 if it could not be opened. .SH FILES .TF /sys/lib/sysconfig/proto/portproto @@ -127,5 +127,6 @@ generic prototype file. .SH SOURCE .B \*9/src/libdisk/proto.c .SH SEE ALSO -.IR mk9660 (1), -Plan 9's \fImkfs\fR(8) +.IM mk9660 (1) , +Plan 9's +.IR mkfs (8) blob - fa0a080cacd9e3930e65e046e1770e25ab7d919b blob + 21730d337b6d484948ef9656785cef4e2d3edea1 --- man/man3/pushtls.3 +++ man/man3/pushtls.3 @@ -46,7 +46,7 @@ TLS is nearly the same as SSL 3.0, and the software sh with implementations of either standard. .PP To use just the record layer, as described in Plan 9's -\fItls\fR(3), +.IR tls (3), call .I pushtls to open the record layer device, connect to the communications channel @@ -108,7 +108,7 @@ used by a client to resume a previously negotiated sec On output, the connection directory is set, as with .B listen (see -.IR dial (3)). +.IM dial (3) ). The input .I cert is freed and a freshly allocated copy of the remote's certificate @@ -149,7 +149,7 @@ The private key corresponding to .I cert.pem should have been previously loaded into factotum. (See -.IR rsa (3) +.IM rsa (3) .\" XXX should be rsa(8) for more about key generation.) By setting @@ -164,10 +164,10 @@ known to the client. is not required for the ongoing conversation and may be freed by the application whenever convenient. .SH FILES -.TP +.TP .B /sys/lib/tls thumbprints of trusted services -.TP +.TP .B /sys/lib/ssl PEM certificate files .SH SOURCE @@ -175,12 +175,12 @@ PEM certificate files .\" .br .B \*9/src/libsec/port .SH "SEE ALSO" -.IR dial (3), -.IR thumbprint (7); +.IM dial (3) , +.IM thumbprint (7) ; Plan 9's -\fIfactotum\fR(4) +.IR factotum (4) and -\fItls\fR(3) +.IR tls (3) .SH DIAGNOSTICS return \-1 on failure. .SH BUGS blob - 5929ece2db07b87616ea363e379af4eddf8d061a blob + 785158c69793a8ef2f09b602c80652fda390dfc2 --- man/man3/qball.3 +++ man/man3/qball.3 @@ -68,7 +68,7 @@ and normal to the axis. .SH SOURCE .B \*9/src/libgeometry/qball.c .SH SEE ALSO -.IR quaternion (3) +.IM quaternion (3) .br Ken Shoemake, ``Animating Rotation with Quaternion Curves'', blob - 224baea7206af6c92d7df6a859f9c8c5be309abe blob + f51a1e7f2b3130bdbca65545238498b615ce9582 --- man/man3/quaternion.3 +++ man/man3/quaternion.3 @@ -121,7 +121,7 @@ The following routines operate on rotations or orienta .TP .B mtoq Convert a rotation matrix (see -.IR matrix (3)) +.IM matrix (3) ) to a unit quaternion. .TP .B qtom @@ -148,12 +148,12 @@ This is just a rotation about the same axis by half th .SH SOURCE .B \*9/src/libgeometry/quaternion.c .SH SEE ALSO -.IR matrix (3), -.IR qball (3) +.IM matrix (3) , +.IM qball (3) .SH BUGS To avoid name conflicts with NetBSD, .I qdiv is a preprocessor macro defined as .IR p9qdiv ; see -.IR intro (3). +.IM intro (3) . blob - ae6c6c28f89070e934c39923dd8dff0551d7bd69 blob + d34e4893d50c602f300b2f34bab121e4e5164807 --- man/man3/quote.3 +++ man/man3/quote.3 @@ -58,10 +58,10 @@ The empty string is represented by two quotes, The first four functions act as variants of .B strdup (see -.IR strcat (3)). +.IM strcat (3) ). Each returns a freshly allocated copy of the string, created using -.IR malloc (3). +.IM malloc (3) . .I Quotestrdup returns a quoted copy of .IR s , @@ -75,7 +75,7 @@ The versions of these functions do the same for .CW Rune strings (see -.IR runestrcat (3)). +.IM runestrcat (3) ). .PP The string returned by .I quotestrdup @@ -124,13 +124,13 @@ blanks, control characters, and quotes are always quot is provided as a .I doquote function that flags any character special to -.IR rc (1). +.IM rc (1) . .PP .I Quotestrfmt and .I quoterunestrfmt are -.IR print (3) +.IM print (3) formatting routines that produce quoted strings as output. They may be installed by hand, but .I quotefmtinstall @@ -154,21 +154,21 @@ statements so the compiler can type-check uses of and .B %Q in -.IR print (3) +.IM print (3) format strings. .SH SOURCE .B \*9/src/lib9/quote.c .br .B \*9/src/lib9/fmt/fmtquote.c .SH "SEE ALSO -.IR rc (1), -.IR malloc (3), -.IR print (3), -.IR strcat (3) +.IM rc (1) , +.IM malloc (3) , +.IM print (3) , +.IM strcat (3) .SH BUGS Because it is provided by the format library, .I doquote is a preprocessor macro defined as .IR fmtdoquote ; see -.IR intro (3). +.IM intro (3) . blob - 3eaa05f53ab7732a1edb0ac07bc503e08a73dcaa blob + 8d35e444b0632f048ca32229faa903cf653c36ea --- man/man3/rand.3 +++ man/man3/rand.3 @@ -125,7 +125,7 @@ truly random bytes read from .PP .I Prng uses the native -.IR rand (3) +.IM rand (3) pseudo-random number generator to fill the buffer. Used with .IR srand , this function can produce a reproducible stream of pseudo random @@ -138,7 +138,7 @@ and may be passed to .I mprand (see -.IR mp (3)). +.IM mp (3) ). .PP .I Fastrand uses @@ -161,7 +161,7 @@ to return a uniform .B \*9/src/libsec/port .SH "SEE ALSO .\" .IR cons (3), -.IR mp (3) +.IM mp (3) .SH BUGS .I Truerand and @@ -181,7 +181,7 @@ are preprocessor macros defined as .IR p9lrand , and so on; see -.IR intro (3). +.IM intro (3) . .ie \n(HT .ds HT " .el .ds HT " (see HTML-formatted man page for link) .PP blob - 026c8352f594d4585c9c87ce66466df23a1c938c blob + 1b7888d9d38cf06c6c5393dad52c3ae295a793d9 --- man/man3/rc4.3 +++ man/man3/rc4.3 @@ -43,13 +43,13 @@ structure keeps track of the algorithm. .SH SOURCE .B \*9/src/libsec .SH SEE ALSO -.IR mp (3), -.IR aes (3), -.IR blowfish (3), -.IR des (3), -.IR dsa (3), -.IR elgamal (3), -.IR rsa (3), -.IR sechash (3), -.IR prime (3), -.IR rand (3) +.IM mp (3) , +.IM aes (3) , +.IM blowfish (3) , +.IM des (3) , +.IM dsa (3) , +.IM elgamal (3) , +.IM rsa (3) , +.IM sechash (3) , +.IM prime (3) , +.IM rand (3) blob - cd4dbf3d2b4024998f09bd8f49cc7554fcc2427e blob + a176ad6d957621c0ca022d39cda5d77eb8d1de5b --- man/man3/read.3 +++ man/man3/read.3 @@ -65,7 +65,7 @@ if this is not the same as requested. and .I Pwrite equivalent to a -.IR seek (3) +.IM seek (3) to .I offset followed by a @@ -83,10 +83,10 @@ without interference. .SH SOURCE .B \*9/src/lib9/readn.c .SH SEE ALSO -.IR intro (3), +.IM intro (3) , .IR open (3), -.IR dup (3), -.IR pipe (3) +.IM dup (3) , +.IM pipe (3) .SH DIAGNOSTICS These functions set .IR errstr . blob - 82ccdcfd6679f319ea081b2fca1625d09310271d blob + d559cdabe06b6688fc85775724c605cc281602cb --- man/man3/readcolmap.3 +++ man/man3/readcolmap.3 @@ -63,14 +63,14 @@ Both return 0 on success, or \-1 on error, setting .PP Changing the hardware color map does not change the color map used by the -.IR draw (3) +.IM draw (3) operator to convert between mapped and true color or greyscale images, which is described in -.IR color (7). +.IM color (7) . .SH SOURCE .B \*9/src/libdraw .SH "SEE ALSO" -.IR graphics (3), -.IR draw (3), -.IR color (7) +.IM graphics (3) , +.IM draw (3) , +.IM color (7) blob - dd284b9705dc7a0b456eed86852651fbe393c95d blob + cf2df9bad37de1396ca7882e56dd0ca3dc6d23b7 --- man/man3/readcons.3 +++ man/man3/readcons.3 @@ -31,7 +31,7 @@ is non-zero, the input is not echoed to the screen. A stripped-down version of .I netkey (see -.IR passwd (1)): +.IM passwd (1) ): .IP .EX pass = readcons("password", nil, 1); blob - 069e1d232e408c84441c500a1cedf6907dd05b9f blob + a7a5ac8b1c1638b9154d24f30c5a225b5f0f6fa8 --- man/man3/regexp.3 +++ man/man3/regexp.3 @@ -42,11 +42,11 @@ compiles a regular expression and returns a pointer to the generated description. The space is allocated by -.IR malloc (3) +.IM malloc (3) and may be released by .IR free . Regular expressions are exactly as in -.IR regexp (7). +.IM regexp (7) . .PP .I Regcomplit is like @@ -196,7 +196,7 @@ array elements should be used. .SH SOURCE .B \*9/src/libregexp .SH "SEE ALSO" -.IR grep (1) +.IM grep (1) .SH DIAGNOSTICS .I Regcomp returns blob - d1d383cc5f42757eb6f869b502f16c8edfb1822c blob + df5048f775f6400fd25aa858ca3138904bfb502d --- man/man3/rfork.3 +++ man/man3/rfork.3 @@ -15,14 +15,14 @@ int rfork(int flags) is a partial implementation of the Plan 9 system call. It can be used to manipulate some process state and to create new processes a la -.IR fork (2). +.IM fork (2) . It cannot be used to create shared-memory processes (Plan 9's .B RFMEM flag); for that functionality use .I proccreate (see -.IR thread (3)). +.IM thread (3) ). .PP The .I flags @@ -45,7 +45,7 @@ If set, the child process will be dissociated from the exit the child will leave no .B Waitmsg (see -.IR wait (3)) +.IM wait (3) ) for the parent to collect. .\" .TP .\" .B RFNAMEG @@ -81,9 +81,9 @@ for the parent to collect. Each process is a member of a group of processes that all receive notes when a note is sent to the group (see -.IR postnote (3) +.IM postnote (3) and -.IR signal (2)). +.IM signal (2) ). The group of a new process is by default the same as its parent, but if .B RFNOTEG is set (regardless of @@ -154,7 +154,7 @@ will sleep, if necessary, until required process resou Calling .B rfork(RFFDG|RFPROC) is equivalent to calling -.IR fork (2). +.IM fork (2) . .SH SOURCE .B \*9/src/lib9/rfork.c .SH DIAGNOSTICS blob - 0c1396a891ba544b35a2077ef66468c4b69808b8 blob + 8bea1aab40f68147b574aac946576d6ba82cc276 --- man/man3/rsa.3 +++ man/man3/rsa.3 @@ -197,7 +197,7 @@ The subject line is conventionally of the form using the quoting conventions of .I tokenize (see -.IR getfields (3)). +.IM getfields (3) ). .PP .I X509req creates an X.509 certification request. @@ -241,14 +241,14 @@ struct PEMChain .SH SOURCE .B \*9/src/libsec .SH SEE ALSO -.IR mp (3), -.IR aes (3), -.IR blowfish (3), -.IR des (3), -.IR dsa (3), -.IR elgamal (3), -.IR rc4 (3), -.IR sechash (3), -.IR prime (3), -.IR rand (3) +.IM mp (3) , +.IM aes (3) , +.IM blowfish (3) , +.IM des (3) , +.IM dsa (3) , +.IM elgamal (3) , +.IM rc4 (3) , +.IM sechash (3) , +.IM prime (3) , +.IM rand (3) .\" .IR pem (8) blob - 5bb2224eec1412c411eae92dd9c89d33490e6fcb blob + d4fcf89d17c7128f304d75268938560e8d7b97f5 --- man/man3/rune.3 +++ man/man3/rune.3 @@ -189,5 +189,5 @@ returns .br .B \*9/src/lib9/utf/utfrune.c .SH SEE ALSO -.IR utf (7), -.IR tcs (1) +.IM utf (7) , +.IM tcs (1) blob - 347c7219ff52083e5d4c8b1f09c1ec81677e2fe8 blob + eff637e41f1dfdd50ce69f8f3f7cddcc6bf3025e --- man/man3/runestrcat.3 +++ man/man3/runestrcat.3 @@ -56,12 +56,12 @@ Rune* runestrstr(Rune *s1, Rune *s2) .SH DESCRIPTION These functions are rune string analogues of the corresponding functions in -.IR strcat (3). +.IM strcat (3) . .SH SOURCE .B \*9/src/lib9 .SH SEE ALSO -.IR memory (3), -.IR rune (3), -.IR strcat (3) +.IM memory (3) , +.IM rune (3) , +.IM strcat (3) .SH BUGS The outcome of overlapping moves varies among implementations. blob - e0709b2e9394fa943dd60f70a689e430ce3ed7e6 blob + 77c91f94c26b0e3378b27f338e43e2eb414760d4 --- man/man3/searchpath.3 +++ man/man3/searchpath.3 @@ -13,9 +13,9 @@ char* searchpath(char *name) searches for the executable .I name in the same way that -.IR sh (1) +.IM sh (1) and -.IR rc (1) +.IM rc (1) do. .PP The environment variable @@ -32,9 +32,9 @@ returns a pointer to a malloced string containing a pa or simply .IR name ) suitable for use in -.IR open (3) +.IM open (3) or -.IR exec (3). +.IM exec (3) . .PP If .I name blob - d8b1cd48cce6ea6c19c1733f9e9a8bbc72f03c09 blob + a7c6970d4bb9cb0fd0f78fc4158fac6708a81d5e --- man/man3/sechash.3 +++ man/man3/sechash.3 @@ -138,14 +138,14 @@ and .I sha1unpickle unmarshal a pickled digest. All four routines return a pointer to a newly -.IR malloc (3)'d +.IM malloc (3) 'd object. .SH SOURCE .B \*9/src/libsec .SH SEE ALSO -.IR aes (3), -.IR blowfish (3), -.IR des (3), -.IR elgamal (3), -.IR rc4 (3), -.IR rsa (3) +.IM aes (3) , +.IM blowfish (3) , +.IM des (3) , +.IM elgamal (3) , +.IM rc4 (3) , +.IM rsa (3) blob - 36c594c4b29f9fcf326a664cf4f982859287da0a blob + a95f37ff48dc7cbf37aecb0b4bdf1b3c360a96f7 --- man/man3/seek.3 +++ man/man3/seek.3 @@ -39,8 +39,8 @@ Seeking in a pipe is a no-op. .SH SOURCE .B \*9/src/lib9/seek.c .SH SEE ALSO -.IR intro (3), -.IR open (3) +.IM intro (3) , +.IM open (3) .SH DIAGNOSTICS Sets .IR errstr . @@ -50,4 +50,4 @@ To avoid name conflicts with the underlying system, is a preprocessor macro defined as .IR p9seek ; see -.IR intro (3). +.IM intro (3) . blob - 771bd9ae59d3624fb6884076a9e8072fd4bd80bf blob + 82fd8a499997d8092689ace8d90850e42949a77c --- man/man3/sendfd.3 +++ man/man3/sendfd.3 @@ -20,14 +20,14 @@ and can be used to pass an open file descriptor over a Unix domain socket from one process to another. Since -.IR pipe (3) +.IM pipe (3) is implemented with -.IR socketpair (2) +.IM socketpair (2) instead of -.IR pipe (2), +.IM pipe (2) , .I socket can be a file descriptor obtained from -.IR pipe (3). +.IM pipe (3) . .PP .I Sendfd sends the file descriptor @@ -51,7 +51,7 @@ will not. .SH SOURCE .B \*9/src/lib9/sendfd.c .SH SEE ALSO -.IR socketpair (2), +.IM socketpair (2) , .I sendmsg in -.IR send (2) +.IM send (2) blob - 1210c1712f114a349dcdc52db3c4f23ee2106657 blob + 16fb0387e5942f4903359e89a9856831a7a27360 --- man/man3/setjmp.3 +++ man/man3/setjmp.3 @@ -46,7 +46,7 @@ was called. is the same as .I longjmp except that it is to be called from within a note handler (see -.IR notify (3)). +.IM notify (3) ). The .I uregs argument should be the first argument passed to the note handler. @@ -58,7 +58,7 @@ can also be used to switch stacks. .SH SOURCE .B \*9/src/lib9/jmp.c .SH SEE ALSO -.IR notify (3) +.IM notify (3) .SH BUGS .PP .I Notejmp @@ -78,10 +78,11 @@ are preprocessor macros defined as and .IR p9jmp_buf ; see -.IR intro (3). +.IM intro (3) . .PP .I P9setjmp is implemented as a preprocessor macro that calls .I sigsetjmp (see -Unix's \fIsetjmp\fR(3)). +Unix's +.IR setjmp (3)). blob - 0afa71d22b9b3ae30cc8ddb96fe1d1e58465f550 blob + 0bccc15f8645971dc1debb50677a136ea6e02a8d --- man/man3/sleep.3 +++ man/man3/sleep.3 @@ -27,7 +27,7 @@ Sleep returns \-1 if interrupted, 0 otherwise. causes an .B alarm note (see -.IR notify (3)) +.IM notify (3) ) to be sent to the invoking process after the number of milliseconds given by the argument. Successive calls to @@ -39,7 +39,7 @@ the alarm clock. .SH SOURCE .B \*9/src/lib9/sleep.c .SH SEE ALSO -.IR intro (3) +.IM intro (3) .SH DIAGNOSTICS These functions set .IR errstr . @@ -53,4 +53,4 @@ are preprocessor macros defined as and .IR p9alarm ; see -.IR intro (3). +.IM intro (3) . blob - a992f9a5393bcffaad64ec9644ce1405ad0aed82 blob + 253833f64f75abe9eea663c61440159d806af9e2 --- man/man3/stat.3 +++ man/man3/stat.3 @@ -105,7 +105,7 @@ struct Dir { .EE .PP The returned structure is allocated by -.IR malloc (3); +.IM malloc (3) ; freeing it also frees the associated strings. .PP This structure and @@ -283,9 +283,9 @@ to retrieve the initial values first. .SH SOURCE .B \*9/src/lib9/dirstat.c .SH SEE ALSO -.IR intro (3), -.IR fcall (3), -.IR dirread (3), +.IM intro (3) , +.IM fcall (3) , +.IM dirread (3) , .IR stat (9p) .SH DIAGNOSTICS The @@ -305,7 +305,7 @@ or is too short for the returned data, the return value will be .B BIT16SZ (see -.IR fcall (3)) +.IM fcall (3) ) and the two bytes returned will contain the initial count field of the returned data; blob - 2baa909090f67da93abcae8324f214069712390c blob + 3cf29477876c02510170393f191e0666427295fc --- man/man3/strcat.3 +++ man/man3/strcat.3 @@ -222,7 +222,7 @@ is returned. returns a pointer to a distinct copy of the null-terminated string .I s in space obtained from -.IR malloc (3) +.IM malloc (3) or .L 0 if no space can be obtained. @@ -244,14 +244,14 @@ operates analogously, but ignores ASCII case differenc .SH SOURCE .B \*9/src/lib9 .SH SEE ALSO -.IR memory (3), -.IR rune (3), -.IR runestrcat (3) +.IM memory (3) , +.IM rune (3) , +.IM runestrcat (3) .SH BUGS These routines know nothing about .SM UTF. Use the routines in -.IR rune (3) +.IM rune (3) as appropriate. Note, however, that the definition of .SM UTF blob - 9b88e8d4b20796902fff2b4b044dd5d10332ce87 blob + 7862bb280553871572e9546e60281684d91a0e4d --- man/man3/string.3 +++ man/man3/string.3 @@ -268,4 +268,4 @@ The input stack has a maximum depth of 32 nested inclu .SH SOURCE .B \*9/src/libString .SH SEE ALSO -.IR bio (3) +.IM bio (3) blob - cbf154531c3a88afb36553726c49a01c160dfbe3 blob + 3ad0054cf0693f28803dbd6b44f6a56a7f434a5e --- man/man3/stringsize.3 +++ man/man3/stringsize.3 @@ -57,13 +57,13 @@ are analogous, but accept an array of runes rather tha .SH SOURCE .B \*9/src/libdraw .SH "SEE ALSO" -.IR addpt (3), -.IR cachechars (3), -.IR subfont (3), -.IR draw (3), -.IR draw (3), -.IR image (7), -.IR font (7) +.IM addpt (3) , +.IM cachechars (3) , +.IM subfont (3) , +.IM draw (3) , +.IM draw (3) , +.IM image (7) , +.IM font (7) .SH DIAGNOSTICS Because strings are loaded dynamically, these routines may generate I/O to the server and produce calls to the graphics error function. blob - 5e1b09ab6cadaaea7a53e02e5d6054824f7df240 blob + e321b7da590398e89d86186d230fb3723ee284cb --- man/man3/subfont.3 +++ man/man3/subfont.3 @@ -53,13 +53,13 @@ Font* mkfont(Subfont *f, Rune min) .SH DESCRIPTION Subfonts are the components of fonts that hold the character images. A font comprises an array of subfonts; see -.IR cachechars (3). +.IM cachechars (3) . A new .B Subfont is allocated and initialized with .IR allocsubfont . See -.IR cachechars (3) +.IM cachechars (3) for the meaning of .IR n , .IR height , @@ -81,7 +81,7 @@ The appropriate fields of the returned structure are set to the passed arguments, and the image is registered as a subfont with the graphics device -.IR draw (3). +.IM draw (3) . .I Allocsubfont returns 0 on failure. .PP @@ -97,7 +97,7 @@ on if .B f->info was not allocated by -.IR malloc (3) +.IM malloc (3) it should be zeroed before calling .IR subffree . .PP @@ -150,7 +150,7 @@ Although it is principally a routine internal to the l may be substituted by the application to provide a less file-oriented subfont naming scheme. .PP The format of a subfont file is described in -.IR font (7). +.IM font (7) . Briefly, it contains a image with all the characters in it, followed by a subfont header, followed by character information. .I Readsubfont @@ -181,13 +181,13 @@ the part of a subfont file that comes after the image. a call to .IR writeimage (see -.IR allocimage (3)). +.IM allocimage (3) ). .PP .I Stringsubfont is analogous to .B string (see -.IR draw (3)) +.IM draw (3) ) for subfonts. Rather than use the underlying font caching primitives, it calls .B draw @@ -224,12 +224,12 @@ bitmap font file tree .SH SOURCE .B \*9/src/libdraw .SH SEE ALSO -.IR graphics (3), -.IR allocimage (3), -.IR draw (3), -.IR cachechars (3), -.IR image (7), -.IR font (7) +.IM graphics (3) , +.IM allocimage (3) , +.IM draw (3) , +.IM cachechars (3) , +.IM image (7) , +.IM font (7) .SH DIAGNOSTICS All of the functions use the graphics error function (see -.IR graphics (3)). +.IM graphics (3) ). blob - c1e9b83c7aabdccc1496781ce1bba0c5be01d1ca blob + 8684ea1271d9362e9f3b4daa4c40abc73d31b47d --- man/man3/sysfatal.3 +++ man/man3/sysfatal.3 @@ -16,17 +16,17 @@ void sysfatal(char *fmt, ...) prints to standard error the name of the running program, a colon and a space, the message described by the -.IR print (3) +.IM print (3) format string .I fmt and subsequent arguments, and a newline. It then calls -.IR exits (3) +.IM exits (3) with the formatted message as argument. The program's name is the value of .BR argv0 , which will be set if the program uses the -.IR arg (3) +.IM arg (3) interface to process its arguments. If .B argv0 @@ -44,7 +44,7 @@ The message is a line with several fields: the name of the machine writing the message; the date and time; the message specified by the -.IR print (3) +.IM print (3) format .I fmt and any following arguments; @@ -60,9 +60,9 @@ can be used safely in multi-threaded programs. .br .B \*9/src/lib9/syslog.c .SH "SEE ALSO" -.IR intro (3), -.IR errstr (3), +.IM intro (3) , +.IM errstr (3) , the .B %r format in -.IR print (3) +.IM print (3) blob - 9088ae2e7ea99c973cee2e613e389e9b77d24434 blob + 41ac565f37d9f586837c6dc1a5b435c75c0cddaf --- man/man3/thread.3 +++ man/man3/thread.3 @@ -267,10 +267,10 @@ in arbitrary ways and should synchronize their actions using .B qlocks (see -.IR lock (3)) +.IM lock (3) ) or channel communication. System calls such as -.IR read (3) +.IM read (3) block the entire proc; all threads in a proc block until the system call finishes. .PP @@ -364,7 +364,7 @@ are threaded analogues of and .I execl (see -.IR exec (3)); +.IM exec (3) ); on success, they replace the calling thread and invoke the external program, never returning. @@ -400,7 +400,7 @@ and .I threadexec will duplicate (see -.IR dup (3)) +.IM dup (3) ) the three file descriptors in .I fd onto standard input, output, and error for the external program @@ -443,14 +443,14 @@ stop the running of the program. returns a channel of pointers to .B Waitmsg structures (see -.IR wait (3)). +.IM wait (3) ). When an exec'ed process exits, a pointer to a .B Waitmsg is sent to this channel. These .B Waitmsg structures have been allocated with -.IR malloc (3) +.IM malloc (3) and should be freed after use. .PP A @@ -611,13 +611,13 @@ calls. .PP .I Chanprint formats its arguments in the manner of -.IR print (3) +.IM print (3) and sends the result to the channel .IR c. The string delivered by .I chanprint is allocated with -.IR malloc (3) +.IM malloc (3) and should be freed upon receipt. .PP Thread library functions do not return on failure; @@ -628,10 +628,10 @@ Threaded programs should use in place of .I atnotify (see -.IR notify (3)). +.IM notify (3) ). .PP It is safe to use -.IR sysfatal (3) +.IM sysfatal (3) in threaded programs. .I Sysfatal will print the error string and call @@ -673,7 +673,7 @@ To create new processes, use .SH FILES .B \*9/acid/thread contains useful -.IR acid (1) +.IM acid (1) functions for debugging threaded programs. .PP .B \*9/src/libthread/test @@ -681,8 +681,8 @@ contains some example programs. .SH SOURCE .B \*9/src/libthread .SH SEE ALSO -.IR intro (3), -.IR ioproc (3) +.IM intro (3) , +.IM ioproc (3) .SH BUGS To avoid name conflicts, .IR alt , @@ -707,7 +707,7 @@ and so on. is defined as a macro that expands to .IR threadyield . See -.IR intro (3). +.IM intro (3) . .PP Threadint, threadintgrp, blob - dfcafaf903046d294560149dc2c8b52d0a6b1335 blob + 583a2d7fd1b2dabaa1e9137fed591607d3d56791 --- man/man3/time.3 +++ man/man3/time.3 @@ -41,4 +41,4 @@ are preprocessor macros defined as and .IR p9nsec ; see -.IR intro (3). +.IM intro (3) . blob - 11412596a2ec266be48cf36cd36814b34f52bf0a blob + 80142526ee0cb68913580ebd973860621ba1cfde --- man/man3/udpread.3 +++ man/man3/udpread.3 @@ -65,4 +65,4 @@ to send a response back to the sender of the original .SH SOURCE .B \*9/src/lib9/udp.c .SH SEE ALSO -.IR ip (3) +.IM ip (3) blob - 54e46c619edcb9058fa4d4192ba739e12c7ef8f4 blob + 8c2bd33d8d53b1ddca0519452c2682e1e5ef38bd --- man/man3/venti-cache.3 +++ man/man3/venti-cache.3 @@ -112,9 +112,9 @@ the block's cache address. allocates a new cache using the client connection .I z (see -.IR venti-conn (3) +.IM venti-conn (3) and -.IR venti-client (3)), +.IM venti-client (3) ), with .I maxmem bytes of memory. @@ -195,7 +195,7 @@ The default function is .I vtwrite (see -.IR venti-client (3)); +.IM venti-client (3) ); .I vtsetcachewrite sets it. .I Vtsetcachewrite @@ -230,8 +230,8 @@ or, more commonly, that cache blocks are being leaked. .SH SOURCE .B \*9/src/libventi .SH SEE ALSO -.IR venti (3), -.IR venti-client (3), -.IR venti-conn (3), -.IR venti-file (3), -.IR venti (7) +.IM venti (3) , +.IM venti-client (3) , +.IM venti-conn (3) , +.IM venti-file (3) , +.IM venti (7) blob - cc8d14f49ec44c8e9bb7a571c8a5ff7cbf2e2db1 blob + e475ef300a94f1341eb2a6fb62014b674bb535b0 --- man/man3/venti-client.3 +++ man/man3/venti-client.3 @@ -53,7 +53,7 @@ int vtping(VtConn *z) extern int ventidoublechecksha1; /* default 1 */ .SH DESCRIPTION These routines execute the client side of the -.IR venti (7) +.IM venti (7) protocol. .PP .I Vtrpc @@ -84,7 +84,7 @@ is typically called only indirectly, via calls .I vtversion (see -.IR venti-conn (3)) +.IM venti-conn (3) ) and .IR vthello , in that order, returning success only @@ -171,14 +171,14 @@ in the same proc should start separate procs running and .I vtrecvproc as described in -.IR venti-conn (3). +.IM venti-conn (3) . .SH SOURCE .B \*9/src/libventi .SH SEE ALSO -.IR venti (3), -.IR venti-conn (3), -.IR venti-packet (3), -.IR venti (7) +.IM venti (3) , +.IM venti-conn (3) , +.IM venti-packet (3) , +.IM venti (7) .SH DIAGNOSTICS .I Vtrpc and blob - ea597de3a7fc0cb0a64b806d6824bbd211480017 blob + 0c1b95d54ec788853ed874649b07580ad058ea71 --- man/man3/venti-conn.3 +++ man/man3/venti-conn.3 @@ -90,21 +90,21 @@ for reading and writing. .I Vtdial dials the given network address (see -.IR dial (3)) +.IM dial (3) ) and returns a corresponding connection. It returns nil if the connection cannot be established. .PP .I Vtversion exchanges version information with the remote side as described in -.IR venti (7). +.IM venti (7) . The negotiated version is stored in .IB z ->version \fR. .PP .I Vtsend writes a packet (see -.IR venti-packet (3)) +.IM venti-packet (3) ) on the connection .IR z . The packet @@ -115,7 +115,7 @@ be returned by .I vtsend will add the two-byte length field (see -.IR venti (7)) +.IM venti (7) ) at the begnning. .I Vtsend frees @@ -137,7 +137,7 @@ and block until the packet can be written or read from the network. In a threaded program (see -.IR thread (3)), +.IM thread (3) ), this may not be desirable. If the caller arranges for .IR vtsendproc @@ -192,12 +192,12 @@ as they are sent or received. .SH SOURCE .B \*9/src/libventi .SH SEE ALSO -.IR venti (1), -.IR venti (3), -.IR venti-client (3), -.IR venti-packet (3), -.IR venti-server (3), -.IR venti (7) +.IM venti (1) , +.IM venti (3) , +.IM venti-client (3) , +.IM venti-packet (3) , +.IM venti-server (3) , +.IM venti (7) .SH DIAGNOSTICS Routines that return pointers return nil on error. Routines returning integers return 0 on success, \-1 on error. blob - ed3916ffd0e92ce2bc2ab3828c835a51bc523c79 blob + e463c141fbfbc99cba9913edb6d5eca9d4ea5ed2 --- man/man3/venti-fcall.3 +++ man/man3/venti-fcall.3 @@ -109,7 +109,7 @@ converts a .B VtEntry structure describing a Venti file (see -.IR venti (7)) +.IM venti (7) ) into a 40-byte .RB ( VtEntrySize ) structure at @@ -122,7 +122,7 @@ converts a .B VtFcall structure describing a Venti protocol message (see -.IR venti (7)) +.IM venti (7) ) into a packet. .I Vtfcallunpack does the reverse conversion. @@ -130,7 +130,7 @@ does the reverse conversion. The fields in a .B VtFcall are named after the protocol fields described in -.IR venti (7), +.IM venti (7) , except that the .B type field is renamed @@ -158,7 +158,7 @@ and the packet The block type enumeration defined in .B (presented in -.IR venti (7)) +.IM venti (7) ) differs from the one used on disk and in the network protocol. The disk and network representation uses different @@ -232,7 +232,7 @@ is nil, the label is ignored. and .I vtscorefmt are -.IR print (3) +.IM print (3) formatters to print .B VtFcall structures and scores. @@ -244,9 +244,9 @@ is installed as .SH SOURCE .B \*9/src/libventi .SH SEE ALSO -.IR venti (1), -.IR venti (3), -.IR venti (7) +.IM venti (1) , +.IM venti (3) , +.IM venti (7) .SH DIAGNOSTICS .IR Vtentrypack , .IR vtfcallpack , blob - 5378bf5c22a5b17b2cedcf8847c75a055124e8c3 blob + 01003f7834c3944b3c3ba6c9d4c928712e8f0f3b --- man/man3/venti-file.3 +++ man/man3/venti-file.3 @@ -99,7 +99,7 @@ void vtfileunlock(VtFile *f); .SH DESCRIPTION These routines provide a simple interface to create and manipulate Venti file trees (see -.IR venti (7)). +.IM venti (7) ). .PP .I Vtfilecreateroot creates a new Venti file. @@ -226,7 +226,7 @@ if an error is encountered. .I Vtfilewrite writes to an in-memory copy of the data blocks (see -.IR venti-cache (3)) +.IM venti-cache (3) ) instead of writing directly to Venti. .I Vtfileflush writes all copied blocks associated with @@ -319,7 +319,7 @@ in the same directory block. .SH SOURCE .B \*9/src/libventi/file.c .SH SEE ALSO -.IR venti-cache (3), -.IR venti-conn (3), -.IR venti-client (3), -.IR venti (7) +.IM venti-cache (3) , +.IM venti-conn (3) , +.IM venti-client (3) , +.IM venti (7) blob - 6b74c6cd4ab229c15e536cdbf6c302e977917313 blob + 0d05af2ef8b5d69272ce980374f3e866163481ed --- man/man3/venti-log.3 +++ man/man3/venti-log.3 @@ -122,9 +122,9 @@ passed nil log structures. .PP The server library (see -.IR venti-conn (3) +.IM venti-conn (3) and -.IR venti-server (3)) +.IM venti-server (3) ) writes debugging information to the log named .IR VtServerLog , which defaults to the string @@ -132,5 +132,5 @@ which defaults to the string .SH SOURCE .B \*9/src/libventi .SH SEE ALSO -.IR venti (3), -.IR venti (8) +.IM venti (3) , +.IM venti (8) blob - 0a872a0a37d49eebb0325c40944fd6e55fe07d4c blob + 6877f0b6817f8f89fc66d2f967725b7e455f1e2f --- man/man3/venti-mem.3 +++ man/man3/venti-mem.3 @@ -35,7 +35,7 @@ void vtfree(void *ptr) .SH DESCRIPTION These routines allocate and free memory. On failure, they print an error message and call -.IR sysfatal (3). +.IM sysfatal (3) . They do not return. .PP .I Vtbrk @@ -63,4 +63,4 @@ when no longer needed. .SH SOURCE .B \*9/src/libventi .SH SEE ALSO -.IR venti (3) +.IM venti (3) blob - 3ed8d6fe4695e62c313fb7cf20bd26eb094d761f blob + 0f7386904bc34a2d8a92869d86a8cbcf802416bf --- man/man3/venti-packet.3 +++ man/man3/venti-packet.3 @@ -129,7 +129,7 @@ because fragments may not be filled completely. compares the data sections of two packets as .I memcmp (see -.IR memory (3)) +.IM memory (3) ) would. .PP .I Packetconcat @@ -260,7 +260,7 @@ bytes at offset .SH SOURCE .B \*9/src/libventi .SH SEE ALSO -.IR venti (3) +.IM venti (3) .SH DIAGNOSTICS These functions return errors only when passed invalid inputs, blob - 810852e1418d8192deb5744b2aefe62094aed2ef blob + 54b8cb4ac8669585cdda3a41d3719253305c8bd1 --- man/man3/venti-server.3 +++ man/man3/venti-server.3 @@ -33,7 +33,7 @@ VtReq* vtgetreq(VtSrv *srv) void vtrespond(VtReq *req) .SH DESCRIPTION These routines execute the server side of the -.IR venti (7) +.IM venti (7) protocol. .PP .I Vtsrvhello @@ -115,8 +115,8 @@ blocks written to it and returns error on all reads. .SH SOURCE .B \*9/src/libventi .SH SEE ALSO -.IR venti (3), -.IR venti-conn (3), -.IR venti-packet (3), -.IR venti (7), -.IR venti (8) +.IM venti (3) , +.IM venti-conn (3) , +.IM venti-packet (3) , +.IM venti (7) , +.IM venti (8) blob - 270b768019ecc2864e65cd2da7c09744c85486c8 blob + 4ee8f940145b970e36f919d197637efde654f7b2 --- man/man3/venti-zero.3 +++ man/man3/venti-zero.3 @@ -52,5 +52,5 @@ is the score of the zero-length block. .br .B \*9/src/libventi/zeroscore.c .SH SEE ALSO -.IR venti (3), -.IR venti (7) +.IM venti (3) , +.IM venti (7) blob - 632d5998e3fbce4c9f055b75b64d2a328ef50a63 blob + 368b70ebf50fb55fb08fc10088ac8cf32007e1f7 --- man/man3/venti.3 +++ man/man3/venti.3 @@ -15,61 +15,61 @@ This manual page describes general utility functions. .PP Other manual pages describe the library functions in detail. .PP -.IR Venti-cache (3) +.IM Venti-cache (3) describes a simple in-memory block cache to help clients. .PP -.IR Venti-conn (3) +.IM Venti-conn (3) describes routines for manipulating network connections between Venti clients and servers. -.IR Venti-client (3) +.IM Venti-client (3) and -.IR venti-server (3) +.IM venti-server (3) describe routines for writing clients and servers on top of these. .PP -.IR Venti-fcall (3) +.IM Venti-fcall (3) describes the C representation of Venti protocol messages and data structures. It also describes routines that convert between the C representation and the network and disk representations. .PP -.IR Venti-file (3) +.IM Venti-file (3) describes routines for writing clients that manipulate Venti file trees (see -.IR venti (7)). +.IM venti (7) ). .PP -.IR Venti-log (3) +.IM Venti-log (3) describes routines to access in-memory log buffers as well as the logging that is done automatically by the library. .PP -.IR Venti-mem (3) +.IM Venti-mem (3) describes wrappers around the canonical -.IR malloc (3) +.IM malloc (3) routines that abort on error. .PP -.IR Venti-packet (3) +.IM Venti-packet (3) describes routines for manipulating zero-copy chains of data buffers. .PP -.IR Venti-zero (3) +.IM Venti-zero (3) describes routines to zero truncate and zero extend blocks (see -.IR venti (7)). +.IM venti (7) ). .SH SOURCE .B \*9/src/libventi .SH SEE ALSO -.IR venti (1), -.IR venti-cache (3), -.IR venti-client (3), -.IR venti-fcall (3), -.IR venti-file (3) -.IR venti-log (3), -.IR venti-mem (3), -.IR venti-packet (3), -.IR venti-server (3), -.IR venti-zero (3), -.IR venti (7), -.IR venti (8) +.IM venti (1) , +.IM venti-cache (3) , +.IM venti-client (3) , +.IM venti-fcall (3) , +.IM venti-file (3) +.IM venti-log (3) , +.IM venti-mem (3) , +.IM venti-packet (3) , +.IM venti-server (3) , +.IM venti-zero (3) , +.IM venti (7) , +.IM venti (8) blob - 28d5d731ea066b165e5ce8cde1a913cc1533eed0 blob + c51df3c3681e8487e34a6e4c3d62a476b9dbfd3b --- man/man3/wait.3 +++ man/man3/wait.3 @@ -29,9 +29,9 @@ int awaitfor(int pid, char *s, int n) .SH DESCRIPTION .I Wait causes a process to wait for any child process (see -.IR fork (2) +.IM fork (2) and -.IR rfork (3)) +.IM rfork (3) ) to exit. It returns a .B Waitmsg @@ -62,7 +62,7 @@ the time spent in system calls, and the child's elapse all in units of milliseconds. .B Msg contains the message that the child specified in -.IR exits (3). +.IM exits (3) . For a normal exit, .B msg[0] is zero, @@ -78,7 +78,7 @@ returns immediately, with return value nil. The .B Waitmsg structure is allocated by -.IR malloc (3) +.IM malloc (3) and should be freed after use. For programs that only need the pid of the exiting program, .I waitpid @@ -114,7 +114,7 @@ The filled-in buffer may be parsed (after appending a NUL) using .IR tokenize (see -.IR getfields (3)); +.IM getfields (3) ); the resulting fields are, in order, pid, the three times, and the exit string, which will be .B '' @@ -139,8 +139,8 @@ returns .PP .B \*9/src/lib9/await.c .SH "SEE ALSO" -.IR rfork (3), -.IR exits (3), +.IM rfork (3) , +.IM exits (3) , .SH DIAGNOSTICS These routines set .IR errstr . @@ -156,4 +156,4 @@ are preprocessor macros defined as and .IR p9waitfor ; see -.IR intro (3). +.IM intro (3) . blob - 582504437615820d790fcc8ab9697339e8039b50 blob + 2663171f530fcf615c0ebf60b6346cc272a9a8f9 --- man/man3/window.3 +++ man/man3/window.3 @@ -121,7 +121,7 @@ to color the window initially, and a refresh method The refresh methods are .BR Refbackup , which provides backing store and is the method used by -.IR rio (1) +.IM rio (1) for its clients; .BR Refnone , which provides no refresh and is designed for temporary uses @@ -142,7 +142,7 @@ pointer that may be treated like any other image. In particular, it is freed by calling .B freeimage (see -.IR allocimage (3)). +.IM allocimage (3) ). The following functions, however, apply only to windows, not regular images. .PP .B Bottomwindow @@ -199,13 +199,13 @@ and screen position .RI ( scr ). Their usage is shown in the Examples section. .PP -.IR Rio (1) +.IM Rio (1) creates its client windows with backing store, .BR Refbackup . The graphics initialization routine, .B initdraw (see -.IR graphics (3)), +.IM graphics (3) ), builds a .B Screen upon this, and then allocates upon that another window indented @@ -234,10 +234,10 @@ actual screen position of the window unless it is reco .SH SOURCE .B \*9/src/libdraw .SH SEE ALSO -.IR graphics (3), -.IR draw (3), -.IR cachechars (3), -.IR draw (3) +.IM graphics (3) , +.IM draw (3) , +.IM cachechars (3) , +.IM draw (3) .SH BUGS The refresh method .B Refmesg blob - 1e4c81d2c77296b1b648d3bf706de711ec04e789 blob + 598a03fbd484abc9d2b6e1d7f9db149612f42ffb --- man/man4/0intro.4 +++ man/man4/0intro.4 @@ -15,7 +15,7 @@ In Plan 9, the kernel mount device \fImnt\fR(3) acts as a client to the 9P servers mounted in the current name space, translating system calls such as -.IR open (2) +.IM open (2) into 9P transactions such as .IR open (9p). The kernel also multiplexes the potentially many processes onto a single 9P conversation @@ -30,17 +30,17 @@ On Unix, 9P clients do not access servers via the trad file system call interface. Only the Unix name space can be accessed that way. Instead, 9P clients use the -.IR 9pclient (3) +.IM 9pclient (3) library to connect and interact directly with particular 9P servers. The -.IR 9p (1) +.IM 9p (1) command-line client is useful for interactive use and in shell scripts. .PP To preserve the façade of a single 9P conversation with each server, 9P servers invoke -.IR 9pserve (4), +.IM 9pserve (4) , typically via -.IR post9pservice (3). +.IM post9pservice (3) . .I 9pserve announces a 9P service at a particular network address and multiplexes the clients that connect to @@ -58,7 +58,7 @@ Setting the .B $NAMESPACE environment variable overrides this default. The -.IR namespace (1) +.IM namespace (1) command prints the current name space directory. .PP Occasionally it is useful to be able to connect the input or output @@ -73,7 +73,7 @@ implementation of (see also .I fsopenfd in -.IR 9pclient (3)) +.IM 9pclient (3) ) returns the read or write end of a pipe; a helper process transfers data between the other end of the pipe and the 9P server. blob - e5b177cfbc0581be21a1684ae8b3f9a9b6e2d454 blob + 5bcafe52a6a14b7ce6a1667df005917bfdbb6ae3 --- man/man4/9import.4 +++ man/man4/9import.4 @@ -19,7 +19,7 @@ tool allows an arbitrary on a remote .I system, with the capability of running the Plan 9 -.IR exportfs (4) +.IM exportfs (4) service, to be imported into the local name space. Usually @@ -31,7 +31,7 @@ A process is started on the remote machine, with authority of the user of .IR 9import , to perform work for the local machine using the -.IR exportfs (4) +.IM exportfs (4) service. The default port used is TCP 17007. If @@ -55,11 +55,11 @@ Use .I keypattern to select a key to authenticate to the remote side (see -.IR auth (2)). +.IM auth (2) ). .TP .B -p Push the -.IR aan (8) +.IM aan (8) filter onto the connection to protect against temporary network outages. .TP @@ -69,11 +69,11 @@ Post the connection's mountable file descriptor as .SH SOURCE .B \*9/src/cmd/9import.c .SH SEE ALSO -.IR srv (4), -.IR aan (8), -.IR listen1 (8), +.IM srv (4) , +.IM aan (8) , +.IM listen1 (8) , .B cs in -.IR ndb (7) +.IM ndb (7) .SH BUGS Encryption is not implemented. blob - cd34d931cedd3964c03bc5d148181a52cf1e6415 blob + 7eaa975f0de1ecc40ba2f4a42173447ff725cf6d --- man/man4/9pserve.4 +++ man/man4/9pserve.4 @@ -50,7 +50,7 @@ and clunks any outstanding fids belonging to the clien .PP .I 9pserve is typically not invoked directly; use -.IR post9pservice (3) +.IM post9pservice (3) instead. .PP The options are: @@ -73,7 +73,7 @@ rewrite all attach messages to use and .IR afid ; used to implement -.IR srv (4)'s +.IM srv (4) 's .B -a option .TP @@ -90,8 +90,8 @@ instead assume 9P2000 and a maximum message size of .IR msize .PD .SH "SEE ALSO -.IR intro (4), +.IM intro (4) , .IR intro (9p), -.IR 9pfuse (4) +.IM 9pfuse (4) .SH SOURCE .B \*9/src/cmd/9pserve.c blob - 5305253e94225d5ffcbd925a0bd0ac2321eb5dee blob + 1ed287fb3bb5198eadc8f36b9d3de606395ece0f --- man/man4/acme.4 +++ man/man4/acme.4 @@ -15,7 +15,7 @@ acme \- control files for text windows \&... ] .SH DESCRIPTION The text window system -.IR acme (1) +.IM acme (1) serves a variety of files for reading, writing, and controlling windows. Some of them are virtual versions of system files for dealing @@ -28,12 +28,13 @@ When a command is run under a directory holding these files is posted as the 9P service .B acme (using -.IR 9pserve (4)). +.IM 9pserve (4) ). .PP Some of these files supply virtual versions of services available from the underlying environment, in particular the character terminal files in Plan 9's -\fIcons\fR(3). -(Unlike in Plan 9's \fIrio\fR(1), +.IR cons (3). +(Unlike in Plan 9's +.IR rio (1), each command under .I acme sees the same set of files; there is not a distinct @@ -46,7 +47,7 @@ Other files are unique to is a subdirectory used by .B win (see -.IR acme (1)) +.IM acme (1) ) as a mount point for the .I acme files associated with the window in which @@ -435,5 +436,5 @@ except that reads stop at the end address. .SH SOURCE .B \*9/src/cmd/acme .SH SEE ALSO -.IR rio (1), -.IR acme (1) +.IM rio (1) , +.IM acme (1) blob - 3a2d3d7cc6bd2ad3c504c07bc67f81ca31f17b86 blob + 453965df9c24da588f0265ec1fe59b7f28b8afac --- man/man4/factotum.4 +++ man/man4/factotum.4 @@ -10,7 +10,7 @@ factotum \- authentication agent ] [ .B -s .I srvname -] +] .\" [ .\" .B -m .\" .I mtpt @@ -79,7 +79,7 @@ same user id as it. For select protocols such as it can also act as a client for other processes provided its user id may speak for the other process' user id (see Plan 9's -\fIauthsrv\fR(6)). +.IR authsrv (6)). .I Factotum can act in the role of server for any process. .PP @@ -127,7 +127,7 @@ RSA encryption and signatures, used by SSH and TLS. passwords in the clear. .TP .B vnc -.IR vnc (1)'s +.IM vnc (1) 's challenge/response. .TP .B wep @@ -186,7 +186,7 @@ cpu server. On starting, it will attempt to get a key from NVRAM using .B readnvram (see -.IR authsrv (3)), +.IM authsrv (3) ), prompting for anything it needs. It will never subsequently prompt for a key that it doesn't have. @@ -227,7 +227,7 @@ the kernel at boot time. .PP A .I "key tuple -is a space delimited list of +is a space delimited list of .IB attribute = value pairs. An attribute whose name begins with an exclamation point .RB ( ! ) @@ -245,7 +245,7 @@ specific to each supported protocol. .PP All keys can have additional attibutes that act either as comments or as selectors to distinguish them in the -.IR auth (3) +.IM auth (3) library calls. .PP The factotum owner can use any key stored by factotum. @@ -305,9 +305,9 @@ such as and .B auth_challenge (see -.IR auth (3)) +.IM auth (3) ) to specify which key and protocol to use for an authentication. -Like a key tuple, a key template is also a list of +Like a key tuple, a key template is also a list of .IB attribute = value pairs. It must specify at least the protocol and enough @@ -367,7 +367,7 @@ turned on by the option. .PP By default when factotum starts it looks for a -.IR secstore (1) +.IM secstore (1) account on $auth for the user and, if one exists, prompts for a secstore password in order to fetch the file @@ -385,11 +385,11 @@ sets a public/private keypair for ssh authentication, generated by .B ssh_genkey (see -.IR ssh (1)). +.IM ssh (1) ). .PD .SS "Confirming key use .PP -The +The .B confirm file provides a connection from .I factotum @@ -397,7 +397,7 @@ to a confirmation server, normally the program .IR auth/fgui . Whenever a key with the .B confirm -attribute is used, +attribute is used, .I factotum requires confirmation of its use. If no process has .B confirm @@ -429,7 +429,7 @@ the same user id as .IR factotum . .SS "Prompting for keys .PP -The +The .B needkey file provides a connection from .I factotum @@ -481,11 +481,11 @@ RPC's) until done if successful, reading back an .I AuthInfo structure (see -.IR authsrv (3)). +.IM authsrv (3) ). .PP The RPC protocol is normally embodied by one of the routines in -.IR auth (3). +.IM auth (3) . We describe it here should anyone want to extend the library. .PP @@ -545,7 +545,7 @@ necessary authentication has succeeded, an .B AuthInfo structure (see -.IR auth (3)) +.IM auth (3) ) can be retrieved with an .B authinfo RPC @@ -621,7 +621,7 @@ is expected to be a long hexadecimal string. These are useful for manually debugging of binary protocols. .TP .B authinfo -retrieve the AuthInfo structure. +retrieve the AuthInfo structure. The possible replies are: .RS .TP @@ -661,7 +661,7 @@ with its own roles and required key attributes. and .I p9cr are used to authenticate to Plan 9 systems; -valid +valid .BR role s are .B client @@ -691,7 +691,7 @@ is a meta-protocol that negotiates a protocol .RB ( p9sk1 or .BR p9sk2 ) -and an authentication domain and then invokes the +and an authentication domain and then invokes the given protocol with a .B dom= attribute. @@ -703,7 +703,7 @@ and are intended to be proxied via .I auth_proxy (see -.IR auth (3)). +.IM auth (3) ). .\" The protocols follow .\" .IR p9any (7) .\" and @@ -736,7 +736,7 @@ before being sent over the network. .PP .I Vnc is the challenge-response protocol used by -.IR vnc (1); +.IM vnc (1) ; valid roles are .B client and @@ -746,7 +746,7 @@ The client protocol requires a key with attribute .BR !password . Conventionally, client keys also have -.B user +.B user and .B server attributes. @@ -763,7 +763,7 @@ except that the challenge and response are not textual and .I cram are challenge-response protocols typically -used to authenticate +used to authenticate to mail servers. The client protocols require .B proto=apop @@ -774,7 +774,7 @@ keys with and .B !password attributes. -Conventionally, client keys also have +Conventionally, client keys also have .B server attributes. The server protocol requires a @@ -828,7 +828,7 @@ structure (defined in .PP .I Pass is a client-only protocol that hands out passwords -from +from .B proto=pass keys with .B user @@ -840,7 +840,7 @@ a string: a space-separated quoted user name and passw that can be parsed with .I tokenize (see -.IR getfields (3)). +.IM getfields (3) ). Conventionally, client keys have distinguishing attributes like .B service @@ -860,7 +860,7 @@ keys with .BR !key2 , or .B !key3 -attributes. +attributes. The protocol with .I factotum is: @@ -873,7 +873,7 @@ opens the device's control file, sets the wireless sec and turns on encryption. If the key has an .B essid -attribute, +attribute, .I factotum uses it to set the wireless station ID. .PP @@ -891,7 +891,7 @@ uses keys with .B ek and -.B n +.B n attributes, large integers specifying the public half of the key. If a key is to be used for decryption or signing, @@ -905,13 +905,13 @@ and .BR !dk specifying the private half of the key; see -.IR rsa (3). +.IM rsa (3) . Conventionally, .I rsa keys also have .B service attributes specifying the context in which the key is used: -.B ssh +.B ssh (SSH version 1), .B ssh-rsa (SSH version 2), @@ -946,7 +946,7 @@ and The hash function must be known to .I factotum because the signature encodes the type of hash used. -The +The .B encrypt and .B verify @@ -972,11 +972,11 @@ attributes. If the key is to be used for signing, it must also have a .B !secret attribute; see -.IR dsa (3). +.IM dsa (3) . Conventionally, .I dsa keys -also have +also have .B service attributes specifying the context in which the key is used: .B ssh-dss @@ -992,7 +992,7 @@ Unlike .IR rsa , the .I dsa -protocol ignores the +protocol ignores the .B hash attribute; it always uses SHA1. .PP @@ -1019,4 +1019,4 @@ The response is a hexadecimal string of length 32. .SH SOURCE .B \*9/src/cmd/auth/factotum .SH SEE ALSO -.IR ssh-agent (1) +.IM ssh-agent (1) blob - 2ba7f2c18ee52fc67730b3f30468dc19cbd5d455 blob + a270b2f10e767b3d888cde1b5b40e55c5d77e75e --- man/man4/fontsrv.4 +++ man/man4/fontsrv.4 @@ -20,7 +20,7 @@ fontsrv \- file system access to host fonts presents the host window system's fonts in the standard Plan 9 format (see -.IR font (7)). +.IM font (7) ). It serves a virtual directory tree mounted at .I mtpt (if the @@ -72,14 +72,14 @@ representing 32-character Unicode ranges. .PP .I Openfont (see -.IR graphics (3)) +.IM graphics (3) ) recognizes font paths beginning with .B /mnt/font and implements them by invoking .IR fontsrv ; it need not be running already. See -.IR font (7) +.IM font (7) for a full discussion of font name syntaxes. .SH EXAMPLES List the fonts on the system: @@ -96,7 +96,7 @@ or: .EE .LP Run -.IR acme (1) +.IM acme (1) using the operating system's Monaco as the fixed-width font: .IP .EX @@ -104,7 +104,7 @@ using the operating system's Monaco as the fixed-width .EE .LP Run -.IR sam (1) +.IM sam (1) using the same font: .IP .EX @@ -113,7 +113,7 @@ using the same font: .SH SOURCE .B \*9/src/cmd/fontsrv .SH SEE ALSO -.IR font (7) +.IM font (7) .SH BUGS .PP Due to OS X restrictions, blob - 7c06f2f7a09ecccaffac24f327ed29abd3bf0d5b blob + 6072a39a1c4fb0c650c3dce47adcb04ed2bd439d --- man/man4/fossil.4 +++ man/man4/fossil.4 @@ -148,10 +148,10 @@ will be named The attach name used in .I mount (see -.IR bind (1), -.IR bind (2) +.IM bind (1) , +.IM bind (2) and -.IR attach (5)) +.IM attach (5) ) selects a file system to be served and optionally a subtree, in the format @@ -163,7 +163,7 @@ An empty attach name selects normally requires all users except .L none to provide authentication tickets on each -.IR attach (5). +.IM attach (5) . To keep just anyone from connecting, .L none is only allowed to attach after another user @@ -179,7 +179,7 @@ flag to or .B srv (see -.IR fossilcons (8)). +.IM fossilcons (8) ). .PP The groups called .B noworld @@ -207,7 +207,7 @@ readable by the world but writable only to the develop starts a new instance of the fossil file server. It is configured mainly through console commands, documented in -.IR fossilcons (8). +.IM fossilcons (8) . .PP The options are: .TF "-c\fI cmd @@ -239,7 +239,7 @@ and which starts a file server console on .BI /srv/ cons \fR. See -.IR fossilcons (8) +.IM fossilcons (8) for more information. .TP .BI -f " file @@ -269,7 +269,7 @@ for inconsistencies. is deprecated in favor of the console .B check command (see -.IR fossilcons (8)). +.IM fossilcons (8) ). .I Flchk prints .I fossil @@ -375,7 +375,7 @@ system stored on Venti at The score should have been generated by .I fossil rather than by -.IR vac (1), +.IM vac (1) , so that the appropriate snapshot metadata is present. .PD .PP @@ -450,7 +450,7 @@ See the discussion of the and .B uname commands in -.IR fossilcons (8) +.IM fossilcons (8) for more about the user table. .ne 3 .PP @@ -488,13 +488,13 @@ command to prepare the script. .SH SOURCE .B \*9/src/cmd/fossil .SH SEE ALSO -.IR yesterday (1), -.IR fs (3), -.IR fs (4), -.IR srv (4), -.IR fossilcons (8), -.IR loadfossil (8), -.IR venti (8) +.IM yesterday (1) , +.IM fs (3) , +.IM fs (4) , +.IM srv (4) , +.IM fossilcons (8) , +.IM loadfossil (8) , +.IM venti (8) .SH BUGS It is possible that the disk format (but not the Venti format) will change in the future, to make the disk a full cache blob - 9dd81d72426c0cab179cc5545b50779e5af073b6 blob + 7d67a449394d277058826d99aa75a0d09c439987 --- man/man4/import.4 +++ man/man4/import.4 @@ -48,7 +48,7 @@ the path have different meanings on the two systems.) connects to .I system using -.IR ssh (1). +.IM ssh (1) . It invokes .I import on the remote system to carry out the remote @@ -109,5 +109,5 @@ sam & .SH SOURCE .B \*9/src/cmd/import.c .SH SEE ALSO -.IR 9pserve (4), -.IR intro (4) +.IM 9pserve (4) , +.IM intro (4) blob - 88801eb4d27054f4f9c17963aaac21f425f553da blob + a86f032a0de0c0196dfe744bfce5f7f8f9cbbba1 --- man/man4/plumber.4 +++ man/man4/plumber.4 @@ -14,17 +14,17 @@ plumber \- file system for interprocess messaging The .I plumber is a user-level file server that receives, examines, rewrites, and dispatches -.IR plumb (7) +.IM plumb (7) messages between programs. Its behavior is programmed by a .I plumbing file (default .BR $HOME/lib/plumbing ) in the format of -.IR plumb (7). +.IM plumb (7) . .PP Its services are posted via -.IR 9pserve (4) +.IM 9pserve (4) as .BR plumb , and consist of two @@ -39,14 +39,14 @@ for dispatching messages to applications. Programs use .B fswrite (see -.IR 9pclient (3)) +.IM 9pclient (3) ) to deliver messages to the .B send file, and .I fsread to receive them from the corresponding port. For example, -.IR sam (1)'s +.IM sam (1) 's .B plumb menu item or the .B B @@ -115,13 +115,13 @@ statements .TP .B plumb mount name for -.IR plumber (4). +.IM plumber (4) . .SH SOURCE .B \*9/src/cmd/plumb .SH "SEE ALSO" -.IR plumb (1), -.IR plumb (3), -.IR plumb (7) +.IM plumb (1) , +.IM plumb (3) , +.IM plumb (7) .\" .SH BUGS .\" .IR Plumber 's .\" file name space is fixed, so it is difficult to plumb blob - 25ae4bf67b861dd5fdb6e6a9289f3d349651aa1c blob + 20e72b3859d0dc5ff76b555e2ec732052604b27c --- man/man4/ramfs.4 +++ man/man4/ramfs.4 @@ -21,7 +21,7 @@ By default posts its service as .B ramfs using -.IR 9pserve (4). +.IM 9pserve (4) . .PP The .B -S @@ -46,5 +46,5 @@ It can also be used to provide high-performance tempor .SH SOURCE .B \*9/src/cmd/ramfs.c .SH "SEE ALSO" -.IR 9p (3), -.IR 9pserve (4) +.IM 9p (3) , +.IM 9pserve (4) blob - 4fb8c7f0f97962e26b6bc63f858477f710406ba9 blob + fdea4e470a885dd9ffe7d97d4ff9de046aa0230b --- man/man4/smugfs.4 +++ man/man4/smugfs.4 @@ -24,7 +24,7 @@ is a user-level file system that provides access to im stored on the SmugMug photo sharing service. It logs in after obtaining a password from -.IR factotum (4) +.IM factotum (4) using .B server=smugmug.com and @@ -32,7 +32,7 @@ and (if any) as key criteria (see -.IR auth (3)). +.IM auth (3) ). Then .I smugfs serves a virtual directory tree mounted at @@ -265,7 +265,7 @@ SmugMug, If multiple categories or albums have the same name, only one will be accessible via the file system interface. Renaming the accessible one via Unix's -.IR mv (1) +.IM mv (1) will resolve the problem. .PP Boolean values appear as blob - 856f88ff3d23e7e0e0c06d2506ef338ecfcdbedc blob + 469b2b4ca53457109be82193b7667fe55ccdf677 --- man/man4/srv.4 +++ man/man4/srv.4 @@ -22,7 +22,7 @@ srv, 9fs \- start network file service dials the given address and initializes the connection to serve the 9P protocol. It then posts the resulting connection in the current name space (see -.IR intro (4)) +.IM intro (4) ) as .I srvname (default @@ -70,7 +70,7 @@ available as service .IR sources . .I 9fs is an -.IR rc (1) +.IM rc (1) script; examine it to see what local conventions apply. .SH EXAMPLES List the root directory on @@ -98,6 +98,6 @@ sudo mount -t 9p -o trans=unix,uname=$USER,dfltuid=`id .br .B \*9/bin/9fs .SH "SEE ALSO -.IR dial (3), -.IR intro (4), -.IR netfiles (1) +.IM dial (3) , +.IM intro (4) , +.IM netfiles (1) blob - 3297e2a42c7f358c4265601778eb799a1b1a0b8d blob + b8843173abae4e733ebc107104aa7ba69e393fe9 --- man/man4/tapefs.4 +++ man/man4/tapefs.4 @@ -91,7 +91,7 @@ Tenth Edition research Unix systems (4KB block size). .PP .I Zipfs interprets zip archives (see -.IR gzip (1)). +.IM gzip (1) ). .SH SOURCE .PP These commands are constructed in a highly stereotyped @@ -103,7 +103,7 @@ in .BR \*9/src/cmd/tapefs , which in turn derive substantially from -.IR ramfs (4). +.IM ramfs (4) . .SH "SEE ALSO -.IR intro (7), -.IR ramfs (4). +.IM intro (7) , +.IM ramfs (4) . blob - 143e782bfb235f548059a1a48e3362723f9c6bf0 blob + 0c92ff60c14ead8d8358cff730d3e33455f13100 --- man/man4/vacfs.4 +++ man/man4/vacfs.4 @@ -26,7 +26,7 @@ vacfs \- a Venti-based file system .SH DESCRIPTION .I Vacfs interprets the file system created by -.IR vac (1) +.IM vac (1) so that it can be mounted into a Plan 9 file hierarchy. The data for the file system is stored on a Venti server with a root fingerprint specified in @@ -37,7 +37,7 @@ clients are not authenticated, and groups are assumed contain a single member with the same name. These restrictions should eventually be removed. .PP -Options to +Options to .I vacfs are: .TP @@ -49,7 +49,7 @@ The network address of the Venti server. The default is taken from the environment variable .BR venti . If this variable does not exist, then the default is the -metaname +metaname .BR $venti . .\" which can be configured via .\" .IR ndb (6). @@ -81,5 +81,6 @@ The amount of memory, in bytes, allocated to the block .SH SOURCE .B \*9/src/cmd/vac .SH "SEE ALSO" -.IR vac (1), -Plan 9's \fIventi\fR(8) +.IM vac (1) , +Plan 9's +.IR venti (8) blob - c8b536a0c7f5c349f2564a372e9d978d10734346 blob + 7e9a39b771492822bb17c4cf73dfa3cd40720f2b --- man/man7/color.7 +++ man/man7/color.7 @@ -121,11 +121,11 @@ which is scaled so 0 represents fully transparent and The alpha is .I premultiplied into the other channels, as described in the paper by Porter and Duff cited in -.IR draw (3). +.IM draw (3) . The function .B setalpha (see -.IR allocimage (3)) +.IM allocimage (3) ) aids the initialization of color values with non-trivial alpha. .PP The packing of pixels into bytes and words is odd. @@ -138,13 +138,13 @@ the byte ordering is blue, green, red. .PP To maintain a constant external representation, the -.IR draw (3) +.IM draw (3) interface as well as the various graphics libraries represent colors by 32-bit numbers, as described in -.IR color (3). +.IM color (3) . .SH "SEE ALSO" -.IR color (3), -.IR graphics (3), -.IR draw (3) +.IM color (3) , +.IM graphics (3) , +.IM draw (3) blob - 08b04a4638be8309f81dc122d0c59c66fcc40b83 blob + a69aac98938c5029d3c44c934e81c5cc81150506 --- man/man7/face.7 +++ man/man7/face.7 @@ -25,13 +25,13 @@ per color)). The large files serve no special purpose; they are stored as images (see -.IR image (7)). +.IM image (7) ). The small files are the `icons' displayed by .B faces and .B seemail (see Plan 9's -\fIfaces\fR(1)); +.IR faces (1)); for depths less than 4, their format is special. .PP One- and two-bit deep icons are stored as text, one line of the file to one scan line @@ -110,6 +110,6 @@ which then appears as a domain name in the .B .dict files. .SH "SEE ALSO" -.IR mail (1), -.IR tweak (1), -.IR image (7) +.IM mail (1) , +.IM tweak (1) , +.IM image (7) blob - 45331d4d260eb5bc9bf4a6a37742c2202c4ba88d blob + a11ca53c8092800fe7528d11bc2a672ce12f2080 --- man/man7/font.7 +++ man/man7/font.7 @@ -5,7 +5,7 @@ font, subfont \- external format for fonts and subfont .B #include .SH DESCRIPTION Fonts and subfonts are described in -.IR cachechars (3). +.IM cachechars (3) . .PP External bitmap fonts are described by a plain text file that can be read using .IR openfont . @@ -21,7 +21,7 @@ with an optional starting position within the subfont, and the file name names an external file suitable for .I readsubfont (see -.IR graphics (3)). +.IM graphics (3) ). The minimum number of a covered range is mapped to the specified starting position (default zero) of the corresponding subfont. @@ -36,11 +36,11 @@ that can be read and written using and .I writesubfont (see -.IR subfont (3)). +.IM subfont (3) ). The format for subfont files is: an image containing character glyphs, followed by a subfont header, followed by character information. The image has the format for external image files described in -.IR image (7). +.IM image (7) . The subfont header has 3 decimal strings: .BR n , @@ -72,7 +72,7 @@ are irrelevant. .PP Note that the convention of using the character with value zero (NUL) to represent characters of zero width (see -.IR draw (3)) +.IM draw (3) ) means that fonts should have, as their zeroth character, one with non-zero width. .SS "Font Names @@ -121,7 +121,7 @@ The command .B . lists the available fonts. See -.IR fontsrv (4) +.IM fontsrv (4) for more. .PP If the font name has the form @@ -136,7 +136,7 @@ The Plan 9 bitmap fonts were designed for screens with When used on screens with pixel density above 200 DPI, the bitmap fonts are automatically pixel doubled. Similarly, fonts loaded from -.IR fontsrv (4) +.IM fontsrv (4) are automatically doubled in size by varying the effective .I size path element. @@ -184,7 +184,7 @@ a system-installed vector font on high-density display .B \*9/font/* font directories .SH "SEE ALSO" -.IR graphics (3), -.IR draw (3), -.IR cachechars (3), -.IR subfont (3) +.IM graphics (3) , +.IM draw (3) , +.IM cachechars (3) , +.IM subfont (3) blob - e908c3ff5056c2d7bb86e0d1366935f53fac54c7 blob + 56874b1bb6b32d64721d1075b7dce4a38bd5a93a --- man/man7/htmlroff.7 +++ man/man7/htmlroff.7 @@ -2,7 +2,7 @@ .SH NAME htmlroff \- HTML formatting and typesetting .SH DESCRIPTION -.IR Htmlroff (1) +.IM Htmlroff (1) accepts .I troff input with a few extensions and changes. @@ -200,7 +200,7 @@ inside .B tags. This heuristic handles simple equations formatted by -.IR eqn (1). +.IM eqn (1) . .SS Conditional input .PP To make it easier to write input files that can be formatted by both @@ -315,7 +315,7 @@ For example, redefines the .B PS macro that marks the beginning of a -.IR pic (1) +.IM pic (1) picture: .IP .EX blob - 6e613f9c676eec4fb5fe01df6ad1f5f820532b28 blob + b412742fcb8b078bd6910078763815b725639b7a --- man/man7/image.7 +++ man/man7/image.7 @@ -5,9 +5,9 @@ image \- external format for images .B #include .SH DESCRIPTION Images are described in -.IR graphics (3), +.IM graphics (3) , and the definition of pixel values is in -.IR color (7). +.IM color (7) . Fonts and images are stored in external files in machine-independent formats. .PP @@ -21,7 +21,7 @@ and and .B writememimage (see -.IR memdraw (3)). +.IM memdraw (3) ). An uncompressed image file starts with 5 strings: .BR chan , @@ -34,10 +34,10 @@ Each is right-justified and blank padded in 11 charact The .B chan value is a textual string describing the pixel format -(see +(see .B strtochan in -.IR graphics (3) +.IM graphics (3) and the discussion of channel descriptors below), and the rectangle coordinates are decimal strings. The rest of the file contains the @@ -49,7 +49,7 @@ consists of the byte containing pixel .B r.min.x and all the bytes up to and including the byte containing pixel .BR r.max.x -1. -For images with depth +For images with depth .I d less than eight, a pixel with x-coordinate = .I x @@ -73,11 +73,11 @@ The and .B unloadimage functions described in -.IR allocimage (3) +.IM allocimage (3) also deal with rows in this format, stored in user memory. .PP The channel format string is a sequence of two-character channel descriptions, -each comprising a letter +each comprising a letter .RB ( r for red, .B g @@ -95,10 +95,10 @@ and for ``don't care'') followed by a number of bits per pixel. The sum of the channel bits per pixel is the -depth of the image, which must be either +depth of the image, which must be either a divisor or a multiple of eight. It is an error to have more than -one of any channel but +one of any channel but .BR x . An image must have either a greyscale channel; a color mapped channel; or red, green, and blue channels. @@ -110,13 +110,13 @@ In particular .B 'r8g8b8' pixels have byte ordering blue, green, and red within the file. See -.IR color (7) +.IM color (7) for more details of the pixel format. .PP A venerable yet deprecated format replaces the channel string with a decimal .IR ldepth , -which is the base two logarithm of the number +which is the base two logarithm of the number of bits per pixel in the image. In this case, .IR ldepth s @@ -177,9 +177,9 @@ Some small images, in particular 48\(mu48 face files as used by .I seemail (see Plan 9's -\fIfaces\fR(1) +.IR faces (1) and -.IR face (7)) +.IM face (7) ) and 16\(mu16 cursors, can be stored textually, suitable for inclusion in C source. Each line of text represents one scan line as a @@ -188,18 +188,18 @@ bytes, shorts, or words in C format. For cursors, each line defines a pair of bytes. (It takes two images to define a cursor; each must be stored separately to be processed by programs such as -.IR tweak (1).) +.IM tweak (1) .) Face files of one bit per pixel are stored as a sequence of shorts, those of larger pixel sizes as a sequence of longs. Software that reads these files must deduce the image size from the input; there is no header. These formats reflect history rather than design. .SH "SEE ALSO" -.IR jpg (1), -.IR tweak (1), -.IR graphics (3), -.IR draw (3), -.IR allocimage (3), -.IR color (7), -.IR face (7), -.IR font (7) +.IM jpg (1) , +.IM tweak (1) , +.IM graphics (3) , +.IM draw (3) , +.IM allocimage (3) , +.IM color (7) , +.IM face (7) , +.IM font (7) blob - 07bfb96028eabc70a9aaa07d243ceb7614cd341e blob + 56c0d3aeea8a5c67ac6a32503457de825a29d6b4 --- man/man7/keyboard.7 +++ man/man7/keyboard.7 @@ -49,15 +49,15 @@ in particular, control-J is a line feed and control-M .PP The down arrow, used by -.IR 9term (1), -.IR acme (1), +.IM 9term (1) , +.IM acme (1) , and -.IR sam (1), +.IM sam (1) , causes windows to scroll forward. The up arrow scrolls backward. .PP Characters in Plan 9 are runes (see -.IR utf (7)). +.IM utf (7) ). Any rune can be typed using a compose key followed by several other keys. The compose key is also generally near the lower right of the main key area: @@ -92,11 +92,11 @@ the compose key followed by a two- or three-character The full list is too long to repeat here, but is contained in the file .L \*9/lib/keyboard in a format suitable for -.IR grep (1) +.IM grep (1) or -.IR look (1). +.IM look (1) . To add a sequence, edit that file and then rebuild -.IR devdraw (1). +.IM devdraw (1) . .PP There are several rules guiding the design of the sequences, as illustrated by the following examples. @@ -235,10 +235,10 @@ to run them automatically at startup. sorted table of characters and keyboard sequences .PD .SH "SEE ALSO" -.IR intro (1), -.IR ascii (1), -.IR tcs (1), -.IR 9term (1), -.IR acme (1), -.IR sam (1), -.IR utf (7) +.IM intro (1) , +.IM ascii (1) , +.IM tcs (1) , +.IM 9term (1) , +.IM acme (1) , +.IM sam (1) , +.IM utf (7) blob - 0e2b52bab58bfac6bf5b7106e38ed867ed046ec9 blob + 98fae1c3edb23b4434bfd39f945e04373fce125c --- man/man7/man.7 +++ man/man7/man.7 @@ -82,9 +82,9 @@ font- or size-setting macros. The .B -man macros admit equations and tables in the style of -.IR eqn (1) +.IM eqn (1) and -.IR tbl (1), +.IM tbl (1) , but do not support arguments on .B .EQ and @@ -113,7 +113,7 @@ The root directory of the Plan 9 installation. .B \*9/tmac/tmac.antimes .SH SEE ALSO .IR troff (1), -.IR man (1) +.IM man (1) .SH REQUESTS .ta \w'.TH n c x 'u +\w'Cause 'u +\w'Argument\ 'u .di xx blob - 80e1eebff0d0434e975ddda5d752e3e63396a4ee blob + 72925e414db3b0c3953058a31a933dc7a77c49dc --- man/man7/map.7 +++ man/man7/map.7 @@ -80,7 +80,7 @@ in the map file. Both the map file and the index file are ordered by patch latitude and longitude. .SH "SEE ALSO" -.IR map (7) +.IM map (7) .br The data comes from the World Data Bank I and II and U.S. Government sources: the Census Bureau, Geological blob - dcf49868da60ed5dbdaa251129674a12fda391c5 blob + 95439641ffc1f27f6ba9528399b818a1b498f827 --- man/man7/mhtml.7 +++ man/man7/mhtml.7 @@ -19,14 +19,14 @@ mhtml \- macros for formatting HTML \&... .SH DESCRIPTION This package of -.IR htmlroff (1) +.IM htmlroff (1) macro definitions provides convenient macros for formatting HTML. It is usually used along with -.IR troff (1) +.IM troff (1) macro packages such as -.IR man (7) +.IM man (7) and -.IR ms (7). +.IM ms (7) . .I Mhtml replaces some macros defined in the other packages, so it should be listed after them on the @@ -64,7 +64,7 @@ before invoking Accumulate footnotes and print them at the end of the document under a \fBNotes\fP heading. These replace the macros in -.IR ms (7). +.IM ms (7) . To emit the notes accumulated so far, invoke .BR .NOTES . .TP @@ -75,7 +75,7 @@ and .B .PE with a PNG image corresponding to the output of running -.IR troff (1) +.IM troff (1) on the input. .TP .B .TS\fR, \fP.TE @@ -100,6 +100,6 @@ percent of the current output width. .SH FILES .B \*9/tmac/tmac.html .SH SEE ALSO -.IR htmlroff (1), -.IR htmlroff (7), -.IR ms (7) +.IM htmlroff (1) , +.IM htmlroff (7) , +.IM ms (7) blob - d6dbf964d89b4e217f04dd11eea0f8cf191f0ee1 blob + c6eaf555cad5d304706e48556c2c7efb7bfe1a68 --- man/man7/mpictures.7 +++ man/man7/mpictures.7 @@ -10,7 +10,7 @@ mpictures \- picture inclusion macros .SH DESCRIPTION .I Mpictures macros insert PostScript pictures into -.IR troff (1) +.IM troff (1) documents. The macros are: .TP @@ -129,7 +129,7 @@ comment is present, the picture is assumed to fill an 8.5\(mu11-inch page. Nothing prevents the picture from being placed off the page. .SH SEE ALSO -.IR troff (1) +.IM troff (1) .SH DIAGNOSTICS A picture file that can't be read by the PostScript postprocessor is replaced by white space. blob - 931dad1b5fc9bed96b8a2d34d6cb57da46ad3d6e blob + 7d50c89acd85f316a982da8d8d8483600e4301e9 --- man/man7/ms.7 +++ man/man7/ms.7 @@ -18,7 +18,7 @@ ms \- macros for formatting manuscripts This package of .I nroff and -.IR troff (1) +.IM troff (1) macro definitions provides a canned formatting facility for tech%nical papers in various formats. .PP @@ -38,11 +38,11 @@ impunity after the first .LR .na . .PP Output of the -.IR eqn (1), -.IR tbl (1), -.IR pic (1) +.IM eqn (1) , +.IM tbl (1) , +.IM pic (1) and -.IR grap (1) +.IM grap (1) preprocessors for equations, tables, pictures, and graphs is acceptable as input. .SH FILES @@ -57,8 +57,8 @@ Tenth Edition, Volume 2. .br .IR eqn (1), .IR troff (1), -.IR tbl (1), -.IR pic (1) +.IM tbl (1) , +.IM pic (1) .SH REQUESTS .ta \w'..ND \fIdate\fR 'u +\w'Initial 'u +\w'Cause 'u .br @@ -153,7 +153,7 @@ Implies produced by .I neqn or -.IR eqn (1). +.IM eqn (1) . .ti0 \fL\&.EQ\fP \fIx y\fR - yes Display equation. Equation number is @@ -234,7 +234,7 @@ is subsection level (default 1). \fL\&.P2\fP - yes End program display. .ti0 \fL\&.PE\fP - yes End picture; see -.IR pic (1). +.IM pic (1) . .ti0 \fL\&.PF\fP - yes End picture; restore vertical position. @@ -280,7 +280,7 @@ font automatically bold. Default is 5 10 15 ... .ti0 \fL\&.TE\fP - yes End table; see -.IR tbl (1). +.IM tbl (1) . .ti0 \fL\&.TH\fP - yes End heading section of table. .ti0 blob - 4387f99d2d799db29cce68070fa5d5d147e6c41a blob + 9ab448fe50235e3443f7a46cf7e8e89785011f12 --- man/man7/ndb.7 +++ man/man7/ndb.7 @@ -60,7 +60,7 @@ Within tuples, pairs on the same line bind tighter tha pairs on different lines. .PP Programs search the database directly using the routines in -.IR ndb (3). +.IM ndb (3) . .\" or indirectly using .\" .B ndb/cs .\" and @@ -293,8 +293,8 @@ tcp=9fs port=564 first database file searched .SH "SEE ALSO" .\" .IR dial (2), -.IR ndb (1), -.IR ndb (3) +.IM ndb (1) , +.IM ndb (3) .\" .IR dhcpd (8), .\" .IR ipconfig (8), .\" .IR con (1) blob - d4550f51e35b2af5d1eac7ac12c722bb2f7eb334 blob + 31cb41a007b5771869d70d301fa507e4835a53ec --- man/man7/plot.7 +++ man/man7/plot.7 @@ -340,4 +340,4 @@ Restore previous environment. .PD .SH "SEE ALSO" .IR plot (1), -.IR graph (1) +.IM graph (1) blob - fd30ee04d4ed9f107b881842885ef6a5bf55e45e blob + 446b4340adbce2a2efe793dd2a9dd80612b1f259 --- man/man7/plumb.7 +++ man/man7/plumb.7 @@ -6,7 +6,7 @@ plumb \- format of plumb messages and rules .SH DESCRIPTION .SS "Message format The messages formed by the -.IR plumb (3) +.IM plumb (3) library are formatted for transmission between processes into textual form, using newlines to separate the fields. @@ -61,7 +61,7 @@ A missing field is represented by an empty line. The .B plumber (see -.IR plumb (1)) +.IM plumb (1) ) receives messages on its .B send port (applications @@ -271,7 +271,7 @@ rule should be specified in a rule set. .RE .PP The arguments to all rules may contain quoted strings, exactly as in -.IR rc (1). +.IM rc (1) . They may also contain simple string variables, identified by a leading dollar sign .BR $ . Variables may be set, between rule sets, by assignment statements in the style of @@ -341,7 +341,7 @@ field of the message. .B $plan9 The root directory of the Plan 9 tree (see -.IR get9root (3)). +.IM get9root (3) ). .RE .SH EXAMPLE The following is a modest, representative file of plumbing rules. @@ -403,7 +403,7 @@ default rules file. .TP .B plumb service name for -.IR plumber (4). +.IM plumber (4) . .TP .B \*9/plumb directory for @@ -416,7 +416,7 @@ public macro definitions. .B \*9/plumb/basic basic rule set. .SH "SEE ALSO" -.IR plumb (1), -.IR plumb (3), -.IR plumber (4), -.IR regexp (7) +.IM plumb (1) , +.IM plumb (3) , +.IM plumber (4) , +.IM regexp (7) blob - 91e73adc5526005eb45ec89b427048a4d812bf70 blob + dbc5a9a16f25ba631927e84aca313e53af11a0e8 --- man/man7/regexp.7 +++ man/man7/regexp.7 @@ -4,9 +4,9 @@ regexp \- Plan 9 regular expression notation .SH DESCRIPTION This manual page describes the regular expression syntax used by the Plan 9 regular expression library -.IR regexp (3). +.IM regexp (3) . It is the form used by -.IR egrep (1) +.IM egrep (1) before .I egrep got complicated. @@ -130,4 +130,4 @@ A match to any part of a regular expression extends as far as possible without preventing a match to the remainder of the regular expression. .SH "SEE ALSO" -.IR regexp (3) +.IM regexp (3) blob - 743172de6fdd95e96c42ac813aa74319c68a680d blob + 4d90f43771334f4ab6231892211f0850fe509434 --- man/man7/thumbprint.7 +++ man/man7/thumbprint.7 @@ -9,7 +9,7 @@ for example by calling and .B okThumbprint (see -.IR pushtls (3)), +.IM pushtls (3) ), check the remote side's public key by comparing against thumbprints from a trusted list. The list is maintained by people who set local policies @@ -38,4 +38,4 @@ For example, a web server might have thumbprint x509 sha1=8fe472d31b360a8303cd29f92bd734813cbd923c cn=*.cs.bell-labs.com .EE .SH "SEE ALSO" -.IR pushtls (3) +.IM pushtls (3) blob - a240945769b43295327fd0c2c60b253b1b6df0c0 blob + 0a963c8cd7b5b95abd90e8711183ec943eb6eae4 --- man/man7/utf.7 +++ man/man7/utf.7 @@ -57,7 +57,7 @@ in order to work properly with non-\c .SM ASCII input. See -.IR rune (3). +.IM rune (3) . .PP Letting numbers be binary, a rune x is converted to a multibyte @@ -85,7 +85,7 @@ In the inverse mapping, any sequence except those described above is incorrect and is converted to rune hexadecimal 0080. .SH "SEE ALSO" -.IR ascii (1), -.IR tcs (1), -.IR rune (3), +.IM ascii (1) , +.IM tcs (1) , +.IM rune (3) , .IR "The Unicode Standard" . blob - 382bf67bdd2bf310180de6461f624986f5235ca9 blob + 960920fcd4771ff6a8774c59eff898930c961128 --- man/man7/venti.7 +++ man/man7/venti.7 @@ -14,19 +14,19 @@ of clients. This manual page documents the basic concepts of block storage using Venti as well as the Venti network protocol. .PP -.IR Venti (1) +.IM Venti (1) documents some simple clients. -.IR Vac (1), -.IR vacfs (4), +.IM Vac (1) , +.IM vacfs (4) , and -.IR vbackup (8) +.IM vbackup (8) are more complex clients. .PP -.IR Venti (3) +.IM Venti (3) describes a C library interface for accessing Venti servers and manipulating Venti data structures. .PP -.IR Venti (8) +.IM Venti (8) describes the programs used to run a Venti server. .PP .SS "Scores @@ -40,11 +40,11 @@ Scores may have an optional prefix, typically used to describe the format of the data. For example, -.IR vac (1) +.IM vac (1) uses a .B vac: prefix, while -.IR vbackup (8) +.IM vbackup (8) uses prefixes corresponding to the file system types: .BR ext2: , @@ -93,7 +93,7 @@ Keeping this parallel representation is a minor annoya but makes it possible for general programs like .I venti/copy (see -.IR venti (1)) +.IM venti (1) ) to traverse the block tree without knowing the specific details of any particular program's data. .SS "Block Types @@ -202,7 +202,7 @@ Text strings are represented similarly, using a two-byte count with the text itself stored as a UTF-encoded sequence of Unicode characters (see -.IR utf (7)). +.IM utf (7) ). Text strings are not .SM NUL\c -terminated: @@ -395,7 +395,7 @@ Use and .I vtfromdisktype (see -.IR venti (3)) +.IM venti (3) ) to convert a block type enumeration value .RB ( VtDataType , etc.) @@ -457,9 +457,9 @@ in the packet may be either 2 or 4 bytes; the total packet length distinguishes the two cases. .SH SEE ALSO -.IR venti (1), -.IR venti (3), -.IR venti (8) +.IM venti (1) , +.IM venti (3) , +.IM venti (8) .br Sean Quinlan and Sean Dorward, ``Venti: a new approach to archival storage'', blob - b59b6b6a760371e83cbce994ab5e825db40870d7 blob + 49a42e094bb75f9a7064377fba6ca329c1081ae0 --- man/man8/fossilcons.8 +++ man/man8/fossilcons.8 @@ -340,7 +340,7 @@ con /srv/fscons .SH DESCRIPTION These are configuration and maintenance commands executed at the console of a -.IR fossil (4) +.IM fossil (4) file server. The commands are split into three groups above: file server configuration, @@ -372,11 +372,11 @@ a file in any file system served by .I 9p executes a 9P transaction; the arguments are in the same format used by -.IR 9pcon (8). +.IM 9pcon (8) . .PP .I Bind behaves similarly to -.IR bind (1). +.IM bind (1) . It is useful when fossil is started without devices it needs configured into its namespace. @@ -389,7 +389,7 @@ standard error. .PP .I Echo behaves identically to -.IR echo (1), +.IM echo (1) , writing to the console. .PP .I Listen @@ -492,7 +492,7 @@ the string used to represent this user in the 9P proto .TP .I leader the group's leader (see Plan 9's -.IR stat (5) +.IM stat (5) for a description of the special privileges held by a group leader) .TP .I members @@ -821,7 +821,7 @@ removing a non-empty directory. A subsequent .I flchk (see -.IR fossil (4)) +.IM fossil (4) ) will identify the abandoned storage so it can be reclaimed with .I bfree commands. @@ -1013,7 +1013,7 @@ takes a temporary snapshot of the current file system, recording it in .BI /snapshot/ yyyy / mmdd / hhmm \fR, as described in -.IR fossil (4). +.IM fossil (4) . The .B -a flag causes @@ -1021,7 +1021,7 @@ flag causes to take an archival snapshot, recording it in .BI /archive/ yyyy / mmdd \fR, also described in -.IR fossil (4). +.IM fossil (4) . By default the snapshot is taken of .BR /active , the root of the active file system. @@ -1132,7 +1132,7 @@ writes dirty blocks in memory to the disk. .PP .I Vac prints the Venti score for a -.IR vac (1) +.IM vac (1) archive containing the tree rooted at .IR dir , blob - 86c295b9ccac854f72791af5a9b1d29f188d5a4a blob + 02c774f578681af1087a3f5f822bbd665c7bc259 --- man/man8/getflags.8 +++ man/man8/getflags.8 @@ -16,7 +16,7 @@ not take arguments, or a letter followed by the space- names of its arguments. .I Getflags prints an -.IR rc (1) +.IM rc (1) script on standard output which initializes the environment variable .BI $flag x @@ -51,15 +51,15 @@ and .BR $0 , the program name (see -.IR rc (1)). +.IM rc (1) ). If run under -.IR sh (1), +.IM sh (1) , which does not set .BR $0 , the program name must be given explicitly on the command line. .SH EXAMPLE Parse the arguments for Plan 9's -.IR leak (1): +.IM leak (1) : .IP .EX flagfmt='b,s,f binary,r res,x width' @@ -74,4 +74,4 @@ if(! ifs=() eval `{getflags $*} || ~ $#* 0){ .br .B \*9/src/cmd/usage.c .SH SEE ALSO -.IR arg (3) +.IM arg (3) blob - 534766bfd77176d5cfbfce5293001864ade77cba blob + 2de33f1fca0545a23ebad43d6e3665966c742bfb --- man/man8/listen1.8 +++ man/man8/listen1.8 @@ -17,9 +17,7 @@ listen1 \- listen for calls on a network device .I Listen1 is a lightweight listener intended for personal use, modeled from Inferno's -.\" write out this way so automatic programs -.\" don't try to make it into a real man page reference. -\fIlisten\fR(1). +.IR listen (1). It announces on .IR address , @@ -28,7 +26,7 @@ running .I args... for each incoming connection; the network directory is passed in the environment -as +as .BR $net . The .B -v @@ -36,4 +34,4 @@ flag causes verbose logging on standard output. .SH SOURCE .B \*9/src/cmd/listen1.c .SH "SEE ALSO" -.IR dial (3) +.IM dial (3) blob - 2eaba6c1cb79c8f5419ce2d75890e852b5b190d5 blob + fb4fa2e606ff566e6df7954be89f8312d62539f2 --- man/man8/mkfs.8 +++ man/man8/mkfs.8 @@ -34,7 +34,7 @@ copies files from the file tree to a .B kfs file system (see -.IR kfs (4)). +.IM kfs (4) ). The kfs service is mounted on .I root (default @@ -47,7 +47,7 @@ The .I proto files are read (see -.IR proto (2) +.IM proto (2) for their format) and any files specified in them that are out of date are copied to .BR /n/kfs . @@ -183,5 +183,5 @@ disk/mkext -u -d /n/newfs < arch .br .B \*9/src/cmd/disk/mkext.c .SH "SEE ALSO" -.IR prep (8), -.IR tar (1) +.IM prep (8) , +.IM tar (1) blob - 26ab9178b53a5d11f2afe04852115dbe6b915edb blob + e212435edc2b846f2085dfa6aa231ffff22e8a40 --- man/man8/vbackup.8 +++ man/man8/vbackup.8 @@ -70,7 +70,7 @@ back up Unix file systems to Venti .SH DESCRIPTION These programs back up and restore standard Unix file system images stored in -.IR venti (8). +.IM venti (8) . Images stored in .I venti are named by @@ -102,7 +102,7 @@ The argument .I disk should be a disk or disk partition device that would be appropriate to pass to -.IR mount (8). +.IM mount (8) . .PP The optional argument .I score @@ -135,7 +135,7 @@ The default is the name returned by .I sysname (see -.IR getuser (3)). +.IM getuser (3) ). The default .I mtpt is the place where @@ -149,7 +149,7 @@ command. The default is the name returned by .I sysname (see -.IR getuser (3)). +.IM getuser (3) ). .TP .B -n No-op mode: do not write any blocks to the server @@ -207,7 +207,7 @@ to zero unused blocks instead. .PP .I Vftp presents an -.IR ftp (1)-like +.IM ftp (1) -like interface to a physical or backed-up disk image. It is used mainly for debugging. Type @@ -228,7 +228,7 @@ must be run by the user Because .I address is passed to the host OS kernel rather than interpreted by -.IR dial (3), +.IM dial (3) , it must be only an IP address, not a full dial address. .PP .I Vnfs blob - 10614a50181b0f4de38fff6d9ae31ab81c3147cb blob + 88bad8f33d93937199be77703423cb1732eae515 --- man/man8/venti-backup.8 +++ man/man8/venti-backup.8 @@ -104,8 +104,8 @@ for a version that does this. .SH SOURCE .B \*9/src/cmd/venti/srv .SH SEE ALSO -.IR venti (7), -.IR venti (8) +.IM venti (7) , +.IM venti (8) .SH BUGS .I Wrarena can't read a pipe or network connection containing an arena; blob - 7c44754f6d890ebceb32bce08e4bb49645b09b8d blob + 19679ca0ef5dae9c65c94fc129489567830bdc0e --- man/man8/venti-fmt.8 +++ man/man8/venti-fmt.8 @@ -99,9 +99,9 @@ syncindex \- prepare and maintain a venti server These commands aid in the setup, maintenance, and debugging of venti servers. See -.IR venti (7) +.IM venti (7) for an overview of the venti system and -.IR venti (8) +.IM venti (8) for an overview of the data structures used by the venti server. .PP Note that the units for the various sizes in the following @@ -195,7 +195,7 @@ formats the given .I file as a Bloom filter (see -.IR venti (7)). +.IM venti (7) ). The options are: .TF "\fL-s\fI size" .PD @@ -264,7 +264,7 @@ overflow. The total size of the index should be about the total size of the arenas, but the exact percentage depends both on the index block size and the compressed size of blocks stored. See the discussion in -.IR venti (8) +.IM venti (8) for more. .PP .I Fmtindex @@ -401,8 +401,8 @@ Increase the verbosity of output. .SH SOURCE .B \*9/src/cmd/venti/srv .SH SEE ALSO -.IR venti (7), -.IR venti (8) +.IM venti (7) , +.IM venti (8) .SH BUGS .I Buildindex should allow an individual index section to be rebuilt. blob - 4fd40df66f37946003e3d22d696d891b33d555e6 blob + d6c26903f9a7890c42a8a41d650ab4d78e933f7c --- man/man8/venti.8 +++ man/man8/venti.8 @@ -40,7 +40,7 @@ venti \- archival storage server .I Venti is a SHA1-addressed archival storage server. See -.IR venti (7) +.IM venti (7) for a full introduction to the system. This page documents the structure and operation of the server. .PP @@ -138,7 +138,7 @@ less than 10 are not very useful; greater than 24 are probably a waste of memory. .I Fmtbloom (see -.IR venti-fmt (8)) +.IM venti-fmt (8) ) can be given either .I nhash or @@ -220,7 +220,7 @@ The venti server announces two network services, one .BR venti , 17034) serving the venti protocol as described in -.IR venti (7), +.IM venti (7) , and one serving HTTP (conventionally TCP port .BR http , @@ -333,7 +333,7 @@ with or .I fmtisect (see -.IR venti-fmt (8)). +.IM venti-fmt (8) ). In particular, only the configuration needs to be changed if a component is moved to a different file. .PP @@ -506,11 +506,11 @@ Start the server and check the storage statistics: .SH SOURCE .B \*9/src/cmd/venti/srv .SH "SEE ALSO" -.IR venti (1), -.IR venti (3), -.IR venti (7), -.IR venti-backup (8) -.IR venti-fmt (8) +.IM venti (1) , +.IM venti (3) , +.IM venti (7) , +.IM venti-backup (8) +.IM venti-fmt (8) .br Sean Quinlan and Sean Dorward, ``Venti: a new approach to archival storage'', @@ -523,7 +523,7 @@ Venti should not require the user to decide how to partition its memory usage. .PP Users of shells other than -.IR rc (1) +.IM rc (1) will not be able to use the program names shown. One solution is to define .B "V=$PLAN9/bin/venti" blob - 397486f8301af713654d294e531df2063e571810 blob + f432cf519c51022de00d0bf91bb3d29738a61107 --- man/man9/0intro.9p +++ man/man9/0intro.9p @@ -21,7 +21,7 @@ such a machine is called, somewhat confusingly, a Another possibility for a server is to synthesize files on demand, perhaps based on information on data structures maintained in memory; the -.IR plumber (4) +.IM plumber (4) server is an example of such a server. .PP A @@ -63,7 +63,7 @@ bytes of data. Text strings are represented this way, with the text itself stored as a UTF-8 encoded sequence of Unicode characters (see -.IR utf (7)). +.IM utf (7) ). Text strings in 9P messages are not .SM NUL\c -terminated: @@ -114,7 +114,7 @@ Plan 9 names may contain any printable character (that outside hexadecimal 00-1F and 80-9F) except slash.) Messages are transported in byte form to allow for machine independence; -.IR fcall (3) +.IM fcall (3) describes routines that convert to and from this form into a machine-dependent C structure. .SH MESSAGES @@ -348,7 +348,7 @@ a ``current file'' on the server. Fids are somewhat like file descriptors in a user process, but they are not restricted to files open for I/O: directories being examined, files being accessed by -.IR stat (3) +.IM stat (3) calls, and so on \(em all files being manipulated by the operating system \(em are identified by fids. Fids are chosen by the client. @@ -461,7 +461,7 @@ to have their input or output attached to fids on 9P s See .IR openfd (9p) and -.IR 9pclient (3) +.IM 9pclient (3) for details. .PP The @@ -475,7 +475,7 @@ access permissions (read, write and execute for owner, access and modification times, and owner and group identifications (see -.IR stat (3)). +.IM stat (3) ). The owner and group identifications are textual names. The .B wstat @@ -523,12 +523,12 @@ into 9P messages. .SS Unix On Unix, 9P services are posted as Unix domain sockets in a well-known directory (see -.IR getns (3) +.IM getns (3) and -.IR 9pserve (4)). +.IM 9pserve (4) ). Clients connect to these servers using a 9P client library (see -.IR 9pclient (3)). +.IM 9pclient (3) ). .SH DIRECTORIES Directories are created by .B create blob - ddcf7476d6e7c63f36055e9c3bee2ca36948802d blob + 3a5104d5da241b44e7825d982efc23507fa7d94c --- man/man9/attach.9p +++ man/man9/attach.9p @@ -122,7 +122,7 @@ and and .I fsauth (see -.IR 9pclient (3)) +.IM 9pclient (3) ) generate .B attach and @@ -163,6 +163,6 @@ transactions. .\" .B mount .\" system call on an uninitialized connection. .SH SEE ALSO -.IR 9pclient (3), +.IM 9pclient (3) , .IR version (9P), Plan 9's \fIauthsrv\fR(6) blob - ef3ecdc4705f7eb6dbe0f12c8523c7e1cc27f678 blob + 3277c4b056119c0bafbe6f058e75a92c6b33aaac --- man/man9/clunk.9p +++ man/man9/clunk.9p @@ -41,7 +41,7 @@ generated by and .I fsunmount (see -.IR 9pclient (3)) +.IM 9pclient (3) ) and indirectly by other actions such as failed .I fsopen calls. blob - 9d3ea26751a482ecb9b848933d047c493041184e blob + d0987cac4bf83425cefa61863ee55996ab3d069d --- man/man9/flush.9p +++ man/man9/flush.9p @@ -99,11 +99,11 @@ flushing a and flushing an invalid tag. .SH ENTRY POINTS The -.IR 9pclient (3) +.IM 9pclient (3) library does not generate .B flush transactions.. -.IR 9pserve (4) +.IM 9pserve (4) generates .B flush transactions to cancel transactions pending when a client hangs up. blob - b8ed973ae901bbc747a94d321d1a00d1f47af6d8 blob + 1f74eb07d040b9a6bcf6fa095b4c9e53b7e5b5c2 --- man/man9/open.9p +++ man/man9/open.9p @@ -160,7 +160,7 @@ in this case, the .I fscreate call (see -.IR 9pclient (3)) +.IM 9pclient (3) ) uses .B open with truncation. @@ -209,7 +209,7 @@ again. and .I fscreate (see -.IR 9pclient (3)) +.IM 9pclient (3) ) both generate .B open messages; only blob - 89aa254f93d3149f238529c44389ef215139e9a1 blob + 56fb392a28477a139351bdcaab8b7aebf329acdd --- man/man9/openfd.9p +++ man/man9/openfd.9p @@ -43,18 +43,18 @@ it cannot be .PP .I Openfd is implemented by -.IR 9pserve (4). +.IM 9pserve (4) . 9P servers that post their services using -.IR 9pserve (4) +.IM 9pserve (4) (or indirectly via -.IR post9pservice (3)) +.IM post9pservice (3) ) will never see a .B Topenfd message. .SH ENTRY POINTS .I Fsopenfd (see -.IR 9pclient (3)) +.IM 9pclient (3) ) generates an .B openfd message. blob - a68f153e960e5af388e7ddb9815e6d556c5eb2b2 blob + 515f85c31da96e9903c2f727471e03956dff2deb --- man/man9/read.9p +++ man/man9/read.9p @@ -114,7 +114,7 @@ to be transferred atomically. and .I fswrite (see -.IR 9pclient (3)) +.IM 9pclient (3) ) generate the corresponding messages. Because they take an offset parameter, the .I fspread blob - a9a844a1ae80df01a3943e60390a4a3d04ec6445 blob + 79a646a10ab513926be7233efc925420cbf91889 --- man/man9/remove.9p +++ man/man9/remove.9p @@ -45,7 +45,7 @@ so other fids typically remain usable. .SH ENTRY POINTS .I Fsremove (see -.IR 9pclient (3)) +.IM 9pclient (3) ) generates .B remove messages. blob - ab68133d96e6096c2acacab7676883259242fc14 blob + b92f2d69ffe354810885b87b0a4562c65f2a5b70 --- man/man9/stat.9p +++ man/man9/stat.9p @@ -88,7 +88,7 @@ The and .I convD2M routines (see -.IR fcall (3)) +.IM fcall (3) ) convert between directory entries and a C structure called a .BR Dir . .PP @@ -263,7 +263,7 @@ messages are generated by and .IR fsdirstat (see -.IR 9pclient (3)). +.IM 9pclient (3) ). .PP .B Wstat messages are generated by blob - c4961217a535c95c80210ac9fd463bcc49cb56d8 blob + 99f30239b6893e09ed883d9da743c5ac3c50f012 --- man/man9/version.9p +++ man/man9/version.9p @@ -91,7 +91,7 @@ requests is called a .SH ENTRY POINTS .I Fsversion (see -.IR 9pclient (3)) +.IM 9pclient (3) ) generates .B version messages; blob - 49777f214a0e365530abad2293a73bc2f1d7dd33 blob + b48b947bb449e8d29d24547ee72203a35d2825a3 --- man/man9/walk.9p +++ man/man9/walk.9p @@ -149,13 +149,13 @@ may be packed in a single message. This constant is called .B MAXWELEM in -.IR fcall (3). +.IM fcall (3) . Despite this restriction, the system imposes no limit on the number of elements in a file name, only the number that may be transmitted in a single message. .SH ENTRY POINTS .I Fswalk (see -.IR 9pclient (3)) +.IM 9pclient (3) ) generates walk messages. One or more walk messages may be generated by any call that evaluates file names: blob - 6d2e9c590fd0bcdc43e350967891d1d9d9b11c07 blob + c759a59eefb61fdca9827df66c3b0c4df131e776 --- tmac/tmac.an +++ tmac/tmac.an @@ -205,10 +205,15 @@ .. .de IR .nh -.}S 2 1 \& "\Xhtml manref start \\$1 \\$2\\$1" "\\$2\Xhtml manref end \\$1 \\$2" "\\$3" "\\$4" "\\$5" "\\$6" +.}S 2 1 \& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" .HY .}f .. +.de IM +.}S 2 1 \& "\Xhtml manref start \\$1 \\$2\\$1" "\\$2\Xhtml manref end \\$1 \\$2\\$3" +.HY +.}f +.. .de IB .nh .if t .}S 2 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"