commit - 9843fc0d82c68c78059ccb167e8402def5a4ee1f
commit + d32deab17bfffa5bffc5fab3e6577558e40888c5
blob - 5c45aefe960cb389aeae6d538ab548b386265b7c
blob + 780be91dab79d73fcb18a48ad1775aedc142b3af
--- man/man1/0intro.1
+++ man/man1/0intro.1
environment variable
to contain the name of the root of the tree.
See
-.IM install (1)
+.MR install (1)
for details about installation.
.PP
Many of the familiar Unix commands,
for example
-.IM cat (1) ,
-.IM ls (1) ,
+.MR cat (1) ,
+.MR ls (1) ,
and
-.IM wc (1) ,
+.MR wc (1) ,
are present, but in their Plan 9 forms:
.I cat
takes no options,
.I wc
counts UTF characters.
In some cases, the differences are quite noticeable:
-.IM grep (1)
+.MR grep (1)
and
-.IM sed (1)
+.MR sed (1)
expect Plan 9 regular expressions
(see
-.IM regexp (7) ),
+.MR 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
.B bin
directories in your search path.
Instead, put it at the end of your path and use the
-.IM 9 (1)
+.MR 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.
-.IM Mk (1)
+.MR Mk (1)
now allows mkfiles to choose their own shell,
and
-.IM rc (1)
+.MR rc (1)
has a
.I ulimit
builtin and manages
.PP
Many of the graphical programs from Plan 9 are present,
including
-.IM sam (1)
+.MR sam (1)
and
-.IM acme (1) .
+.MR acme (1) .
An X11 window manager
-.IM rio (1)
+.MR rio (1)
mimics Plan 9's window system, with command windows
implemented by the external program
-.IM 9term (1) .
+.MR 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
\fIxmin\fL,\fIymin\fL,\fIxmax\fL,\fIymax\fR.
.PP
The
-.IM plumber (4)
+.MR plumber (4)
helps to connect the various Plan 9 programs together,
and fittings like
-.IM web (1)
+.MR web (1)
connect it to external programs such as web browsers;
one can click on a URL in
.I acme
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
-.IM 9pclient (3)
+.MR 9pclient (3)
library.
-.IM Intro (4)
+.MR 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
-.IM 9p (1)
+.MR 9p (1)
client can be used in shell scripts or by hand to carry out
simple interactions with servers.
-.IM Netfiles (1)
+.MR Netfiles (1)
is an experimental client for acme.
.SS External databases
Some programs rely on large databases that would be
and
.I 9l
(see
-.IM 9c (1) )
+.MR 9c (1) )
provide a simple interface to the underlying system compiler and linker,
similar to the
.I 2c
options are needed.
.PP
The only way to write multithreaded programs is to use the
-.IM thread (3)
+.MR thread (3)
library.
-.IM Rfork (3)
+.MR 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
-.IM intro (3)
+.MR intro (3)
for details.
.PP
The debuggers
-.IM acid (1)
+.MR acid (1)
and
-.IM db (1)
+.MR db (1)
and the debugging library
-.IM mach (3)
+.MR 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,
.SS Porting programs
The vast majority of the familiar Plan 9 programs
have been ported, including the Unicode-aware
-.IM troff (1) .
+.MR troff (1) .
.PP
Of the more recent additions to Plan 9,
-.IM factotum (4) ,
-.IM secstore (1) ,
+.MR factotum (4) ,
+.MR secstore (1) ,
and
-.IM secstored (1) ,
-.IM vac (1) ,
-.IM vacfs (4) ,
+.MR secstored (1) ,
+.MR vac (1) ,
+.MR vacfs (4) ,
and
-.IM venti (8)
+.MR venti (8)
are all ported.
.PP
A backup system providing a dump file system built atop Venti
is in progress; see
-.IM vbackup (8) .
+.MR 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
.PP
There are other smaller system dependencies,
such as the terminal handling code in
-.IM 9term (1)
+.MR 9term (1)
and the implementation of
-.IM getcallerpc (3) ,
+.MR getcallerpc (3) ,
but these are usually simple and are not on the critical
path for getting the system up and running.
.SH SEE ALSO
instead of Plan 9's simpler
.BR $PLAN9/man/1/cat ,
so that the Unix
-.IM man (1)
+.MR man (1)
utility can handle it.
Some systems, for example Debian Linux,
deduce the man page locations from the search path, so that
These pages describe parts of the system
that are new or different from Plan 9 from Bell Labs:
.IP
-.IM 9 (1) ,
-.IM 9c (1) ,
-.IM 9p (1) ,
-.IM 9term (1) ,
+.MR 9 (1) ,
+.MR 9c (1) ,
+.MR 9p (1) ,
+.MR 9term (1) ,
.I acidtypes
in
-.IM acid (1) ,
-.IM dial (1) ,
-.IM git (1) ,
-.IM label (1) ,
+.MR acid (1) ,
+.MR dial (1) ,
+.MR git (1) ,
+.MR label (1) ,
the
.B MKSHELL
variable in
-.IM mk (1) ,
-.IM namespace (1) ,
-.IM netfiles (1) ,
-.IM page (1) ,
-.IM psfonts (1) ,
-.IM rio (1) ,
-.IM web (1) ,
-.IM wintext (1)
+.MR mk (1) ,
+.MR namespace (1) ,
+.MR netfiles (1) ,
+.MR page (1) ,
+.MR psfonts (1) ,
+.MR rio (1) ,
+.MR web (1) ,
+.MR wintext (1)
.IP
-.IM intro (3) ,
-.IM 9pclient (3) ,
+.MR intro (3) ,
+.MR 9pclient (3) ,
the
.B unix
network in
-.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)
+.MR dial (3) ,
+.MR exits (3) ,
+.MR get9root (3) ,
+.MR getns (3) ,
+.MR notify (3) ,
+.MR post9pservice (3) ,
+.MR rfork (3) ,
+.MR searchpath (3) ,
+.MR sendfd (3) ,
+.MR udpread (3) ,
+.MR venti (3) ,
+.MR wait (3) ,
+.MR wctl (3)
.IP
-.IM intro (4) ,
-.IM 9pserve (4) ,
-.IM import (4) ,
+.MR intro (4) ,
+.MR 9pserve (4) ,
+.MR import (4) ,
.IP
-.IM vbackup (8)
+.MR vbackup (8)
.IP
.IR openfd (9p)
.SH DIAGNOSTICS
corresponds to exiting with status 0,
and exiting with any non-empty string corresponds to exiting with status 1.
See
-.IM exits (3) .
+.MR exits (3) .
blob - b39ca885e267f509e5c426258ea85d91df58ca49
blob + 34c150d216871292914b32eff98e6cd5e96f7ee6
--- man/man1/9.1
+++ man/man1/9.1
.B .
.B 9
(from
-.IM sh (1) )
+.MR sh (1) )
.PP
.B 9.rc
.I cmd
.B .
.B 9.rc
(from
-.IM rc (1) )
+.MR rc (1) )
.PP
.B u
.I cmd
.B .
.B u
(from
-.IM sh (1) )
+.MR sh (1) )
.PP
.B u.rc
.I cmd
.B .
.B u.rc
(from
-.IM rc (1) )
+.MR rc (1) )
.SH DESCRIPTION
Because Plan 9 supplies commands with the same name as but different
behavior than many basic Unix system commands
is the same as
.I 9
but written for use by the shell
-.IM rc (1) .
+.MR rc (1) .
.PP
.I U
and
.EE
.PP
Start an
-.IM rc (1)
+.MR rc (1)
with the Plan 9 commands in the path before the system commands,
and then run the Unix
.IR ls :
.br
.B \*9/bin/u.rc
.SH SEE ALSO
-.IM intro (1)
+.MR intro (1)
.SH BUGS
Some shell configurations
(notably, oh-my-zsh)
blob - 14bb618d8342bdd62c880c861434bc5569c316e5
blob + dd15926d756e2d2041d5fd9f5a9a9df22517b67c
--- man/man1/9c.1
+++ man/man1/9c.1
.BR t ,
give a long listing of all information about the files,
somewhat like a listing by
-.IM ls (1) ,
+.MR ls (1) ,
showing
.br
.ns
blob - 3a77e244f3a13e8427d6d09de7dd2d51ba609faa
blob + 4580587db9de98ebc6766770af8beca765ae0145
--- man/man1/9p.1
+++ man/man1/9p.1
Print errors, but don't give up.
.B Rdwr
is useful for interacting with servers like
-.IM factotum (4) .
+.MR factotum (4) .
.TP
.B ls
Print a directory listing in the format of
-.IM ls (1) .
+.MR ls (1) .
The
.B -d
and
.I service
in the name space directory
(see
-.IM intro (4) )
+.MR intro (4) )
and then accesses
.IR subpath .
.SH EXAMPLE
To update
-.IM plumber (4) 's
+.MR plumber (4) 's
copy of your plumbing rules after editing
.BR $HOME/lib/plumbing :
.IP
.EE
.PP
To display the contents of the current
-.IM acme (4)
+.MR acme (4)
window:
.IP
.EX
.SH SOURCE
.B \*9/src/cmd/9p.c
.SH SEE ALSO
-.IM intro (4) ,
+.MR intro (4) ,
.IR intro (9p),
-.IM 9pclient (3)
+.MR 9pclient (3)
blob - bf0ee27f6e86b0fbaf8aa4aadef3719d1a4806dd
blob + 2e0426341cfc0747bac2b134c8238f29b87060f6
--- man/man1/9term.1
+++ man/man1/9term.1
.B $font
if set; otherwise it uses the graphics system default.
(See
-.IM font (7)
+.MR font (7)
for a full discussion of font syntaxes.)
.PP
.I 9term
if this text is not empty, it is placed in a
.I snarf buffer
common to all windows but distinct from that of
-.IM sam (1) .
+.MR sam (1) .
.PP
Programs access the text in the window at a single point
maintained automatically by
.PP
An ACK character (control-F) or Insert character triggers file name completion
for the preceding string (see
-.IM complete (3) ).
+.MR 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
as the ``eof'' character.
.I 9term
runs
-.IM stty (1)
+.MR stty (1)
to establish this when the terminal is created.
.PP
.I 9term
First, programs using the GNU readline library typically
disable terminal echo and perform echoing themselves.
The most common example is the shell
-.IM bash (1) .
+.MR 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
-.IM ssh (1)
+.MR ssh (1)
typically run with echo disabled, relying on the
remote system to echo characters as desired.
Plan 9's
menu item sends the contents of the selection (not the snarf buffer) to the
.I plumber
(see
-.IM plumb (1) ).
+.MR 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
.IR 9term
bug:
when running
-.IM bash (1)
+.MR bash (1)
in
.RB `` "set +o emacs" ''
mode, its handling of interrupts is broken.
.PP
Unix makes everything harder.
.SH SEE ALSO
-.IM wintext (1)
+.MR wintext (1)
blob - a593f1c0282334d2f22cb1c856711cdc31eb085b
blob + ec17c00fdba6d8f1fd4792d012687ca16e671ce7
--- man/man1/acid.1
+++ man/man1/acid.1
.BI -m " machine
Assume instructions are for the given CPU type
(see
-.IM mach (3) )
+.MR mach (3) )
instead of using the executable header to select
the CPU type.
.TP
.BI delete " list", " subscript
.PP
Format codes are the same as in
-.IM db (1) .
+.MR db (1) .
Formats may be attached to (unary) expressions with
.BR \e ,
e.g.
.BI Bsrc( address )
Get the source line for the program address
into a window of a running
-.IM sam (1)
+.MR sam (1)
and select it.
.TP
.BI line( address )
.TP
.BI rc( string )
Escape to the shell,
-.IM rc (1) ,
+.MR rc (1) ,
to execute the command string.
.TP
.BI include( string )
.BR *array .
.PP
Trace the system calls executed by
-.IM ls (1)
+.MR ls (1)
(neither does this one):
.IP
.EX
.SH SOURCE
.B \*9/src/cmd/acid
.SH "SEE ALSO"
-.IM mk (1) ,
-.IM db (1)
+.MR mk (1) ,
+.MR db (1)
.br
Phil Winterbottom,
``Acid Manual''.
blob - a631d3c376f5f42f90ec3128d2c625ddd0838f6f
blob + 852a8f7f1e803c2662691fffa27510cb0e448c02
--- man/man1/acme.1
+++ man/man1/acme.1
use a set of files served by
.IR acme ;
these are discussed in
-.IM acme (4) .
+.MR acme (4) .
.PP
Any named
.I files
option instructs
.I acme
to use FUSE (see
-.IM 9pfuse (4) )
+.MR 9pfuse (4) )
to mount itself at
.IR mtpt .
(Experimental.)
above a multi-line
.IR body .
The body typically contains an image of a file, as in
-.IM sam (1) ,
+.MR sam (1) ,
or the output of a
program, as in an
-.IM rio (1)
+.MR rio (1)
window.
The tag contains a number of
blank-separated words, followed by a vertical bar character, followed by anything.
.SS Scrolling
Each window has a scroll bar to the left of the body.
The scroll bar behaves much as in
-.IM sam (1)
+.MR sam (1)
or
-.IM rio (1)
+.MR 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.
.B -r
reverses the scrolling behavior of buttons 1 and 3, to behave
more like
-.IM xterm (1) .)
+.MR xterm (1) .)
.SS Layout
.I Acme
windows are arranged in columns. By default, it creates two columns when starting;
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
-.IM rio (1)
+.MR 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
causes typing to go to the most recently clicked-at or made window.)
The usual backspacing conventions apply.
As in
-.IM sam (1)
+.MR sam (1)
but not
.IR rio ,
the ESC key selects the text typed since the last mouse action,
These error windows are created when needed.
.SS "Mouse button 1
Mouse button 1 selects text just as in
-.IM sam (1)
+.MR sam (1)
or
.IR rio (1) ,
including the usual double-clicking conventions.
.TP
.B Edit
Treat the argument as a text editing command in the style of
-.IM sam (1) .
+.MR sam (1) .
The full
.B Sam
language is implemented except for the commands
prints the supplementary list.
This command is largely superseded by plumbing
(see
-.IM plumb (7) ).
+.MR plumb (7) ).
.TP
.B Indent
Set the autoindent mode according to the argument:
a shell command. For example, indicating
.B date
with button 2 runs
-.IM date (1) .
+.MR 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
executing
.B mk
will run
-.IM mk (1)
+.MR mk (1)
in
.BR /home/rob/sam ,
producing output in a window labeled
.B $winid
set to the window's id number
(see
-.IM acme (4) ).
+.MR acme (4) ).
.PP
The environment variable
.B $acmeshell
determines which shell is used to execute such commands; the
-.IM rc (1)
+.MR rc (1)
shell is used by default.
.SS "Mouse button 3
Pointing at text with button 3 instructs
.PP
If the text begins with a colon, it is taken to be an address, in
the style of
-.IM sam (1) ,
+.MR 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
clicking button 1 while 2 is held down.
.PP
When an external command (e.g.
-.IM echo (1) )
+.MR echo (1) )
is executed this way, the extra argument is passed as expected and an
environment variable
.B $acmeaddr
(default
.BR $SHELL )
in it, turning the window into something analogous to an
-.IM 9term (1)
+.MR 9term (1)
window.
Executing text in a
.I win
.BR Send .
.I Win
windows follow the same scrolling heuristic as in
-.IM 9term (1) :
+.MR 9term (1) :
the window scrolls on output only if the window is displaying the end of the buffer.
.PP
.I Awd
.br
.B \*9/bin/awd
.SH SEE ALSO
-.IM acme (4)
+.MR acme (4)
.br
Rob Pike,
.I
blob - 52e6d60b8f5b6fb018f4e8f9f4131b734d596fe0
blob + 24fde4f5002ebfa25b084c5a5bc11abbd7fdba09
--- man/man1/acmeevent.1
+++ man/man1/acmeevent.1
and
.I acme.rc
make it easy to write simple
-.IM acme (1)
+.MR acme (1)
client programs as shell scripts.
.PP
.I Acme
.B event
files
(see
-.IM acme (4) )
+.MR 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
-.IM acme (4)
+.MR 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
below).
.I Flag
remains from the
-.IM acme (4)
+.MR acme (4)
event format.
Because
.IR eq0 ,
.I chordarg
are explicit in each event
(unlike in
-.IM acme (4)
+.MR acme (4)
events),
.I flag
can usually be ignored.
.PP
.I Acme.rc
is a library of
-.IM rc (1)
+.MR rc (1)
shell functions useful for writing acme clients.
.PP
.I Newwindow
.BR clean ,
which marks the window as clean.
See
-.IM acme (4)
+.MR acme (4)
for a full list of commands.
.PP
.I Windump
sets the window's dump directory
and dump command
(see
-.IM acme (4) ).
+.MR acme (4) ).
If either argument is omitted or is
.BR - ,
that argument is not set.
.br
.B \*9/lib/acme.rc
.SH SEE ALSO
-.IM acme (1) ,
-.IM acme (4) ,
-.IM rc (1)
+.MR acme (1) ,
+.MR acme (4) ,
+.MR rc (1)
.SH BUGS
There is more that could be done to ease the writing
of complicated clients.
blob - 611c7c6dd840ac3fa3fd4c81bd2e3e3ddc506d6b
blob + 99265f467d2fc83a38eb904180c58146294a7e90
--- man/man1/ascii.1
+++ man/man1/ascii.1
is similar; it converts between
.SM UTF
and character values from the Unicode Standard (see
-.IM utf (7) ).
+.MR utf (7) ).
If given a range of hexadecimal numbers,
.I unicode
prints a table of the specified Unicode characters \(em their values and
contains a
table of characters and descriptions, sorted in hexadecimal order,
suitable for
-.IM look (1)
+.MR look (1)
on the lower case
.I hex
values of characters.
.br
.B \*9/src/cmd/unicode.c
.SH "SEE ALSO"
-.IM look (1) ,
-.IM tcs (1) ,
-.IM utf (7) ,
-.IM font (7)
+.MR look (1) ,
+.MR tcs (1) ,
+.MR utf (7) ,
+.MR font (7)
blob - a143f2cf5b75059db434de7501b731c4704e35f2
blob + b24cfa3fafdc0632d151793b62a7bf279762e9e3
--- man/man1/astro.1
+++ man/man1/astro.1
.SH SOURCE
.B \*9/src/cmd/astro
.SH SEE ALSO
-.IM scat (1)
+.MR scat (1)
.SH BUGS
The
.B k
blob - da6389bf8148896bcf25de1a9c0ae6344187d37f
blob + 395dfa96d096fda447e7fed6fdc76a2906c14f73
--- man/man1/awk.1
+++ man/man1/awk.1
of regular expressions and
relational expressions.
Regular expressions are as in
-.IM regexp (7) .
+.MR regexp (7) .
Isolated regular expressions
in a pattern apply to the entire line.
Regular expressions may also occur in
.SH SOURCE
.B \*9/src/cmd/awk
.SH SEE ALSO
-.IM sed (1) ,
-.IM regexp (7) ,
+.MR sed (1) ,
+.MR regexp (7) ,
.br
A. V. Aho, B. W. Kernighan, P. J. Weinberger,
.I
blob - ee314735ca0c32fce2d674d0b0aea693b8c7ce21
blob + 497481301b8872d1fce02dcf0e35329800070a31
--- man/man1/bc.1
+++ man/man1/bc.1
.B scale
influences the number of digits to be retained on arithmetic
operations in the manner of
-.IM dc (1) .
+.MR dc (1) .
Assignments to
.B ibase
or
.PP
.I Bc
is actually a preprocessor for
-.IM dc (1) ,
+.MR dc (1) ,
which it invokes automatically, unless the
.B -c
(compile only)
.B \*9/src/cmd/bc.y
.SH "SEE ALSO"
.IR dc (1),
-.IM hoc (1)
+.MR hoc (1)
.SH BUGS
No
.LR && ,
blob - b954fdb122a2619e0e367ab0d0453e3edae9051e
blob + b4880343380737d45dd9f68c62f49670bbe4c3f5
--- man/man1/bundle.1
+++ man/man1/bundle.1
.SH DESCRIPTION
.I Bundle
writes on its standard output a shell script for
-.IM rc (1)
+.MR 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
-.IM mail (1) .
+.MR mail (1) .
.PP
Although less refined than standard archives from
.I 9ar
(see
-.IM 9c (1) )
+.MR 9c (1) )
or
-.IM tar (1) ,
+.MR tar (1) ,
a
.IR bundle
file
(in
.IR 9c (1)),
.IR tar (1),
-.IM mail (1)
+.MR mail (1)
.SH BUGS
.I Bundle
will not create directories and is unsatisfactory for non-text files.
blob - 5c3b2760c707304c2a44f14b18bb03a0957ebc33
blob + 5a305699b7a775b0f4293772b4712eb846338fe4
--- man/man1/calendar.1
+++ man/man1/calendar.1
On Friday and Saturday, events through Monday are printed.
.PP
To have your calendar mailed to you every day, use
-.IM cron (8) .
+.MR cron (8) .
.SH FILES
.TF $HOME/lib/calendar
.TP
blob - d44817927d711e54d347ea9d7ca97fef822d1809
blob + 7ff12e69b062d0f9c4c921d511503db04e12ca87
--- man/man1/cat.1
+++ man/man1/cat.1
.IR file ,
default standard input.
It is useful in interactive
-.IM rc (1)
+.MR rc (1)
scripts.
.PP
The
It is useful to use as
.B $PAGER
with the Unix version of
-.IM man (1)
+.MR man (1)
when run inside a
.I win
(see
-.IM acme (1) )
+.MR acme (1) )
window.
.SH SOURCE
.B \*9/src/cmd/cat.c
.br
.B \*9/bin/nobs
.SH SEE ALSO
-.IM cp (1)
+.MR cp (1)
.SH DIAGNOSTICS
.I Read
exits with status
blob - 50e63f3c87aebb9a62c8406a08f341673a66ec92
blob + 1f59e67727a3d9e21c100ecf19a50fe0fb1854ee
--- man/man1/cleanname.1
+++ man/man1/cleanname.1
.SH SOURCE
.B \*9/src/cmd/cleanname.c
.SH SEE ALSO
-.IM cleanname (3) .
+.MR cleanname (3) .
blob - 426bb7bc91e61cc50861e7641769449b1035bde1
blob + 77d4d46bf3a1e07aa7e4180d6c4545ffeb369346
--- man/man1/col.1
+++ man/man1/col.1
as produced by
.I nroff
for .2C in
-.IM ms (7)
+.MR ms (7)
or
-.IM man (7)
+.MR man (7)
and for
-.IM tbl (1) .
+.MR tbl (1) .
.I Col
is a pure filter.
It normally emits only full line feeds;
.SH SOURCE
.B \*9/src/cmd/col.c
.SH SEE ALSO
-.IM pr (1)
+.MR pr (1)
.SH BUGS
.I Col
can't back up more than 128 lines or
blob - 27b439e915b6ed58e2a926dd46048567c2e0d5f5
blob + b85f3d8b0be999f764e26a97eb51b805c56cedc5
--- man/man1/colors.1
+++ man/man1/colors.1
.I Colors
presents a grid showing the colors in the RGBV color map
(see
-.IM color (7) ).
+.MR 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
-.IM allocimage (3) .
+.MR allocimage (3) .
If the
.B -x
option is specified, the components will also be listed in hexadecimal.
.SH SOURCE
.B \*9/src/cmd/draw/colors.c
.SH SEE ALSO
-.IM color (7)
+.MR color (7)
blob - afb2dc257014dab313bfc486e1d3ca84d344f1d4
blob + 86d4c34ac2daa790ba9912125d252288c3734b0e
--- man/man1/comm.1
+++ man/man1/comm.1
.SH SOURCE
.B \*9/src/cmd/comm.c
.SH "SEE ALSO"
-.IM sort (1) ,
+.MR sort (1) ,
.IR cmp (1),
.IR diff (1),
-.IM uniq (1)
+.MR uniq (1)
blob - e19c7520d1bb76f9b9143364ce402c771e5aee42
blob + caf6351baed3d98a5f15671accc1abec4e7a65f8
--- man/man1/core.1
+++ man/man1/core.1
command, if run, prints a stack trace of the
executing thread at the time of the core dump;
see
-.IM db (1) .
+.MR db (1) .
.PP
If no arguments are given,
.I core
.SH SOURCE
.B \*9/src/cmd/core.c
.SH "SEE ALSO
-.IM acid (1) ,
-.IM db (1) ,
-.IM core (5)
+.MR acid (1) ,
+.MR db (1) ,
+.MR core (5)
blob - a1cd59255fe446329dc81c9f03995a6239c3182b
blob + c47afac65b922450371539fc7ebb4fa3649530e8
--- man/man1/crop.1
+++ man/man1/crop.1
.SH DESCRIPTION
.I Crop
reads an
-.IM image (7)
+.MR image (7)
file (default standard input), crops it, and writes it as a compressed
-.IM image (7)
+.MR 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
The
.B -c
option takes a red-green-blue triplet as described in
-.IM color (3) .
+.MR color (3) .
(For example, white
is
.B 255
Pixels in the image are converted according to the channel descriptor
.IR chandesc ,
(see
-.IM image (7) ).
+.MR 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
.SH SOURCE
.B \*9/src/cmd/draw/crop.c
.SH SEE ALSO
-.IM image (7) ,
-.IM color (3)
+.MR image (7) ,
+.MR color (3)
.SH BUGS
.I Iconv
should be able to do Floyd-Steinberg error diffusion or dithering
blob - b5ad47818612880038419acf3d284ebb90292744
blob + 7d68b94fca6c033fe1a6ee9e90ac0978042365e2
--- man/man1/date.1
+++ man/man1/date.1
The conversion from Greenwich Mean Time to local time depends on the
.B $timezone
environment variable; see
-.IM ctime (3) .
+.MR ctime (3) .
.PP
If the optional argument
.I seconds
blob - c87ea4a30274099d83c74c7d96634b284861c75b
blob + 5c2cc9db7b35df6a23ea749cbcc8fea260e4e8dc
--- man/man1/db.1
+++ man/man1/db.1
A
.I pid
gives the id of an executing process to be accessed via
-.IM ptrace (2) .
+.MR ptrace (2) .
A
.I corefile
specifies the name of a core dump (see
-.IM core (5)
+.MR core (5)
on your system of choice) containing the
memory image of a terminated process.
This manual refers to the memory image specified by
.TP
.B !
The rest of the line is passed to
-.IM rc (1)
+.MR rc (1)
for execution.
.TP
.BI $ modifier
Beware that local variables may be stored in registers; see the
BUGS section.
.SH "SEE ALSO"
-.IM acid (1) ,
-.IM core (1)
+.MR acid (1) ,
+.MR core (1)
.SH SOURCE
.B \*9/src/cmd/db
.SH DIAGNOSTICS
blob - ad5cf310692a3f8a95431723fb2408726be0b913
blob + 70597dcca6c9929861dfbccb73642bc7ec19ccd9
--- man/man1/dc.1
+++ man/man1/dc.1
.SH SOURCE
.B \*9/src/cmd/dc.c
.SH "SEE ALSO"
-.IM bc (1) ,
-.IM hoc (1)
+.MR bc (1) ,
+.MR hoc (1)
.SH DIAGNOSTICS
.I x
.LR "is unimplemented" ,
blob - 948e80cb4855f1f08e571431746c05fac685ce6e
blob + 6e942fd8bb32497b048dbd260bbcaeabd9140bf3
--- man/man1/dd.1
+++ man/man1/dd.1
.SH SOURCE
.B \*9/src/cmd/dd.c
.SH "SEE ALSO"
-.IM cp (1)
+.MR cp (1)
.SH DIAGNOSTICS
.I Dd
reports the number of full + partial input and output
blob - 90fba52d527453cf3a38e2db3e722baf1dafa8e8
blob + 1489aaddba60850d31bbb15dcd6a4d291c5f8357
--- man/man1/deroff.1
+++ man/man1/deroff.1
and removes all
.I nroff
and
-.IM troff (1)
+.MR troff (1)
requests and non-text arguments, backslash constructions,
and constructs of preprocessors such as
-.IM eqn (1) ,
-.IM pic (1) ,
+.MR eqn (1) ,
+.MR pic (1) ,
and
-.IM tbl (1) .
+.MR tbl (1) .
Remaining text is written on the standard output.
.I Deroff
follows files included by
Remove titles, attachments, etc., as well as ordinary
.IR troff
constructs, from
-.IM ms (7)
+.MR ms (7)
or
.I mm
documents.
and
.I latex
(see
-.IM tex (1) )
+.MR tex (1) )
files what
.B deroff -wi
does for
.B \*9/src/cmd/delatex.lx
.SH "SEE ALSO"
.IR troff (1),
-.IM tex (1) ,
-.IM spell (1)
+.MR tex (1) ,
+.MR spell (1)
.SH BUGS
These filters are not complete interpreters of
.I troff
blob - eda04893bcfb07335c3ed462d34823da8bc09d8c
blob + da36b8e2aee9382fb37e57aaf15fd4aabd1927cd
--- man/man1/devdraw.1
+++ man/man1/devdraw.1
invoked via
.I initdraw
(see
-.IM graphics (3) )
+.MR graphics (3) )
.SH DESCRIPTION
.I Devdraw
serves a custom graphics protocol and is the only program
.SH SOURCE
.B \*9/src/cmd/devdraw
.SH "SEE ALSO
-.IM draw (3) ,
-.IM drawfcall (3) ,
-.IM graphics (3)
+.MR draw (3) ,
+.MR drawfcall (3) ,
+.MR graphics (3)
.SH BUGS
.I Devdraw
should probably present a standard 9P server
blob - a27c2026b3c50a54c80e7705b84d2ab24714a216
blob + 0245ba16e2a0b1e17fbc88eb3bd12cc5a1ff8a0c
--- man/man1/dial.1
+++ man/man1/dial.1
connects to the network address
.I addr
(see
-.IM dial (3) )
+.MR dial (3) )
and then copies data from the connection to standard output,
and from standard input to the connection.
.PP
.SH SOURCE
.B \*9/src/cmd/dial.c
.SH SEE ALSO
-.IM dial (3)
+.MR dial (3)
blob - 209aca4103ebe4d85d273f5976c5197e0083039b
blob + f4654ea3bf49b277b91784d9c86168466c79cff0
--- man/man1/dict.1
+++ man/man1/dict.1
.PD
.PP
Patterns are regular expressions (see
-.IM regexp (7) ),
+.MR regexp (7) ),
with an implicit leading
.L ^
and trailing
.PP
.I Adict
is a dictionary browser for
-.IM acme (1) .
+.MR acme (1) .
When run with no arguments, it creates a new
.I acme
window named
dictionaries
.PD
.SH "SEE ALSO"
-.IM regexp (7)
+.MR regexp (7)
.SH SOURCE
.B \*9/src/cmd/dict
.br
blob - cffbf0b650e1621b95e8a2b40828fe669eadfbdc
blob + c92f45ef41c55e8390500aa6a8cda0a09a556f11
--- man/man1/diff.1
+++ man/man1/diff.1
.I diff
for text
files and
-.IM cmp (1)
+.MR cmp (1)
otherwise.
If more than two file names are given, then each argument is compared
to the last argument as above.
.SH SOURCE
.B \*9/src/cmd/diff
.SH "SEE ALSO"
-.IM cmp (1) ,
-.IM comm (1) ,
-.IM ed (1)
+.MR cmp (1) ,
+.MR comm (1) ,
+.MR ed (1)
.SH DIAGNOSTICS
Exit status is the empty string
for no differences,
blob - fb9d3b055159f839c6a77ce863b323da5c6bec80
blob + 199323f0e1d283b69d8284ae7eb62e527d419332
--- man/man1/doctype.1
+++ man/man1/doctype.1
.SH DESCRIPTION
.I Doctype
examines a
-.IM troff (1)
+.MR troff (1)
input file to deduce the appropriate text formatting command
and prints it on standard output.
.I Doctype
recognizes input for
-.IM troff (1) ,
+.MR troff (1) ,
related preprocessors like
-.IM eqn (1) ,
+.MR eqn (1) ,
and the
-.IM ms (7)
+.MR ms (7)
and
.I mm
macro packages.
.IR eqn (1),
.IR tbl (1),
.IR pic (1),
-.IM grap (1) ,
-.IM ms (7) ,
-.IM man (7)
+.MR grap (1) ,
+.MR ms (7) ,
+.MR man (7)
.SH BUGS
In true A.I. style, its best guesses are inspired rather than accurate.
blob - 64bf4860b705328854ddf651953d34dd81a8f564
blob + 8dd6f535519c4bd296052eae6c3b97c2501b7262
--- man/man1/ed.1
+++ man/man1/ed.1
supports the
.I "regular expression"
notation described in
-.IM regexp (7) .
+.MR regexp (7) .
Regular expressions are used in addresses to specify
lines and in one command
(see
Send the remainder of the line after the
.L !
to
-.IM rc (1)
+.MR rc (1)
to be interpreted as a command.
Dot is unchanged.
.TP
.SH SOURCE
.B \*9/src/cmd/ed.c
.SH "SEE ALSO"
-.IM sam (1) ,
-.IM sed (1) ,
-.IM regexp (7)
+.MR sam (1) ,
+.MR sed (1) ,
+.MR regexp (7)
.SH DIAGNOSTICS
.BI ? name
for inaccessible file;
blob - 723b2dc34db28f3e46cb982de93cb4c0426c60a1
blob + e50a500d4c6effbef76e2acc6dbc813872c13f5a
--- man/man1/eqn.1
+++ man/man1/eqn.1
.SH DESCRIPTION
.I Eqn
is a
-.IM troff (1)
+.MR troff (1)
preprocessor
for typesetting mathematics
on a typesetter.
option (default
.BR -Tutf ;
see
-.IM troff (1) ).
+.MR troff (1) ).
When run with other preprocessor filters,
.I eqn
usually comes last.
.LR cos ,
.L log
are made Roman automatically.
-.IM Troff (1)
+.MR Troff (1)
four-character escapes like
.L \e(lh
(\(lh) can be used anywhere.
.B \*9/src/cmd/eqn
.SH "SEE ALSO"
.IR troff (1),
-.IM tbl (1)
+.MR tbl (1)
.br
J. F. Ossanna and B. W. Kernighan,
``Troff User's Manual''.
blob - 3c9c0fac46d360a11ad32c459ce1d3ce34acc0ad
blob + 4a55130aecbf0ee24de2174edb6931862c2912d2
--- man/man1/freq.1
+++ man/man1/freq.1
.SH SOURCE
.B \*9/src/cmd/freq.c
.SH SEE ALSO
-.IM utf (7) ,
-.IM wc (1)
+.MR utf (7) ,
+.MR wc (1)
blob - 2583141c485efd6a43b1aa20b080bdaa948f2158
blob + 8387407a4357fde3348bee15b37a8b1abdc25757
--- man/man1/git.1
+++ man/man1/git.1
.I Git
.I diff
runs Unix's
-.IM diff (1)
+.MR diff (1)
to compare the files in the local tree with the corresponding
files in the revision history.
The special revision
blob - 40effe1272d69d7ee13507949405487c7eceb679
blob + d36916dc1cf05d8a3a47a0e78a3bcb2e0c4461f5
--- man/man1/grap.1
+++ man/man1/grap.1
.SH DESCRIPTION
.I Grap
is a
-.IM pic (1)
+.MR pic (1)
preprocessor for drawing graphs on a typesetter.
Graphs are surrounded by the
.I troff
.B \*9/src/cmd/grap
.SH "SEE ALSO"
.IR pic (1),
-.IM troff (1)
+.MR troff (1)
.br
J. L. Bentley and B. W. Kernighan,
``GRAP\(emA Language for Typesetting Graphs'',
blob - 4f1fbed18f4f936a7c960d5db07d2107c821428f
blob + f8a1e088878c0d15f82f6a3fa49755e3950653bf
--- man/man1/graph.1
+++ man/man1/graph.1
Next argument is one or more of the characters
.B bcgkmrwy,
choosing pen colors by their initial letter, as in
-.IM plot (7) .
+.MR plot (7) .
Successive curves will cycle through the colors in the given order.
.TP
.B -s
.B \*9/src/cmd/graph
.SH "SEE ALSO"
.IR plot (1),
-.IM grap (1)
+.MR grap (1)
.SH BUGS
Segments that run out of bounds are dropped, not windowed.
Logarithmic axes may not be reversed.
blob - 18632766b67a2b4a16eb183e540656ac09a6df88
blob + 5fe3a9f72240467d5a928fd808605010588ab8c2
--- man/man1/grep.1
+++ man/man1/grep.1
for lines that match the
.IR pattern ,
a regular expression as defined in
-.IM regexp (7)
+.MR regexp (7)
with the addition of a newline character as an alternative
(substitute for
.BR | )
.br
.B \*9/bin/g
.SH SEE ALSO
-.IM ed (1) ,
-.IM awk (1) ,
-.IM sed (1) ,
-.IM sam (1) ,
-.IM regexp (7)
+.MR ed (1) ,
+.MR awk (1) ,
+.MR sed (1) ,
+.MR sam (1) ,
+.MR 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 - 153299659440cea93a1ad8ac34c7ad07477d6d64
blob + 8961b625a7463f8fde1e1c2cb024851077096d58
--- man/man1/gview.1
+++ man/man1/gview.1
.SH SOURCE
.B \*9/src/cmd/draw/gview.c
.SH SEE ALSO
-.IM awk (1)
+.MR awk (1)
.SH BUGS
The user interface for the
.I slant
blob - 593b713faa51636512f91be39db71f1e6f4825b4
blob + 2f78c89f69beb763861eabdcc28d05d997019d1d
--- man/man1/gzip.1
+++ man/man1/gzip.1
.br
.B \*9/src/cmd/bzip2
.SH SEE ALSO
-.IM tar (1) ,
-.IM compress (1)
+.MR tar (1) ,
+.MR compress (1)
.SH BUGS
.I Unzip
can only extract files which are uncompressed or compressed
blob - 41a2b402cc8caba80cfdc09f369984628a8e0e0b
blob + bec129a8edf4bbd2a6d3a105458870085fa1b6d1
--- man/man1/hist.1
+++ man/man1/hist.1
The
.B -d
option causes
-.IM diff (1)
+.MR diff (1)
.B -c
to be run for each adjacent pair of dump files, while
.B -b
.SH SOURCE
.B \*9/src/cmd/hist.c
.SH SEE ALSO
-.IM yesterday (1) ,
-.IM vbackup (8)
+.MR yesterday (1) ,
+.MR vbackup (8)
.SH BUGS
Should be called
.IR history ,
but
that name is taken by
-.IM sh (1) .
+.MR sh (1) .
blob - 561752008b833f98f8fc72f9ddfc8158f1299d16
blob + 24075b0b071da41cb405690688a71c5bbda6e35e
--- man/man1/hoc.1
+++ man/man1/hoc.1
.SH SOURCE
.B \*9/src/cmd/hoc
.SH "SEE ALSO"
-.IM bc (1) ,
-.IM dc (1)
+.MR bc (1) ,
+.MR dc (1)
.br
B. W. Kernighan and R. Pike,
.I
blob - 28d243c77a577b4d041f136f2521606543b75933
blob + 197c2f04ef215f1e073745241392ba1c8fb5f397
--- man/man1/htmlroff.1
+++ man/man1/htmlroff.1
.SH DESCRIPTION
.I Htmlroff
accepts
-.IM troff (1)
+.MR troff (1)
input in the named
.I files
and formats it as HTML for viewing in a web browser.
and so on).
.I Htmlroff
invokes
-.IM tcs (1)
+.MR tcs (1)
for the conversion.
.TP
.B -v
Most
.I troff
input files, especially those using the
-.IM ms (7)
+.MR ms (7)
macros, can be used unaltered.
In general, the macro file
.B tmac.html
.B -ms
.BR -mhtml .
.PP
-.IM Htmlroff (7)
+.MR Htmlroff (7)
describes the changes to the input language.
.PP
-.IM Mhtml (7)
+.MR Mhtml (7)
describes the new macros.
.SH EXAMPLES
Format the Plan 9 web page:
.SH SOURCE
.B \*9/src/cmd/htmlroff
.SH "SEE ALSO
-.IM tcs (1) ,
-.IM troff (1) ,
-.IM htmlroff (7) ,
-.IM mhtml (7)
+.MR tcs (1) ,
+.MR troff (1) ,
+.MR htmlroff (7) ,
+.MR mhtml (7)
blob - c0ffebcfe7f5e24605359c37ee56f25137658edd
blob + 49a2df6b735b5aac926bc55e9615ca5817dda22a
--- man/man1/idiff.1
+++ man/man1/idiff.1
.PP
.I Idiff
invokes
-.IM diff (1)
+.MR diff (1)
to compare the files.
The
.B -b
.SH SOURCE
.B \*9/src/cmd/idiff.c
.SH "SEE ALSO
-.IM diff (1)
+.MR diff (1)
.br
Kernighan and Pike,
.IR "The Unix Programming Environment" ,
blob - 6097f4358ecd20e7c7e91de948dd5adedf82bbaa
blob + 4b173d1811500308b9a63fc72cd0a1c561f1b6fb
--- man/man1/install.1
+++ man/man1/install.1
.SH DESCRIPTION
To obtain the Plan 9 tree, use Git
(see
-.IM git (1) )
+.MR git (1) )
or download a tar file from
.HR https://9fans.github.io/plan9port "" .
.PP
In the root of the tree, run
.BR ./INSTALL .
This script builds the Plan 9 build program
-.IM mk (1)
+.MR mk (1)
if necessary,
cleans all previously built object files and libraries out of the tree,
rebuilds and installs everything, and then cleans up.
.PP
Once the system is built for the first time,
it can be maintained and rebuilt using
-.IM mk (1) .
+.MR mk (1) .
To rebuild individual commands or libraries,
run
.B mk
.B clean
in the appropriate source directory
(see
-.IM src (1) ).
+.MR src (1) ).
.SH FILES
.TP
.B \*9/lib/moveplan9.files
.TP
.B \*9/src/mkmk.sh
the shell script used to build
-.IM mk (1)
+.MR mk (1)
.TP
.B \*9/dist/manweb
the shell script that builds the HTML manual
a summary of
.B install.log
.SH SEE ALSO
-.IM intro (1) ,
-.IM git (1)
+.MR intro (1) ,
+.MR git (1)
blob - 13741be362d30d4d30b67db21a80c268f1936420
blob + f9c9d543c1be604b08460c08e620c770a1a3f7b9
--- man/man1/join.1
+++ man/man1/join.1
The layout of
.B /adm/users
is given in
-.IM passwd (5) ;
+.MR passwd (5) ;
.B bdays
contains sorted lines like
.LR "ken:Feb\ 4,\ 1953" .
.SH "SEE ALSO"
.IR sort (1),
.IR comm (1),
-.IM awk (1)
+.MR awk (1)
.SH BUGS
With default field separation,
the collating sequence is that of
blob - bdc9110bcf0aa2bb4499b1ad3c137303c740b076
blob + 037672213e0cea16a51a95bca5e189cb303ba3b3
--- man/man1/jpg.1
+++ man/man1/jpg.1
.BR q ,
DEL, or control-D exits the program.
For a more user-friendly interface, use
-.IM page (1) ,
+.MR 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
.TP
.B -c
Convert the image to a Plan 9 representation, as defined by
-.IM image (7) ,
+.MR image (7) ,
and write it to standard output.
.TP
.B -9
but produce an uncompressed image.
This saves processing time, particularly when the output is
being piped to another program such as
-.IM page (1) ,
+.MR page (1) ,
since it avoids compression and decompression.
.TP
.B -t
.SH SOURCE
.B \*9/src/cmd/jpg
.SH "SEE ALSO"
-.IM page (1) ,
-.IM image (7) .
+.MR page (1) ,
+.MR image (7) .
.SH BUGS
Writing an animated GIF using
.I togif
blob - ee311017c005fd1d120441ffa8445c06caeb2268
blob + f82b48776c73e315dfd1b648f228ea4705005a37
--- man/man1/kill.1
+++ man/man1/kill.1
.I name
and owned by the current user to be terminated.
Each command is commented with an output line from
-.IM ps (1)
+.MR ps (1)
describing the process that would be killed.
Use the
.B send
command of
-.IM 9term (1) ,
+.MR 9term (1) ,
or pipe the output of
.I kill
into
-.IM rc (1)
+.MR rc (1)
or
-.IM sh (1)
+.MR sh (1)
to execute the commands.
.PP
.I Kill
.SH SOURCE
.B \*9/bin
.SH "SEE ALSO"
-.IM ps (1) ,
-.IM notify (3)
+.MR ps (1) ,
+.MR notify (3)
.SH BUGS
.I Stop
and
blob - 92334f19782fee47c3e2941e6061282129c5d63a
blob + 6688972d58d47c7a50cedf5efbc280a204e522c0
--- man/man1/label.1
+++ man/man1/label.1
sets the label of the current
.I win
(see
-.IM acme (1) )
+.MR acme (1) )
or X terminal window
.RI ( e.g.,
-.IM 9term (1)
+.MR 9term (1)
or
-.IM xterm (1) )
+.MR xterm (1) )
by echoing a special control sequence to standard output.
.PP
.I Acme
suffix, using the name of the current system by default.
.SH EXAMPLE
One can use the following
-.IM sh (1)
+.MR sh (1)
function to keep the label up-to-date in response to
.I cd
commands:
cd .
.EE
.PP
-.IM Rc (1)
+.MR Rc (1)
installs a similar
.B fn
.B cd
.SH BUGS
.I Awd
is also documented in
-.IM acme (1) .
+.MR acme (1) .
blob - fe99bd6c8ebe40c8606113e403f38fb473428bc3
blob + a740c2e871506b238dc00726ab733f12a7a1e007
--- man/man1/lex.1
+++ man/man1/lex.1
template
.SH "SEE ALSO"
.IR yacc (1),
-.IM sed (1)
+.MR sed (1)
.br
M. E. Lesk and E. Schmidt,
`LEX\(emLexical Analyzer Generator',
blob - 20f46a9621882430b1289ee1e1459575aec80b11
blob + 731d616e7dcd3013447011ce0d44ecab930e0037
--- man/man1/look.1
+++ man/man1/look.1
.B \*9/src/cmd/look.c
.SH "SEE ALSO"
.IR sort (1),
-.IM grep (1)
+.MR grep (1)
.SH DIAGNOSTICS
The exit status is
.RB `` "not found" ''
blob - b4a5f77278faf6536dd6c25f20bb86b22bbad7e3
blob + 863f8e22274407bc8f01e76061de947b9b0ccbf6
--- man/man1/ls.1
+++ man/man1/ls.1
but sets the
.B -p
option and pipes the output through
-.IM mc (1) .
+.MR mc (1) .
.PP
There are a number of options:
.TP
(e.g., for devices, the
.B #
code letter that names it; see
-.IM intro (3) ),
+.MR intro (3) ),
the instance or subdevice number, owner, group,
size in bytes, and time of last modification
for each file.
List the
.I qid
(see
-.IM stat (3) )
+.MR stat (3) )
of each file; the printed fields are in the order
path, version, and type.
.TP
.TP
.B -Q
By default, printed file names are quoted if they contain characters special to
-.IM rc (1) .
+.MR rc (1) .
The
.B -Q
flag disables this behavior.
.br
.B \*9/bin/lc
.SH SEE ALSO
-.IM stat (3) ,
-.IM mc (1)
+.MR stat (3) ,
+.MR mc (1)
blob - cdab681ad7698e712c29d7c5598b850fe05b864f
blob + 2fc8c1f5baafe9b577d35153a42c7d7cf22ec3b7
--- man/man1/man.1
+++ man/man1/man.1
.TP
.B -h
Print the pages to HTML and send to a web browser with
-.IM web (1) .
+.MR web (1) .
.TP
.B -n
(Default)
.TP
.B -p
Run
-.IM proof (1)
+.MR proof (1)
on the specified man pages.
.TP
.B -P
Run
-.IM page (1)
+.MR page (1)
on the specified man pages.
.TP
.B -t
Run
-.IM troff (1)
+.MR troff (1)
and send its output
to standard output.
.TP
.br
.B \*9/bin/lookman
.SH "SEE ALSO"
-.IM page (1) ,
-.IM proof (1)
+.MR page (1) ,
+.MR proof (1)
.SH BUGS
The manual was intended to be typeset; some detail is sacrificed on text terminals.
.PP
blob - e5c25304136daeb3000b00c4dad70a019176b26e
blob + d526aa484b84c083746fdb206bb4addea49d64d7
--- man/man1/map.1
+++ man/man1/map.1
The
.I file
contains
-.IM plot (7) -style
+.MR plot (7) -style
data for
.L :
or
.B \*9/src/cmd/map
.SH "SEE ALSO"
.IR map (7),
-.IM plot (1)
+.MR plot (1)
.SH DIAGNOSTICS
`Map seems to be empty'\(ema coarse survey found
zero extent within the
blob - 4727df5fbef0c7a2e49e1b7dae2fe1f1f5d3e28b
blob + 627202be7daaca4daadb1095018e4271b2f7cc39
--- man/man1/mc.1
+++ man/man1/mc.1
.I N
print positions.
If run in a
-.IM 9term (1) ,
-.IM xterm (1) ,
+.MR 9term (1) ,
+.MR xterm (1) ,
or
-.IM acme (1)
+.MR acme (1)
window, the default
.I N
is the number of blanks that will fit across the window;
.SH SOURCE
.B \*9/src/cmd/draw/mc.c
.SH "SEE ALSO"
-.IM 9term (1) ,
-.IM acme (1) ,
-.IM acme (4) ,
-.IM xterm (1) ,
-.IM pr (1) ,
+.MR 9term (1) ,
+.MR acme (1) ,
+.MR acme (4) ,
+.MR xterm (1) ,
+.MR pr (1) ,
.I lc
in
-.IM ls (1)
+.MR ls (1)
.SH BUGS
On systems with high-DPI screens,
.I 9term
blob - 4b5e94d4c3a9f4ce5aa9ae76a8a0e81e2d47a3c3
blob + 4c3d2b701ea3183c1a1d274720eb424534074be2
--- man/man1/mk.1
+++ man/man1/mk.1
.I rule
for each target that identifies the files and other
targets upon which it depends and an
-.IM sh (1)
+.MR sh (1)
script, a
.IR recipe ,
to update the target.
contains the string matched by the
.BR % .
For example, a meta-rule to compile a C program using
-.IM 9c (1)
+.MR 9c (1)
might be:
.IP
.EX
Special characters may be quoted using single quotes
.BR \&''
as in
-.IM sh (1) .
+.MR sh (1) .
.PP
Assignments and rules are distinguished by
the first unquoted occurrence of
or
.B ${name}
is expanded as in
-.IM sh (1) .
+.MR sh (1) .
A reference of the form
.BI ${name: A % B = C\fL%\fID\fL}\fR,
where
.BR rcsh ,
.I mk
uses
-.IM rc (1) 's
+.MR rc (1) 's
quoting rules; otherwise it uses
-.IM sh (1) 's.
+.MR sh (1) 's.
The
.B MKSHELL
variable is consulted when the mkfile is read, not when it is executed,
Currently, the only aggregates supported are
.I 9ar
(see
-.IM 9c (1) )
+.MR 9c (1) )
archives.
.SS Attributes
The colon separating the target from the prerequisites
.B %
has no special meaning.
The target is interpreted as a regular expression as defined in
-.IM regexp (7) .
+.MR regexp (7) .
The prerequisites may contain references
to subexpressions in form
.BI \e n\f1,
as in the substitute command of
-.IM sed (1) .
+.MR sed (1) .
.TP
.B U
The targets are considered to have been updated
.EE
.PP
A correct way to deal with
-.IM yacc (1)
+.MR yacc (1)
grammars.
The file
.B lex.c
.SH SOURCE
.B \*9/src/cmd/mk
.SH SEE ALSO
-.IM sh (1) ,
-.IM regexp (7)
+.MR sh (1) ,
+.MR regexp (7)
.PP
A. Hume,
``Mk: a Successor to Make''
blob - 34c21eb833c0e5d38b9b868ac2d5c7a5bd4dd4cc
blob + 4f78bd27374d5ea0cc9b1875d3a403bb486a8625
--- man/man1/mk9660.1
+++ man/man1/mk9660.1
The
.I proto
file is formatted as described in
-.IM proto (3) .
+.MR proto (3) .
.PP
The created CD image will be in ISO-9660
format, but by default the file names will
.SH SOURCE
\*9/src/cmd/9660
.SH "SEE ALSO
-.IM proto (3)
+.MR proto (3)
.\" .SH "SEE ALSO"
.\" .I 9660srv
.\" (in
blob - ece75f34705ff4bb3ac35ae432961cf310397f90
blob + b91ba22ed503e83658efac3fe96ec30ceaecf24e
--- man/man1/mkdir.1
+++ man/man1/mkdir.1
flag sets the permissions to be used when creating the directory.
The default is 0777.
.SH "SEE ALSO"
-.IM rm (1)
+.MR rm (1)
.br
.IR cd
in
-.IM rc (1)
+.MR rc (1)
.SH SOURCE
.B \*9/src/cmd/mkdir.c
.SH DIAGNOSTICS
blob - 51f1c785f35dd02f1484f64fdb3c0c4314a89bb1
blob + 123a395ae3fb4715fc4ee08ac041898e21007b2f
--- man/man1/mount.1
+++ man/man1/mount.1
is typically
either the name of a Unix domain socket
(see
-.IM namespace (1) )
+.MR namespace (1) )
or the name or IP address of a machine
serving 9P over TCP port 564.
.PP
.I mount
uses the native 9P kernel module when present.
Otherwise it tries to use
-.IM 9pfuse (4)
+.MR 9pfuse (4)
with the FUSE file system module.
Using the 9P kernel module requires root access.
FUSE can often be used by regular users.
.BR mount .
.SH EXAMPLES
Mount
-.IM acme (4)
+.MR acme (4)
onto
.B /mnt/acme :
.IP
.br
.B \*9/bin/unmount
.SH SEE ALSO
-.IM intro (4) ,
+.MR intro (4) ,
.IR intro (9p),
-.IM 9pfuse (4)
+.MR 9pfuse (4)
blob - 238877e1aca034eb4bda16862dfde07fe93103fd
blob + 7015ca25723a0716ba0db2c151cc8f529861da13
--- man/man1/namespace.1
+++ man/man1/namespace.1
.I Namespace
prints the directory representing the current name space.
See
-.IM intro (4) .
+.MR intro (4) .
.SH SOURCE
.B \*9/src/cmd/namespace.c
.SH SEE ALSO
-.IM getns (3) ,
-.IM intro (4)
+.MR getns (3) ,
+.MR intro (4)
blob - a92b05b1ae32c56263fc26c0f4aec24d2dd85205
blob + 4ce7616b36922c22ee882d063fd53a9c64c5dd63
--- man/man1/ndb.1
+++ man/man1/ndb.1
The network database holds administrative information used by
.I authdial
(see
-.IM authsrv (3) )
+.MR authsrv (3) )
and
-.IM secstored (1) .
+.MR secstored (1) .
.PP
.I Ndbquery
searches the database for an attribute of type
uses
.I ndbipinfo
(see
-.IM ndb (3) )
+.MR ndb (3) )
to search for the values of the attributes
.I rattr
corresponding to the system
.PP
.I Ndbmkdb
is used in concert with
-.IM awk (1)
+.MR awk (1)
scripts to convert
uucp systems files and IP host files
into database files.
.I ndbmkhash
whenever the files are modified.
It may be profitable to control this by a frequent
-.IM cron (8)
+.MR cron (8)
job.
.PP
.I Ndbmkhosts
.SH SOURCE
.B \*9/src/cmd/ndb
.SH SEE ALSO
-.IM ndb (3) ,
-.IM ndb (7)
+.MR ndb (3) ,
+.MR ndb (7)
blob - 11ab979dcc76b754cba5728f83a960a675fd52e6
blob + 97f72c6ffb01a6715d62f5cc9c9cd6c2d52db37f
--- man/man1/netfiles.1
+++ man/man1/netfiles.1
.SH DESCRIPTION
.B Netfiles
presents remote file systems in
-.IM acme (4)
+.MR acme (4)
windows.
Each window is named
.BI /n/ system / path
plumbing channel
.B netfileedit
(see
-.IM plumber (4)
+.MR plumber (4)
and the example section below).
In a
.IR netfiles -controlled
.I system
is a service in the current name space
(see
-.IM intro (4) ).
+.MR intro (4) ).
If so, they use
-.IM 9p (1)
+.MR 9p (1)
to access it.
Otherwise, they assume that the system is a network name
and use
-.IM ssh (1) 's
+.MR ssh (1) 's
.I sftp
to access it.
.PP
.SH EXAMPLES
The following plumbing rule
(see
-.IM plumb (7) )
+.MR plumb (7) )
passes
.B /n/
paths to
.SH SOURCE
.B \*9/src/cmd/netfiles
.SH SEE ALSO
-.IM 9p (1) ,
-.IM ssh (1) ,
-.IM ssh-agent (1) ,
-.IM intro (4) ,
-.IM acme (4) ,
-.IM factotum (4) ,
+.MR 9p (1) ,
+.MR ssh (1) ,
+.MR ssh-agent (1) ,
+.MR intro (4) ,
+.MR acme (4) ,
+.MR factotum (4) ,
.HR http://v9fs.sf.net
.SH BUGS
.I Netfiles
depends on
-.IM sftpcache (1) ,
+.MR sftpcache (1) ,
which only works with OpenSSH versions 4.3 and earlier;
later versions do not print the
.B sftp>
blob - 4284bda2cc46f2c56a167216d3515d1ed0ada3b1
blob + 8edefe2602d6109adc3c419cbc2a7e1f27b57ad3
--- man/man1/page.1
+++ man/man1/page.1
PostScript,
PDF,
or
-.IM troff (1)
+.MR troff (1)
or
Unix's
.IR tex (1)
FAX
page,
a Plan 9
-.IM image (7)
+.MR image (7)
file, an Inferno bitmap file, or other common format).
.I Page
displays these
.B image
plumbing channel
(see
-.IM plumber (4) )
+.MR plumber (4) )
for more images to display.
The
.B -i
Typing a
.B w
will write the currently viewed page to a new file as a compressed
-.IM image (7)
+.MR image (7)
file.
When possible, the filename is of the form
.IR basename . pagenum . bit .
PDF
.IR files .
It also calls a variety of conversion programs, such as those described in
-.IM jpg (1) ,
+.MR jpg (1) ,
to convert the various raster graphics formats
into Inferno bitmap files.
Pages are converted ``on the fly,'' as needed.
man -t page | page -w
Preview this manual in a new window.
.SH "SEE ALSO
-.IM gs (1) ,
-.IM jpg (1) ,
-.IM proof (1) ,
-.IM tex (1) ,
-.IM troff (1)
+.MR gs (1) ,
+.MR jpg (1) ,
+.MR proof (1) ,
+.MR tex (1) ,
+.MR troff (1)
.SH SOURCE
.B \*9/src/cmd/page
.SH DIAGNOSTICS
Displaying a PostScript or PDF file depends both on having
GhostScript
(see
-.IM gs (1) )
+.MR gs (1) )
installed and on the underlying operating system
providing a file descriptor device tree at
.BR /dev/fd .
blob - fa37ceb74ad52aa7805a267d44009dea783da012
blob + 838535c02d6209ca6c1902774e52d89822c364aa
--- man/man1/paint.1
+++ man/man1/paint.1
argument is specified, then it is read and used as the canvas.
.I Paint
only recognizes Plan 9 bitmap format (see
-.IM image (6) ).
+.MR image (6) ).
.PP
A number of immediate keyboard commands are recognized:
.TP
.SH SOURCE
.B /sys/src/cmd/paint.c
.SH "SEE ALSO"
-.IM resample (1) ,
-.IM rotate (1) ,
-.IM crop (1) ,
-.IM jpg (1) ,
-.IM page (1) ,
-.IM image (6)
+.MR resample (1) ,
+.MR rotate (1) ,
+.MR crop (1) ,
+.MR jpg (1) ,
+.MR page (1) ,
+.MR image (6)
.SH HISTORY
.I Paint
first appeared in 9front (October, 2011).
blob - d31f3a8bc38afd8b4f3eaf327b742ff3c517a40b
blob + 9f32497f368a7c0f9990e7437ff4b7a55940ce6c
--- man/man1/passwd.1
+++ man/man1/passwd.1
.br
.B \*9/src/cmd/auth/passwd.c
.SH "SEE ALSO"
-.IM encrypt (3)
+.MR encrypt (3)
.PP
Robert Morris and Ken Thompson,
``UNIX Password Security,''
blob - b18ee2514dff8e8aa3fc2efd63d7b23961bc8d8d
blob + 9911af95fd22b057cfdbc36522527ea65b5fcad1
--- man/man1/pem.1
+++ man/man1/pem.1
other applications, notably TLS.
PEM encodes data in base 64
(see
-.IM encode (3) )
+.MR encode (3) )
between lines of the form:
.IP
.EX
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
-.IM rsa (1) .
+.MR rsa (1) .
.PP
.I Pemdecode
extracts the named
.SH SOURCE
.B \*9/src/cmd/auth
.SH "SEE ALSO
-.IM rsa (1)
+.MR rsa (1)
blob - bacc1dcb649755f10dc4841bee80ecc49e7d1dff
blob + d122ff3b581494da067574a6377b2abd73232da4
--- man/man1/pic.1
+++ man/man1/pic.1
.SH DESCRIPTION
.I Pic
is a
-.IM troff (1)
+.MR troff (1)
preprocessor for drawing figures on a typesetter.
.I Pic
code is contained between
.PP
.I Tpic
is a
-.IM tex (1)
+.MR tex (1)
preprocessor that accepts
.IR pic
language.
.B \*9/src/cmd/pic
.SH "SEE ALSO"
.IR grap (1),
-.IM doctype (1) ,
-.IM troff (1)
+.MR doctype (1) ,
+.MR troff (1)
.br
B. W. Kernighan,
``PIC\(ema Graphics Language for Typesetting'',
blob - 8485bcd5d5fd3e85f94332e09ef76a01925c5b26
blob + 87d6936a854c485a07cb251abe531fabe3d3e159
--- man/man1/plot.1
+++ man/man1/plot.1
.I files
or standard input,
drawing the results in a newly created
-.IM rio (1)
+.MR rio (1)
window.
Plot persists until a newline is typed in the window.
Various options may be interspersed with the
.TP
.BI -c " col"
Set the foreground color (see
-.IM plot (7)
+.MR plot (7)
for color names).
.TP
.BI -f " fill"
.SH SOURCE
.B \*9/src/cmd/plot
.SH "SEE ALSO"
-.IM rio (1) ,
-.IM plot (7)
+.MR rio (1) ,
+.MR plot (7)
blob - a6295342f4122736e335fe234f0952070d1ca3a1
blob + 39e4d6c531d3cd7e1721e69e8d39fbeecefae18e
--- man/man1/plumb.1
+++ man/man1/plumb.1
.SH SOURCE
.B \*9/src/cmd/plumb
.SH "SEE ALSO"
-.IM plumb (3) ,
-.IM plumber (4) ,
-.IM plumb (7)
+.MR plumb (3) ,
+.MR plumber (4) ,
+.MR plumb (7)
blob - f7069ac0a039125eaa5dff81562c1833800ab4c1
blob + 624c25fb9b9bca279e7cafa46202ed4e8d2446f6
--- man/man1/pr.1
+++ man/man1/pr.1
.SH SOURCE
.B \*9/src/cmd/pr.c
.SH "SEE ALSO"
-.IM cat (1) ,
-.IM lp (1)
+.MR cat (1) ,
+.MR lp (1)
blob - fe5db6d3f8c523e62b8892505ac4ca8546423539
blob + 63b70a6bbe20d5ed65df8d2886d9239592ac4aa2
--- man/man1/proof.1
+++ man/man1/proof.1
.SH DESCRIPTION
.I Proof
reads
-.IM troff (1)
+.MR troff (1)
intermediate language from
.I file
or standard input
.B \*9/src/cmd/proof
.SH SEE ALSO
.IR lp (1),
-.IM gs (1) ,
-.IM page (1)
+.MR gs (1) ,
+.MR page (1)
.br
J. F. Ossanna and B. W. Kernighan,
``Troff User's Manual''
blob - c597060ff7de7653fdbdbbe1c8ec4b9aa768e62e
blob + 5904564abc946bb1cdbe00fa49ee754da7645eb5
--- man/man1/ps.1
+++ man/man1/ps.1
.br
.B \*9/bin/psu
.SH "SEE ALSO"
-.IM acid (1) ,
-.IM db (1) ,
-.IM kill (1)
+.MR acid (1) ,
+.MR db (1) ,
+.MR kill (1)
blob - 223c74f528ec4e65e30a32e255acd54fff55b257
blob + 2c4b05315c40db8ff3edf672174938cb919d744b
--- man/man1/psfonts.1
+++ man/man1/psfonts.1
]
.SH DESCRIPTION
Plan 9's
-.IM troff (1)
+.MR troff (1)
and
-.IM tr2post (1)
+.MR tr2post (1)
use non-standard PostScript fonts
(found in
.BR \*9/postscript/font ).
.PD
.SH EXAMPLE
See
-.IM tr2post (1)
+.MR tr2post (1)
for an example.
.SH SOURCE
.B \*9/bin/psfonts
.br
.B \*9/src/cmd/postscript/download
.SH SEE ALSO
-.IM troff (1) ,
-.IM tr2post (1)
+.MR troff (1) ,
+.MR tr2post (1)
blob - 1464302df0a7123ac98618a5a951a0a9ef0883c0
blob + e0a506fb76664f88aa37b5f82f7fcb51eeb387b0
--- man/man1/pwd.1
+++ man/man1/pwd.1
.SH SEE ALSO
.I cd
in
-.IM rc (1) ,
-.IM getwd (3)
+.MR rc (1) ,
+.MR getwd (3)
.SH BUGS
.I Pwd
is not provided.
blob - 1d6a008b201564bf1ad9b31b6483727be4666819
blob + 38a867d76d664f0b8f5e73abebe4629d97948dc7
--- man/man1/rc.1
+++ man/man1/rc.1
variable
.B $status
gets the process's wait message (see
-.IM wait (3) );
+.MR 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
.B $path
is the program to be executed.
To be executable, the user must have execute permission (see
-.IM stat (3) )
+.MR 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
is a previously opened file descriptor and
.I fd0
becomes a new copy (in the sense of
-.IM dup (3) )
+.MR dup (3) )
of it.
A file descriptor may be closed by writing
.BI >[ fd0 =]
A function with a special name will be called when
.I rc
receives a corresponding note; see
-.IM notify (3) .
+.MR notify (3) .
The valid note names (and corresponding notes) are
.B sighup
.RB ( hangup ),
.B rfork
flags specified by the option letters
(see
-.IM fork (2) ).
+.MR fork (2) ).
If no
.I flags
are given, they default to
.B $PATH
variable
(as in
-.IM sh (1) )
+.MR sh (1) )
or by
.BR "path=(.\ /bin)" .
The variables
blob - d85452b7c5d578de927c28b99333c2f1792a57de
blob + 6fc56a66222e4d424dceb9bbcea8ec5c483fa51f
--- man/man1/readcons.1
+++ man/man1/readcons.1
.SH SOURCE
.B \*9/src/cmd/readcons.c
.SH SEE ALSO
-.IM readcons (3)
+.MR readcons (3)
blob - 4b41ca081f741319a20fdbf41a5c8c54f0e46ba3
blob + 71c3b74727519da9a82f52f55a14fc5a5626d359
--- man/man1/resample.1
+++ man/man1/resample.1
.PP
The input should be a Plan 9 image
as described in
-.IM image (7) ,
+.MR 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
-.IM crop (1) ).
+.MR crop (1) ).
.PP
.SH SOURCE
.B \*9/src/cmd/resample.c
.SH "SEE ALSO
-.IM crop (1) ,
-.IM image (7)
+.MR crop (1) ,
+.MR image (7)
.SH BUGS
Faster algorithms exist, but this implementation produces correct pictures.
blob - d22ad3e412c22044f1b50f9c29922fce8db9a042
blob + fb4b5dfb9895e9c45742bd5f3d6a490ac170d603
--- man/man1/rio.1
+++ man/man1/rio.1
.I New
menu item is selected.
The default is to try
-.IM 9term (1)
+.MR 9term (1)
and then to fall back to
-.IM xterm (1) .
+.MR 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
-.IM 9term (1)
+.MR 9term (1)
for a description of scrolling behavior.
.PP
The
The new window is created running
.IR termprog ,
by default
-.IM 9term (1)
+.MR 9term (1)
or, if
.I 9term
is not available,
-.IM xterm (1) .
+.MR xterm (1) .
.TP
.B Resize
Change the size and location of a window.
.L hangup
note to be sent to all processes in the window's process group
(see
-.IM notify (3) ).
+.MR notify (3) ).
.TP
.B Hide
Hide a window. Click in the window to be hidden (gunsight cursor);
.PP
There is a currently a compiled-in limit of 128 hidden windows.
.SH "SEE ALSO"
-.IM 9term (1) ,
-.IM xterm (1)
+.MR 9term (1) ,
+.MR xterm (1)
.PP
As mentioned above,
.I rio
blob - ce0ea1c13c34e0812b77029cb7f54aef2c25785f
blob + 104eda93533783492e1bc298c48c97986c007c46
--- man/man1/rm.1
+++ man/man1/rm.1
.SH SOURCE
.B \*9/src/cmd/rm.c
.SH "SEE ALSO"
-.IM remove (3)
+.MR remove (3)
blob - 2ba0d8b034ceb3b35847753db913bbf2c5f98c5a
blob + 4d8f286b29d8308e7fbff9575af19d08abeaa0bd
--- man/man1/rsa.1
+++ man/man1/rsa.1
prefixed with the string
.BR key ;
this is the generic key format used by
-.IM factotum (4) .
+.MR factotum (4) .
A full DSA private key has the following attributes:
.TP
.B proto
.SH SOURCE
.B \*9/src/cmd/auth
.SH "SEE ALSO
-.IM factotum (4) ,
-.IM pem (1) ,
-.IM ssh (1)
+.MR factotum (4) ,
+.MR pem (1) ,
+.MR ssh (1)
.SH BUGS
There are too many key formats.
.PP
blob - c928b667923b3166b1f9cb6eaf49882f2e844aa0
blob + ac9f6e820d090e54a9686d532ede48d5aa57fb0e
--- man/man1/sam.1
+++ man/man1/sam.1
Do not `download' the terminal part of
.IR sam .
Editing will be done with the command language only, as in
-.IM ed (1) .
+.MR ed (1) .
.TP
.BI -r " machine
Run the host part remotely
.PD
.SS Regular expressions
Regular expressions are as in
-.IM regexp (7)
+.MR regexp (7)
with the addition of
.BR \en
to represent newlines.
marked with a dark border, to which typed text and editing
commands apply.
Text may be typed and edited as in
-.IM rio (1) ;
+.MR rio (1) ;
also the escape key (ESC) selects (sets dot to) text typed
since the last mouse button hit.
.PP
with a
.B click
attribute defining where the selection lies (see
-.IM plumb (7) ).
+.MR plumb (7) ).
.TP
.B look
Search forward for the next occurrence of the literal text in dot.
.TP
.B \*9/bin/E
.SH SEE ALSO
-.IM ed (1) ,
-.IM sed (1) ,
-.IM grep (1) ,
-.IM rio (1) ,
-.IM regexp (7) .
+.MR ed (1) ,
+.MR sed (1) ,
+.MR grep (1) ,
+.MR rio (1) ,
+.MR regexp (7) .
.PP
Rob Pike,
``The text editor sam''.
blob - 1fef523362600187be2a79206be6b8e39f321b03
blob + 407b97ef517b23bc48e409c8967069040b0dfe10
--- man/man1/scat.1
+++ man/man1/scat.1
and implements database-like manipulations
on sets of such objects.
It also provides an interface to
-.IM astro (1)
+.MR astro (1)
to plot the locations of solar system objects.
Finally, it displays images from the
Space Telescope Science Institute's
and
.B comet
refer to the earth's penumbra at lunar distance and the comet installed in the current
-.IM astro (1) .
+.MR 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 .
.TP
.BI astro " option"
Run
-.IM astro (1)
+.MR astro (1)
with the specified
.I options
(to which will be appended
.SH SOURCE
.B \*9/src/cmd/scat
.SH SEE ALSO
-.IM astro (1)
+.MR astro (1)
.br
.B \*9/sky/constelnames\ \
the three-letter abbreviations of the constellation names.
blob - 6c25c7303b5f443b5fa151050e75b3ddd915d0e5
blob + 9374e390297e0d6f986376de63a390664f08a4c3
--- man/man1/secstore.1
+++ man/man1/secstore.1
.B -n
says that the password should be read from NVRAM
(see
-.IM authsrv (3) )
+.MR authsrv (3) )
instead of from
.BR /dev/tty .
.PP
.BR -s .
.PP
For example, to add a secret to the file read by
-.IM factotum (4) ,
+.MR factotum (4) ,
run
.sp
.EX
.br
.B \*9/src/cmd/auth/secstore
.SH SEE ALSO
-.IM factotum (4) ,
-.IM secstored (1)
+.MR factotum (4) ,
+.MR secstored (1)
.SH BUGS
There is deliberately no backup of files on the secstore, so
.B -r
blob - d21ff5e59c5e185cbd896b0bf98622aa8a6e78f2
blob + 82eaee3cfe12210d57964f3b17462617db46477a
--- man/man1/secstored.1
+++ man/man1/secstored.1
.PP
.I Secstored
serves requests from
-.IM secstore (1) .
+.MR secstore (1) .
The
.B -R
option supplements the password check with a
.SH SOURCE
.B \*9/src/cmd/auth/secstore
.SH SEE ALSO
-.IM secstore (1)
+.MR secstore (1)
blob - 8df5285e1a6904c2dc3c20b321c8d33d17bc79f3
blob + 8a892da1e72b1bd45150be246ad81b762364ac46
--- man/man1/sed.1
+++ man/man1/sed.1
addresses the last line of input, or a context address,
.BI / regular-expression / \f1,
in the style of
-.IM regexp (7) ,
+.MR regexp (7) ,
with the added convention that
.L \en
matches a
Any character may be used instead of
.LR / .
For a fuller description see
-.IM regexp (7) .
+.MR regexp (7) .
.I Flags
is zero or more of
.RS
.IR grep (1),
.IR awk (1),
.IR lex (1),
-.IM sam (1) ,
-.IM regexp (7)
+.MR sam (1) ,
+.MR regexp (7)
.br
L. E. McMahon,
`SED \(em A Non-interactive Text Editor',
blob - eea10dfaf6a96c426e17a812bb9a32f270317c2f
blob + e181f5bef2795f64f77465618457c30ce03adf47
--- man/man1/seq.1
+++ man/man1/seq.1
.TP "\w'\fL-f \fIformat\fLXX'u"
.BI -f format
Use the
-.IM print (3) -style
+.MR print (3) -style
.I format
.IR print
for printing each (floating point) number.
blob - aec061f4b1ff03c21abc21767d7ee24fab510db7
blob + 8c0a0ad8aa8fc3aebb7ac291e8b6c8bdc1f44edc
--- man/man1/sftpcache.1
+++ man/man1/sftpcache.1
.SH DESCRIPTION
.I Sftpcache
multiplexes clients onto persistent
-.IM sftp (1)
+.MR sftp (1)
connections.
It runs
.I sftp
.IB system .sftp
in the name space directory
(see
-.IM intro (4) ).
+.MR intro (4) ).
Clients can connect to the socket, one at a time,
to interact with the
.I sftp
.PP
.I Sftpcache
is used by
-.IM netfiles (1) .
+.MR netfiles (1) .
.SH SOURCE
.B \*9/src/cmd/sftpcache.c
.SH SEE ALSO
-.IM ssh (1) ,
-.IM sftp (1) ,
-.IM netfiles (1)
+.MR ssh (1) ,
+.MR sftp (1) ,
+.MR netfiles (1)
.SH BUGS
.I Sftpcache
only works with OpenSSH versions 4.3 and earlier;
blob - a6a19a3814e07602969bcf775d3717b38a562ed4
blob + f5f7c4cfff7f673a87881bda12def5c9e17f6245
--- man/man1/sleep.1
+++ man/man1/sleep.1
.SH SOURCE
.B \*9/src/cmd/sleep.c
.SH "SEE ALSO"
-.IM sleep (3)
+.MR sleep (3)
blob - db8ce1987a871ba3fee40075e660702459272b88
blob + ef77c9511a9913637d593794fb7a86764235044d
--- man/man1/snarfer.1
+++ man/man1/snarfer.1
keeps the X11 snarf buffer in sync with the Carbon snarf buffer,
working around a bug in the OS X X11 server.
See
-.IM getsnarf (3)
+.MR getsnarf (3)
for more details.
.SH SOURCE
.B \*9/src/cmd/snarfer
.SH SEE ALSO
Unix's
.IR xclipboard (1),
-.IM getsnarf (3)
+.MR getsnarf (3)
.SH BUGS
Both
.I xclipboard
blob - 6b8f465275014fb5ef7ffd0b9e099de03a84e696
blob + c7324035d502d392c69e2939003f7db9510298da
--- man/man1/soelim.1
+++ man/man1/soelim.1
.I Soelim
reads the specified files or the standard input and performs
the textual inclusion implied by
-.IM troff (1)
+.MR 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
-.IM tbl (1)
+.MR 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"
-.IM deroff (1) ,
-.IM troff (1)
+.MR deroff (1) ,
+.MR troff (1)
blob - d732374c732a509f6d5f0091839b63df4242f516
blob + 6922114b0e9d97f355e63bfb0c46e992df9da0ed
--- man/man1/sort.1
+++ man/man1/sort.1
.SH SOURCE
.B \*9/src/cmd/sort.c
.SH SEE ALSO
-.IM uniq (1) ,
-.IM look (1)
+.MR uniq (1) ,
+.MR look (1)
.SH DIAGNOSTICS
.I Sort
comments and exits with non-null status for various trouble
blob - 3e7388eb387bda399cb761e9151e21929764c5a1
blob + 27ae680399536994c1992ae47cd8b5888a6a1c02
--- man/man1/spell.1
+++ man/man1/spell.1
.PP
.I Spell
ignores constructs of
-.IM troff (1)
+.MR troff (1)
and its standard preprocessors.
It understands these options:
.TP
source for
.I sprog
.SH SEE ALSO
-.IM deroff (1)
+.MR deroff (1)
.SH BUGS
The heuristics of
-.IM deroff (1)
+.MR deroff (1)
used to excise formatting information are imperfect.
.PP
The spelling list's coverage is uneven;
blob - 440cf7eb7003a0325e26c107c854d40e23ec6a33
blob + b61ef1855cad2ad524ac4a01c30ef68c33352c1d
--- man/man1/split.1
+++ man/man1/split.1
that matches a regular
.IR expression ;
see
-.IM regexp (7) .
+.MR regexp (7) .
Multiple
.B -e
options may appear.
.B \*9/src/cmd/split.c
.SH SEE ALSO
.IR sed (1),
-.IM awk (1) ,
-.IM grep (1) ,
-.IM regexp (7)
+.MR awk (1) ,
+.MR grep (1) ,
+.MR regexp (7)
blob - 94f69b4f39a8a37e3e45558df5dfb86837040a3d
blob + 7648602b341f9a63fe329d7ab65e899b5150b0ab
--- man/man1/src.1
+++ man/man1/src.1
to find the corresponding source code, which is then sent to the editor using
.B B
(see
-.IM sam (1) ).
+.MR sam (1) ).
If
.I file
is an
-.IM rc (1)
+.MR rc (1)
script, the source is the file itself.
If
.I file
will point the editor at the line that begins the definition.
.I Src
uses
-.IM db (1)
+.MR db (1)
to extract the symbol table information that identifies the source.
.PP
.I Src
.SH SOURCE
.B \*9/bin/src
.SH "SEE ALSO"
-.IM db (1) ,
-.IM plumb (1) ,
-.IM sam (1) .
+.MR db (1) ,
+.MR plumb (1) ,
+.MR sam (1) .
blob - 17a105aa5eb1596189e6ce12f9e24d1ab7afeca6
blob + aa9fc647a5b01fbe2e7d46f59b966d118a54e584
--- man/man1/ssam.1
+++ man/man1/ssam.1
.B \*9/bin/ssam
.SH SEE ALSO
.IR sed (1),
-.IM sam (1) ,
-.IM regexp (7)
+.MR sam (1) ,
+.MR regexp (7)
.PP
Rob Pike,
``The text editor sam''.
blob - 2300ab9df1e4b7fe790e281036d88d4f71dddce0
blob + 70ecec647025eecb2020ba0ce87d2e957646c6b9
--- man/man1/ssh-agent.1
+++ man/man1/ssh-agent.1
.SH DESCRIPTION
.I Ssh-agent
presents
-.IM factotum (4)
+.MR factotum (4)
using the interface that
-.IM ssh (1)
+.MR ssh (1)
requires.
.PP
Once
.B ssh-agent.socket
in the name space directory
(see
-.IM intro (4) ).
+.MR intro (4) ).
Note that although the socket is posted in the name space
directory, it is not for 9P conversations.
.I Ssh
.B 9
.BR ssh-agent ;
see
-.IM 9 (1) .
+.MR 9 (1) .
.SH EXAMPLES
Assume
-.IM factotum (4)
+.MR factotum (4)
is already running and initialized with keys.
.PP
Start a new agent, copying the commands by hand:
.EE
.PP
Start the agent from
-.IM sh (1) :
+.MR sh (1) :
.IP
.EX
$ eval `9 ssh-agent -e`
.EE
.PP
Start the agent from
-.IM rc (1) :
+.MR rc (1) :
.IP
.EX
% eval `{9 ssh-agent}
.SH SOURCE
.B \*9/src/cmd/auth/ssh-agent.c
.SH SEE ALSO
-.IM ssh (1) ,
-.IM rsa (1) ,
-.IM factotum (4)
+.MR ssh (1) ,
+.MR rsa (1) ,
+.MR factotum (4)
.SH BUGS
A surprise rather than a bug:
.I ssh-agent
blob - c4d950ed67d285a18e4c03a238f4f500aa6fb5bc
blob + b4070f0fe811bd1884f95c8a1a837a904e1cc907
--- man/man1/strings.1
+++ man/man1/strings.1
.SH SOURCE
.B \*9/src/cmd/strings.c
.SH SEE ALSO
-.IM nm (1)
+.MR nm (1)
blob - 3d674cb31ccfea1c330256395dab5864d01efbab
blob + 727f273feecfc1f85dab51a3ea47d3e58ff0b542
--- man/man1/sum.1
+++ man/man1/sum.1
.br
.B \*9/src/cmd/sha1sum.c
.SH "SEE ALSO"
-.IM cmp (1) ,
-.IM wc (1)
+.MR cmp (1) ,
+.MR wc (1)
blob - a7455fbe14fa633f7f7f937e03fb132467526a1e
blob + dc4d666c3a12e72b8cb5413c7171bd57fd2b1daa
--- man/man1/tar.1
+++ man/man1/tar.1
.B z
Operate on compressed tar archives.
The type of compression is inferred from the file name extension:
-.IM gzip (1)
+.MR gzip (1)
for
.B .tar.gz
and
.BR .tgz ;
.I bzip2
(see
-.IM gzip (1) )
+.MR gzip (1) )
for
.BR .tar.bz ,
.BR .tbz ,
.SH SEE ALSO
.I 9ar
in
-.IM 9c (1) ,
-.IM bundle (1)
+.MR 9c (1) ,
+.MR bundle (1)
.SH BUGS
There is no way to ask for any but the last
occurrence of a file.
blob - c727fb2bd1e00ea43971928c4679ac77129d1f80
blob + c241a0ab22494b9b3e5f92fb9b326b289def4e1d
--- man/man1/tbl.1
+++ man/man1/tbl.1
is a preprocessor for formatting tables for
.I nroff
or
-.IM troff (1) .
+.MR troff (1) .
The input
.I files
are copied to the standard output,
and
.I y
as
-.IM eqn (1)
+.MR eqn (1)
delimiters
.PD
.RE
.B \*9/src/cmd/tbl
.SH SEE ALSO
.IR troff (1),
-.IM eqn (1) ,
-.IM doctype (1)
+.MR eqn (1) ,
+.MR doctype (1)
.br
M. E. Lesk and L. L. Cherry,
``TBL\(ema Program to Format Tables'',
blob - 6e32b5f1df1ba117a1b4491430728d36d3f93a0d
blob + ef871fa4c5eadb78a2c6ee757c2300f06ed45abd
--- man/man1/tcs.1
+++ man/man1/tcs.1
the
.SM UTF
encoding described in
-.IM utf (7) .
+.MR utf (7) .
The
.B -l
option lists the character sets known to
.SH SEE ALSO
.IR ascii (1),
.IR rune (3),
-.IM utf (7) .
+.MR utf (7) .
blob - 3553804fd64fdb946f13ae18692cd7509cf0635a
blob + 0a8499138fb032f5a0074cb1f7e11d1e8e91ef95
--- man/man1/test.1
+++ man/man1/test.1
.I Test
is a dubious way to check for specific character strings:
it uses a process to do what an
-.IM rc (1)
+.MR rc (1)
match or switch statement can do.
The first example is not only inefficient but wrong, because
.I test
blob - 91e3383199a59b4698bb60304492450bc4407846
blob + 25d3dbf21838a8ddda49e4226d98267afca543ce
--- man/man1/time.1
+++ man/man1/time.1
.SH SOURCE
.B \*9/src/cmd/time.c
.SH "SEE ALSO"
-.IM prof (1)
+.MR prof (1)
blob - 086d4a8280c9f44ce5f93c77ced7eac71482fd91
blob + 2a48c3c2d27445689aa0f3162c91f4bc82666454
--- man/man1/touch.1
+++ man/man1/touch.1
.SH SOURCE
.B \*9/src/cmd/touch.c
.SH SEE ALSO
-.IM ls (1) ,
-.IM stat (3) ,
-.IM chmod (1)
+.MR ls (1) ,
+.MR stat (3) ,
+.MR chmod (1)
.SH BUGS
.I Touch
will not touch directories.
blob - 3746e48eb00521c69cf38bcd41e931aaa81a2bc5
blob + 74c512fb2e16160eb44d6b5af1add9dbd1936644
--- man/man1/tr.1
+++ man/man1/tr.1
.SH SOURCE
.B \*9/src/cmd/tr.c
.SH "SEE ALSO"
-.IM sed (1)
+.MR sed (1)
blob - 4d047f4ff64a3a5d3c0a39a4d010970bcf5b1462
blob + 29d3e85cbc78492f221099a579a05569250d1ceb
--- man/man1/tr2post.1
+++ man/man1/tr2post.1
.I files
(or standard input),
which should be the device-independent output of
-.IM troff (1) ,
+.MR troff (1) ,
into the PostScript printer language.
.PP
The options are:
Using this option emits PostScript with invalid document structuring
comments.
It will print fine but will not view correctly in
-.IM gv (1)
+.MR gv (1)
or
.I psv
(see
-.IM page (1) ).
+.MR page (1) ).
.TP
.BI -o " pagelist
Print only the pages in the
.SH SOURCE
.B \*9/src/cmd/postscript/tr2post
.SH SEE ALSO
-.IM troff (1) ,
-.IM psfonts (1)
+.MR troff (1) ,
+.MR psfonts (1)
blob - acce30a73b3be1bfbc4605ff8c53b80fe38cc06c
blob + 032e8c70fbd47837569f62b6cb1aee10028686cc
--- man/man1/troff.1
+++ man/man1/troff.1
.SH SOURCE
.B \*9/src/cmd/troff
.SH "SEE ALSO"
-.IM lpr (1) ,
-.IM proof (1) ,
-.IM tr2post (1) ,
+.MR lpr (1) ,
+.MR proof (1) ,
+.MR tr2post (1) ,
.IR eqn (1),
.IR tbl (1),
.IR pic (1),
-.IM grap (1) ,
+.MR grap (1) ,
.IR doctype (1),
-.IM ms (7) ,
-.IM image (7) ,
-.IM tex (1) ,
-.IM deroff (1)
+.MR ms (7) ,
+.MR image (7) ,
+.MR tex (1) ,
+.MR deroff (1)
.br
J. F. Ossanna and B. W. Kernighan,
``Troff User's Manual''
blob - 98ea62a8f792158572be5227c764a76323af4cc2
blob + 06465e9b9b7f192e8ce00b2af2eeea0e26ac0e8c
--- man/man1/troff2html.1
+++ man/man1/troff2html.1
.SH DESCRIPTION
.I Troff2html
reads the
-.IM troff (1)
+.MR troff (1)
output in the named
.IR files ,
default standard input,
(see Plan 9's
.IR httpd (8)),
which converts
-.IM man (1)
+.MR man (1)
pages into HTML
and depends on a specially annotated set of
-.IM man (7)
+.MR man (7)
macros, invoked by
.B troff
.BR -manhtml .
.EE
.PP
which are used to create HTML hyperlinks around text of the form
-.IM cp (1)
+.MR cp (1)
pointing to
.BR /magic/man2html/1/cp .
.PP
On the one hand, because it uses the input,
.B ms2html
can handle
-.IM pic (1) ,
-.IM eqn (1) ,
+.MR pic (1) ,
+.MR eqn (1) ,
etc., which
.I troff2html
does not handle at all; on the other hand,
.B ms2html
understands only
-.IM ms (7)
+.MR ms (7)
documents and is easily confused by complex
.B troff
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
-.IM troff (1) ,
+.MR troff (1) ,
Plan 9's
.IR ms2html (1),
.I man2html
blob - 09b96af3741eaee4f15e38cbd100d4e1c441be81
blob + 773ec325e8782a0e7732972562b9115a46ab992e
--- man/man1/tweak.1
+++ man/man1/tweak.1
.B offset
to be applied to character values from the subfont
(typically as stored in a font file; see
-.IM font (7) );
+.MR font (7) );
and the subfont's
.BR n ,
.BR height ,
and
.B ascent
as defined in
-.IM cachechars (3) .
+.MR cachechars (3) .
.PP
By means described below, magnified views of portions of the images
may be displayed.
and
.BR width
as defined in
-.IM cachechars (3) ;
+.MR cachechars (3) ;
and
.BR iwidth ,
the physical width of the image in the subfont's image.
.SH SOURCE
.B \*9/src/cmd/draw/tweak.c
.SH "SEE ALSO"
-.IM cachechars (3) ,
-.IM image (7) ,
-.IM font (7)
+.MR cachechars (3) ,
+.MR image (7) ,
+.MR font (7)
.SH BUGS
For a program written to adjust width tables in fonts,
.I tweak
blob - 98e2cc7bbfb2d9f425fe811a3238496bc8270cd9
blob + 07629ea4e3126daf52289c0198dbbff22fbd740e
--- man/man1/uniq.1
+++ man/man1/uniq.1
.IR sort (1)
.SH BUGS
Field selection and comparison should be compatible with
-.IM sort (1) .
+.MR sort (1) .
blob - 489e677f2ea2276e560f7d7abedc9c21add7e91f
blob + 53f89b2ae123fff2572a24cee798b6613a68d887
--- man/man1/vac.1
+++ man/man1/vac.1
This option may be repeated multiple times.
.I Exclude
can be a shell pattern as accepted by
-.IM rc (1) ,
+.MR rc (1) ,
with one extension:
.B \&...
matches any sequence of characters including slashes.
.SH SOURCE
.B \*9/src/cmd/vac
.SH "SEE ALSO"
-.IM vacfs (4) ,
-.IM venti (8)
+.MR vacfs (4) ,
+.MR venti (8)
blob - 6231e40bae3a8e81672972c71a5129192150ded9
blob + b35b2ac17810fb6b15d9942f10f4e3ba2ef48f06
--- man/man1/venti.1
+++ man/man1/venti.1
.SH DESCRIPTION
Venti is a SHA1-addressed block storage server.
See
-.IM venti (7)
+.MR venti (7)
for a full introduction.
.PP
.I Read
.SH SOURCE
.B \*9/src/cmd/venti
.SH SEE ALSO
-.IM vac (1) ,
-.IM venti (3) ,
-.IM vacfs (4) ,
-.IM venti (7) ,
-.IM vbackup (8) ,
-.IM venti (8) ,
-.IM venti-fmt (8)
+.MR vac (1) ,
+.MR venti (3) ,
+.MR vacfs (4) ,
+.MR venti (7) ,
+.MR vbackup (8) ,
+.MR venti (8) ,
+.MR venti-fmt (8)
.SH BUGS
There should be programs to read and write
venti files and directories.
blob - 1abdcc009f8d0c8c49d4ceda34aacfefbf242880
blob + 0d57ad9f52c05a60cf361e70b0279d184ea546e2
--- man/man1/web.1
+++ man/man1/web.1
and
.I wmail
are invoked as start commands in the
-.IM plumber (4) 's
+.MR plumber (4) 's
rules for opening web pages and writing mail messages.
.SH FILES
.TP
.SH SOURCE
.B \*9/bin
.SH SEE ALSO
-.IM plumber (4)
+.MR plumber (4)
blob - 269db2e0e514d284d9d2594dffff3b97340ab346
blob + b7108e46210371822431f89242ab45ac8fea0802
--- man/man1/wintext.1
+++ man/man1/wintext.1
prints the text of the current
.I win
(see
-.IM acme (1) ),
-.IM 9term (1) ,
+.MR acme (1) ),
+.MR 9term (1) ,
or
(Unix's)
-.IM tmux (1)
+.MR tmux (1)
window to standard output.
.PP
.I \*y
prints the last command that
.I \*y
would print and then executes it by piping it into
-.IM rc (1) .
+.MR rc (1) .
.PP
Both
.I \*y
.BR # .
.SH EXAMPLES
Print the
-.IM ls (1)
+.MR ls (1)
and
.I lc
commands executed in this window:
%
.EE
.SH SEE ALSO
-.IM 9term (1) ,
-.IM acme (1)
+.MR 9term (1) ,
+.MR acme (1)
.SH SOURCE
.B \*9/bin
.SH BUGS
and
.I \*(yy
are hard to type in shells other than
-.IM rc (1) .
+.MR rc (1) .
.\" and in troff!
blob - fc4afbacf64dc260f57a3f8a516062699ba3a54d
blob + 98031fbc07239ead13bbacb6fc45d4eba4c925f6
--- man/man1/winwatch.1
+++ man/man1/winwatch.1
.SH DESCRIPTION
.I Winwatch
displays the labels of all current
-.IM rio (1)
+.MR rio (1)
windows, refreshing the display every second.
Right clicking a window's label unhides, raises and gives focus to that window.
Typing
.SH SOURCE
.B \*9/src/cmd/winwatch.c
.SH SEE ALSO
-.IM rio (1) ,
-.IM regexp (7) .
+.MR rio (1) ,
+.MR regexp (7) .
blob - d291210b4525fb34477c1033833e58168fd236ae
blob + 3a98d9365711b7e9305a44e04189b948b46a7446
--- man/man1/xd.1
+++ man/man1/xd.1
.SH SOURCE
.B \*9/src/cmd/xd.c
.SH "SEE ALSO"
-.IM db (1)
+.MR db (1)
.SH BUGS
The various output formats don't line up properly in the output of
.IR xd .
blob - 3fbd47c2dccffbab07457228fecf98cf62f687a5
blob + b291473f5f98d47981ce3bc9936acc81dcc5477f
--- man/man1/yacc.1
+++ man/man1/yacc.1
This program must be loaded with a lexical analyzer function,
.B yylex(void)
(often generated by
-.IM lex (1) ),
+.MR lex (1) ),
with a
.B main(int argc, char *argv[])
program, and with an error handling routine,
The parser accepts
.SM UTF
input text (see
-.IM utf (7) ),
+.MR utf (7) ),
which has a couple of effects.
First, the return value of
.B yylex()
.SH SOURCE
.B \*9/src/cmd/yacc.c
.SH "SEE ALSO"
-.IM lex (1)
+.MR lex (1)
.br
S. C. Johnson and R. Sethi,
``Yacc: A parser generator'',
blob - f18cf375676807efb3840893e00bb516c36c3892
blob + eae046e03dfe79fc9627d21a843695e1ac3b1d8e
--- man/man1/yesterday.1
+++ man/man1/yesterday.1
.SH SOURCE
.B \*9/bin/yesterday
.SH SEE ALSO
-.IM diff (1) ,
-.IM hist (1) ,
-.IM vbackup (8)
+.MR diff (1) ,
+.MR hist (1) ,
+.MR vbackup (8)
.SH BUGS
It's hard to use this command without singing.
blob - 0fe209c68706cb59fbaa2dd803f764706d986107
blob + fe75e7980222bdd6a96ec395c0964aeb9e74bc99
--- man/man3/0intro.3
+++ man/man3/0intro.3
which
libraries a program needs;
see
-.IM 9c (1) .
+.MR 9c (1) .
.PP
The library to which a function belongs is defined by the
header file that defines its interface.
plus macros that define the layout of
.IR jmp_buf
(see
-.IM setjmp (3) );
+.MR setjmp (3) );
.\" definitions of the bits in the floating-point control register
.\" as used by
.\" .IR getfcr (2);
or
.I create
(see
-.IM open (3) ).
+.MR open (3) ).
These calls return an integer called a
.IR "file descriptor"
which identifies the file
to subsequent I/O calls,
notably
-.IM read (3)
+.MR 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
-.IM dup (3) .
+.MR 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
-.IM thread (3) ),
+.MR thread (3) ),
the file descriptor table is shared by all the procs.
.PP
By convention,
The I/O position in the file is called the
.IR "file offset"
and may be set arbitrarily using the
-.IM seek (3)
+.MR seek (3)
system call.
.PP
Directories may be opened like regular files.
Instead of reading them with
-.IM read (3) ,
+.MR read (3) ,
use the
.B Dir
structure-based
routines described in
-.IM dirread (3) .
+.MR dirread (3) .
The entry
corresponding to an arbitrary file can be retrieved by
.IR dirstat
(see
-.IM stat (3) )
+.MR stat (3) )
or
.IR dirfstat ;
.I dirwstat
New files are made with
.I create
(see
-.IM open (3) )
+.MR open (3) )
and deleted with
-.IM remove (3) .
+.MR remove (3) .
Directories may not directly be written;
.IR create ,
.IR remove ,
.I fwstat
alter them.
.PP
-.IM Pipe (3)
+.MR 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
-.IM fork (2) .
+.MR 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;
-.IM exec (3)
+.MR 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
-.IM chdir (2) ).
+.MR chdir (2) ).
.PP
Each process has a set of attributes \(em memory, open files,
name space, etc. \(em that may be shared or unique.
control the sharing of these attributes.
.PP
A process terminates by calling
-.IM exits (3) .
+.MR exits (3) .
A parent process may call
-.IM wait (3)
+.MR wait (3)
to wait for some child to terminate.
A bit of status information
may be passed from
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
-.IM sleep (3) .
+.MR 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
-.IM notify (3)
+.MR notify (3)
to register the function to be called (the
.IR "notification handler" )
when such events occur.
.IR malloc ,
.IR print ,
and the other routines use locks (see
-.IM lock (3) )
+.MR lock (3) )
to synchronize access to their data structures.
The graphics library defined in
.B <draw.h>
is also multi-process capable; details are in
-.IM graphics (3) .
+.MR graphics (3) .
In general, though, multiprocess programs should use some form of synchronization
to protect shared data.
.PP
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
-.IM ioproc (3)
+.MR ioproc (3)
or
-.IM mouse (3) .
+.MR mouse (3) .
.SH SEE ALSO
.IR nm (1),
-.IM 9c (1)
+.MR 9c (1)
.SH DIAGNOSTICS
Math functions in
.I libc
special values when the function is undefined for the
given arguments or when the value is not representable
(see
-.IM nan (3) ).
+.MR 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;
-.IM errstr (3)
+.MR errstr (3)
recovers a string describing the error.
Some user-level library functions also use the
.I errstr
blob - 804f6332cf093b0dbf26592f18dd498cff4cd0e1
blob + 4ba3b6c81e0a51456506c0496ed9990e9bfe95eb
--- man/man3/9p-cmdbuf.3
+++ man/man3/9p-cmdbuf.3
using
.I tokenize
(see
-.IM getfields (3) ).
+.MR getfields (3) ).
It returns a
.B Cmdbuf
structure holding pointers to each field in the message.
.SH SOURCE
.B \*9/src/lib9p/parse.c
.SH SEE ALSO
-.IM 9p (3)
+.MR 9p (3)
blob - b87ea2538edb817de754ec19402b96a0af24aa0d
blob + 239f58ce00a65b20542ae708442d6e53dfbd8ed0
--- man/man3/9p-fid.3
+++ man/man3/9p-fid.3
.BR Reqpool s.
They are primarily used by the 9P server loop
described in
-.IM 9p (3) .
+.MR 9p (3) .
.PP
.B Fid
structures are intended to represent
.B File
structure
(see
-.IM 9p-file (3) )
+.MR 9p-file (3) )
corresponding to the fid.
The
.B aux
.SH SOURCE
.B \*9/src/lib9p
.SH SEE ALSO
-.IM 9p (3) ,
-.IM 9p-file (3)
+.MR 9p (3) ,
+.MR 9p-file (3)
blob - 52c19bfdf8240d7d9b77769ee34c9240d568db67
blob + e849f71347bac7955b9dfa7139b1acdcf7c932f5
--- man/man3/9p-file.3
+++ man/man3/9p-file.3
call
.I incref
(see
-.IM lock (3) )
+.MR lock (3) )
to update the reference count.
To note the removal of a reference to a file, call
.IR closefile .
.SH SOURCE
.B \*9/src/lib9p/file.c
.SH SEE ALSO
-.IM 9p (3)
+.MR 9p (3)
.SH BUGS
The reference counting is cumbersome.
blob - 7e7db303f1c9bd8f3dbd72e6c28d9e92e4a54b1d
blob + 486e1826095478400031f8e3f407974d328acbd8
--- man/man3/9p-intmap.3
+++ man/man3/9p-intmap.3
.SH SOURCE
.B \*9/src/lib9p/intmap.c
.SH SEE ALSO
-.IM 9p (3) ,
-.IM 9p-fid (3)
+.MR 9p (3) ,
+.MR 9p-fid (3)
blob - eac5a3d60fe767afee55315531da68e5262c169d
blob + adf10269110a5147d3e9e47d72eb1d8832c9a9cc
--- man/man3/9p.3
+++ man/man3/9p.3
.B Fid
structures are allocated one-to-one with uncompleted
requests and active fids, and are described in
-.IM 9p-fid (3) .
+.MR 9p-fid (3) .
.PP
The behavior of
.I srv
depends on whether there is a file tree
(see
-.IM 9p-file (3) )
+.MR 9p-file (3) )
associated with the server, that is,
whether the
.B tree
.BI /srv/ name .
.IP
Fork a child process via
-.IM rfork (3)
+.MR rfork (3)
or
.I procrfork
(see
-.IM thread (3) ),
+.MR thread (3) ),
using the
.BR RFFDG ,
.RR RFNOTEG ,
.LP
If any error occurs during
this process, the entire process is terminated by calling
-.IM sysfatal (3) .
+.MR sysfatal (3) .
.SS Service functions
The functions in a
.B Srv
is the program name variable as set by
.I ARGBEGIN
(see
-.IM arg (3) ).
+.MR arg (3) ).
.TP
.I Attach
The
from its caller) terminates using
.I _exits
(see
-.IM exits (3) ).
+.MR exits (3) ).
.PD
.PP
If the
.SH SOURCE
.B \*9/src/lib9p
.SH SEE ALSO
-.IM 9p-fid (3) ,
-.IM 9p-file (3) ,
+.MR 9p-fid (3) ,
+.MR 9p-file (3) ,
.IR intro (9p)
blob - a4c80d8bea332abcebe06a6d6a7f32673efaeabf
blob + 74537ab40c2b290db114bd258dbde9ea1b3a1c2d
--- man/man3/9pclient.3
+++ man/man3/9pclient.3
.I name
in the current name space directory
(see
-.IM intro (4) ).
+.MR intro (4) ).
Both attach to the root of the file system
using the attach name
.IR aname .
file descriptor corresponding to the connection
will be closed
(see
-.IM close (2) ).
+.MR close (2) ).
Fids are not reference counted: when
.I fsclose
is called, the clunk transaction and freeing of storage
and
.I type
arguments are used as in
-.IM seek (3) .
+.MR seek (3) .
Calling
.I fspread
or
.PP
.I Fsaccess
behaves like Unix's
-.IM access (2) .
+.MR access (2) .
.I Fsremove
removes the named path.
.I Fsfremove
and
.I vfprint
(see
-.IM print (3) )
+.MR print (3) )
but write to
.BR CFid* s.
.PP
The returned pointer should be freed with
.I free
(see
-.IM malloc (3) )
+.MR malloc (3) )
when no longer needed.
.PP
.I Fsdirfstat
should be freed with
.I free
(see
-.IM malloc (3) )
+.MR malloc (3) )
when no longer needed.
.PP
.I Fsdirstat
for reading or writing but returns a Unix file descriptor
instead of a fid structure.
The file descriptor is actually one end of a
-.IM pipe (2) .
+.MR 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,
flag is set, the library calls
.I threadexitsall
(see
-.IM thread (3) )
+.MR thread (3) )
when it detects EOF on a 9P connection.
.SH SOURCE
.B \*9/src/lib9pclient
.SH SEE ALSO
-.IM intro (4) ,
+.MR intro (4) ,
.IR intro (9p),
.I fsaopen
and
.I nsaopen
in
-.IM auth (3)
+.MR auth (3)
.SH BUGS
The implementation
should use a special version string to distinguish between
blob - d2f116ae691aa1564e4c783bcba1ba06cb6732d8
blob + 7c4ac67a7244e9448e102941606a12863de3d42e
--- man/man3/acme.3
+++ man/man3/acme.3
.SH DESCRIPTION
.I Libacme
provides a simple C interface for interacting with
-.IM acme (1)
+.MR acme (1)
windows.
.PP
A
.I acme
directory.
See
-.IM acme (4)
+.MR acme (4)
for details.
Many library routines take a format string
.I fmt
using
.I smprint
(see
-.IM print (3) ).
+.MR print (3) ).
.PP
.I Pipetowin
runs the
-.IM rc (1)
+.MR rc (1)
command line
.I fmt\fR, \fP...
with
.PP
.I Pipewinto
runs the
-.IM rc (1)
+.MR rc (1)
command line
.I fmt\fR, \fP...
with the window's
relative to
.I type
(see
-.IM seek (3) ).
+.MR seek (3) ).
.PP
.I Winwrite
writes the
.IR acme 's
event messages.
See
-.IM acme (4)
+.MR acme (4)
for detailed explanations.
The fields are:
.TP
returns a pointer to a
.B Channel
(see
-.IM thread (3) )
+.MR thread (3) )
on which event structures (not pointers) can be read.
The first call to
.I wineventchan
and
.I evsmprint
are like
-.IM malloc (3) ,
+.MR malloc (3) ,
.IR realloc ,
.IR strdup
(see
-.IM strcat (3) ),
+.MR strcat (3) ),
and
.IR vsmprint
(see
-.IM print (3) ),
+.MR print (3) ),
but they call
-.IM sysfatal (3)
+.MR sysfatal (3)
on error rather than returning nil.
.SH SOURCE
.B \*9/src/libacme
.SH SEE ALSO
-.IM acme (1) ,
-.IM acme (4)
+.MR acme (1) ,
+.MR acme (4)
blob - 5a22abeb3a4ac11836fdcb0339e44a6841079976
blob + 74d19634b67caa84471c54e0c0ad3d1bce1de4fd
--- man/man3/addpt.3
+++ man/man3/addpt.3
.SH SOURCE
.B \*9/src/libdraw
.SH SEE ALSO
-.IM graphics (3)
+.MR graphics (3)
blob - c9c74155bfc41f5f89eb941c7bed292e4937b3e2
blob + 94ff54a704fcb6af0b3a82706c4f72521eb975ee
--- man/man3/aes.3
+++ man/man3/aes.3
.SH SOURCE
.B \*9/src/libsec
.SH SEE ALSO
-.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)
+.MR mp (3) ,
+.MR blowfish (3) ,
+.MR des (3) ,
+.MR dsa (3) ,
+.MR elgamal (3) ,
+.MR rc4 (3) ,
+.MR rsa (3) ,
+.MR sechash (3) ,
+.MR prime (3) ,
+.MR rand (3)
blob - 72ee805e603cb5c729a7a515bb9ff3ce4c776997
blob + 518d6b327e748823b5bc283c54b657551450f26d
--- man/man3/allocimage.3
+++ man/man3/allocimage.3
field will have been set to the identifying number used by
.B /dev/draw
(see
-.IM draw (3) ),
+.MR draw (3) ),
and the
.I cache
field will be zero.
field will be set to the number of bits per pixel specified
by the channel descriptor
(see
-.IM image (7) ).
+.MR image (7) ).
.I Allocimage
returns 0 if the server has run out of image memory.
.PP
for example they provide the mechanism behind
.B getwindow
(see
-.IM graphics (3) ).
+.MR graphics (3) ).
.PP
The RGB values in a color are
.I premultiplied
There is a fixed format for the exchange and storage of
image data
(see
-.IM image (7) ).
+.MR image (7) ).
.PP
.I Unloadimage
reads a rectangle of pixels from image
bytes of compressed image
.I data
(see
-.IM image (7) ).
+.MR image (7) ).
On each call to
.IR cloadimage,
the
.PP
.I Readimage
creates an image from data contained in an external file (see
-.IM image (7)
+.MR image (7)
for the file format);
.I fd
is a file descriptor obtained by opening such a file for reading.
.SH SOURCE
.B \*9/src/libdraw
.SH "SEE ALSO"
-.IM graphics (3) ,
-.IM draw (3) ,
-.IM draw (3) ,
-.IM image (7)
+.MR graphics (3) ,
+.MR draw (3) ,
+.MR draw (3) ,
+.MR image (7)
.SH DIAGNOSTICS
These functions return pointer 0 or integer \-1 on failure, usually due to insufficient
memory.
blob - 1d6dbab1584e3f882a711248f749f55a13d85539
blob + d9aa812ff5a958492b15e04b39d4992372ca13c4
--- man/man3/arg.3
+++ man/man3/arg.3
and
.I argv
are in scope; see
-.IM exec (3) .
+.MR exec (3) .
.I ARGBEGIN
and
.I ARGEND
runs
.I code
and, if that returns, calls
-.IM abort (3) .
+.MR abort (3) .
A typical value for
.I code
is
blob - 198cce35fee755de467b4f59aac4b2faec4202f5
blob + 039df33ecbdfcfd28074c3746cf72150785e6e27
--- man/man3/arith3.3
+++ man/man3/arith3.3
.SH SOURCE
.B \*9/src/libgeometry
.SH "SEE ALSO
-.IM matrix (3)
+.MR matrix (3)
blob - ce2ca723e70502c568a530f64a6f70ef3671d0d8
blob + 8b462aa9d22dcee921a5830ab2a6c0ae2b0ecba8
--- man/man3/atof.3
+++ man/man3/atof.3
.SH SOURCE
.B \*9/src/lib9
.SH SEE ALSO
-.IM fscanf (3)
+.MR fscanf (3)
.SH DIAGNOSTICS
Zero is returned if the beginning of the input string is not
interpretable as a number; even in this case,
and
.IR p9atoll ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 747b9555d2adbe7836567768df0263418cab332c
blob + 9fda7de355a503d2dd0778067b29542401c44119
--- man/man3/auth.3
+++ man/man3/auth.3
.SH DESCRIPTION
.PP
This library, in concert with
-.IM factotum (4) ,
+.MR factotum (4) ,
is used to authenticate users.
It provides the primary interface to
.IR factotum .
The following routines use the
.B AuthInfo
structure returned after a successful authentication by
-.IM factotum (4) .
+.MR factotum (4) .
.PP
.ne 8
.EX
An
.B sprint
(see
-.IM print (3) )
+.MR print (3) )
of
.I fmt
and the variable arg list yields a key template (see
-.IM factotum (4) )
+.MR factotum (4) )
specifying the key to use.
The template must specify at least the protocol (
.BI proto= xxx )
either by opening
.B /mnt/factotum/rpc
or by using
-.IM 9pclient (3)
+.MR 9pclient (3)
to connect to a
.B factotum
service posted in the current name space.
is freed using
.IR auth_freerpc .
Individual commands can be sent to
-.IM factotum (4)
+.MR factotum (4)
by invoking
.IR auth_rpc .
.PP
but execute the protocol on a
.B CFid*
(see
-.IM 9pclient (3) )
+.MR 9pclient (3) )
instead of a file descriptor.
.PP
.I Fsamount
and
.I nsmount
(see
-.IM 9pclient (3) )
+.MR 9pclient (3) )
but use
.I factotum
to authenticate to the file servers.
.SH SOURCE
.B \*9/src/libauth
.SH SEE ALSO
-.IM factotum (4) ,
-.IM authsrv (3)
+.MR factotum (4) ,
+.MR authsrv (3)
.SH DIAGNOSTICS
These routines set
.IR errstr .
blob - 2b2113bc287f205eb3c6b1fc7f61dcd3e4d373ae
blob + e1ace0c4ce157ddc84d2ae76d26945489df88a09
--- man/man3/authsrv.3
+++ man/man3/authsrv.3
is non-nil,
the network database
(see
-.IM ndb (1) )
+.MR ndb (1) )
is queried for an entry which contains
.B authdom=\fIad\fP
or
.SH SOURCE
.B \*9/src/libauthsrv
.SH SEE ALSO
-.IM passwd (1) ,
-.IM dial (3) ,
+.MR passwd (1) ,
+.MR dial (3) ,
Plan 9's
.IR authsrv (6).
.SH DIAGNOSTICS
blob - 3ab9ba90c5a5211ff682a271bdaa673ac8d6183e
blob + e8685494380f345adeb4a347f4a20b82036c7b5a
--- man/man3/bin.3
+++ man/man3/bin.3
and
.I bingrow
allocate large chunks of memory using
-.IM malloc (3)
+.MR malloc (3)
and return pieces of these chunks.
The chunks are
.IR free 'd
.SH SOURCE
.B \*9/src/libbin
.SH SEE ALSO
-.IM malloc (3)
+.MR malloc (3)
.SH DIAGNOSTICS
.I binalloc
and
blob - 1f7b822129de603b33e7e6801b1977fbdedd21a9
blob + 05721f8b378935341c22ede7c318a905ba1c20ed
--- man/man3/bio.3
+++ man/man3/bio.3
or creates for mode
.BR OWRITE .
It calls
-.IM malloc (3)
+.MR malloc (3)
to allocate a buffer.
.PP
.I Bfdopen
or
.BR OWRITE .
It calls
-.IM malloc (3)
+.MR malloc (3)
to allocate a buffer.
.PP
.I Binit
.PP
.I Brdstr
returns a
-.IM malloc (3) -allocated
+.MR malloc (3) -allocated
buffer containing the next line of input delimited by
.IR delim ,
terminated by a NUL (0) byte.
uses
.I charstod
(see
-.IM atof (3) )
+.MR atof (3) )
and
.I Bgetc
to read the formatted
.PP
.I Bseek
applies
-.IM seek (3)
+.MR seek (3)
to
.IR bp .
It returns the new file offset.
.PP
.I Bprint
is a buffered interface to
-.IM print (3) .
+.MR print (3) .
If this causes a
.IR write
to occur and there is an error,
.SH SOURCE
.B \*9/src/libbio
.SH SEE ALSO
-.IM open (3) ,
-.IM print (3) ,
-.IM exits (3) ,
-.IM utf (7) ,
+.MR open (3) ,
+.MR print (3) ,
+.MR exits (3) ,
+.MR utf (7) ,
.SH DIAGNOSTICS
.I Bio
routines that return integers yield
blob - 2ae83f4d37cd10a92d07240f4c70aba602bb70c2
blob + 95d77507282c25d4ef61688951b47db7ae714a9a
--- man/man3/blowfish.3
+++ man/man3/blowfish.3
.SH SOURCE
.B \*9/src/libsec
.SH SEE ALSO
-.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)
+.MR mp (3) ,
+.MR aes (3) ,
+.MR des (3) ,
+.MR dsa (3) ,
+.MR elgamal (3) ,
+.MR rc4 (3) ,
+.MR rsa (3) ,
+.MR sechash (3) ,
+.MR prime (3) ,
+.MR rand (3)
blob - 95b172e924087272f3cebb96b70fd08d3e722249
blob + 1b2cc5b066550a33f4e4e6081fc86ccfa7c485f3
--- man/man3/cachechars.3
+++ man/man3/cachechars.3
may contain too many characters to hold in memory
simultaneously.
The graphics library and draw device (see
-.IM draw (3) )
+.MR 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:
.B Font
consists of an overall height and ascent
and a collection of subfonts together with the ranges of runes (see
-.IM utf (7) )
+.MR utf (7) )
they represent.
Fonts are described by the following structures.
.IP
and
.LR ascent
fields of Font are described in
-.IM graphics (3) .
+.MR graphics (3) .
.L Sub
contains
.L nsub
.SH SOURCE
.B \*9/src/libdraw
.SH SEE ALSO
-.IM graphics (3) ,
-.IM allocimage (3) ,
-.IM draw (3) ,
-.IM subfont (3) ,
-.IM image (7) ,
-.IM font (7)
+.MR graphics (3) ,
+.MR allocimage (3) ,
+.MR draw (3) ,
+.MR subfont (3) ,
+.MR image (7) ,
+.MR font (7)
.SH DIAGNOSTICS
All of the functions use the graphics error function (see
-.IM graphics (3) ).
+.MR graphics (3) ).
blob - 8486cd90fd4a665daad1f5d3bc9cc00e35166f8a
blob + 75fdd80589825bd10007e4f4c8c83138e0b27fdc
--- man/man3/cleanname.3
+++ man/man3/cleanname.3
.SH SOURCE
.B \*9/src/lib9/cleanname.c
.SH SEE ALSO
-.IM cleanname (1)
+.MR cleanname (1)
blob - 0c1b88213e8c0a10d9b370a6e521dd59ee5012c2
blob + e08d91949cf094b6b274838712a1af12176949e1
--- man/man3/color.3
+++ man/man3/color.3
.SH DESCRIPTION
These routines convert between `true color' red/green/blue triples and the Plan 9 color map.
See
-.IM color (7)
+.MR color (7)
for a description of RGBV, the standard color map.
.PP
.I Rgb2cmap
.I cmap2rgba
shifted up 8 bits.
This 32-bit representation is the format used by
-.IM draw (3)
+.MR draw (3)
and
-.IM memdraw (3)
+.MR memdraw (3)
library routines that
take colors as arguments.
.SH SOURCE
.B \*9/src/libdraw
.SH SEE ALSO
-.IM graphics (3) ,
-.IM allocimage (3) ,
-.IM draw (3) ,
-.IM image (7) ,
-.IM color (7)
+.MR graphics (3) ,
+.MR allocimage (3) ,
+.MR draw (3) ,
+.MR image (7) ,
+.MR color (7)
blob - b0f9fcea8620c4ecfec3ffa236eb0c5b54b235ec
blob + f1d0c28031c8ff6e9c2dd7331d68e210aaaf4e91
--- man/man3/complete.3
+++ man/man3/complete.3
structure and its contents.
.PP
In
-.IM rio (1)
+.MR rio (1)
and
-.IM acme (1) ,
+.MR 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
-.IM rio (1) ,
-.IM acme (1)
+.MR rio (1) ,
+.MR acme (1)
.SH DIAGNOSTICS
The
.I complete
blob - db6591343a276180685f2a461fb1f93061b8f0f6
blob + 5d80d4118495f46db9e01c127f9617d165db0eec
--- man/man3/ctime.3
+++ man/man3/ctime.3
converts a time
.I clock
such as returned by
-.IM time (3)
+.MR time (3)
into
.SM ASCII
(sic)
.br
.B \*9/src/lib9/tm2sec.c
.SH "SEE ALSO"
-.IM date (1) ,
-.IM time (3)
+.MR date (1) ,
+.MR time (3)
.SH BUGS
The return values point to static data
whose content is overwritten by each call.
and
.IR p9tm2sec ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 5381f2e378dba48a4151dc941410b07b186a38e6
blob + 686fc4c9e79725eab42da3c855a7e9f0f7987678
--- man/man3/des.3
+++ man/man3/des.3
.SH SOURCE
.B \*9/src/libsec
.SH SEE ALSO
-.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)
+.MR mp (3) ,
+.MR aes (3) ,
+.MR blowfish (3) ,
+.MR dsa (3) ,
+.MR elgamal (3) ,
+.MR rc4 (3) ,
+.MR rsa (3) ,
+.MR sechash (3) ,
+.MR prime (3) ,
+.MR rand (3)
blob - f34b1c54d37a84fff303d752f68105bc86721cd3
blob + 24efc702372b3030e707cac4ce33274884250248
--- man/man3/dial.3
+++ man/man3/dial.3
.EE
.PP
Connect to a Unix socket served by
-.IM acme (4) :
+.MR acme (4) :
.IP
.EX
int dialacme(void)
.IR p9announce ,
and so on;
see
-.IM intro (3) .
+.MR intro (3) .
blob - b0386a23a32b326acdad0d3beb30d1d3f780a27a
blob + cce8d97856ea3d1bbe86d4462fd0ca7631042e7b
--- man/man3/dirread.3
+++ man/man3/dirread.3
#define DIRMAX (sizeof(Dir)+STATMAX)
.SH DESCRIPTION
The data returned by a
-.IM read (3)
+.MR read (3)
on a directory is a set of complete directory entries
in a machine-independent format, exactly equivalent to
the result of a
-.IM stat (3)
+.MR stat (3)
on each file or subdirectory in the directory.
.I Dirread
decodes the directory entries into a machine-dependent form.
whose address is returned in
.B *buf
(see
-.IM stat (3)
+.MR stat (3)
for the layout of a
.BR Dir ).
The array is allocated with
-.IM malloc (3)
+.MR malloc (3)
each time
.I dirread
is called.
but reads in the entire directory; by contrast,
.I dirread
steps through a directory one
-.IM read (3)
+.MR read (3)
at a time.
.PP
Directory entries have variable length.
.SH SOURCE
.B \*9/src/lib9/dirread.c
.SH SEE ALSO
-.IM intro (3) ,
-.IM open (3) ,
-.IM read (3)
+.MR intro (3) ,
+.MR open (3) ,
+.MR read (3)
.SH DIAGNOSTICS
.I Dirread
and
blob - c91ab541fc62f68467b15a6a5e8e23d188200194
blob + 4ad680b3362d9020248f5e1e526ce5162b3850b8
--- man/man3/draw.3
+++ man/man3/draw.3
.TP
.B chan
The pixel channel format descriptor, as described in
-.IM image (7) .
+.MR image (7) .
The value should not be modified after the image is created.
.TP
.B depth
it is identically
.B chantodepth(chan)
(see
-.IM graphics (3) )
+.MR graphics (3) )
and is provided as a convenience.
The value should not be modified after the image is created.
.TP
is to
.B atan
(see
-.IM sin (3) ).
+.MR sin (3) ).
.TP
.BI border( dst\fP,\fP\ r\fP,\fP\ i\fP,\fP\ color\fP,\fP\ sp\fP)
.I Border
.SH SOURCE
.B \*9/src/libdraw
.SH SEE ALSO
-.IM graphics (3) ,
-.IM stringsize (3) ,
-.IM color (7) ,
-.IM utf (7) ,
-.IM addpt (3)
+.MR graphics (3) ,
+.MR stringsize (3) ,
+.MR color (7) ,
+.MR utf (7) ,
+.MR addpt (3)
.PP
T. Porter, T. Duff.
``Compositing Digital Images'',
blob - ecdc272ae0f81b1fe5e094390bbb053044ccaa1c
blob + 1ee37cd8cdab206247417227bc5d06e3f2328499
--- man/man3/drawfcall.3
+++ man/man3/drawfcall.3
uint sizeW2M(Wsysmsg *w)
.SH DESCRIPTION
These routines are analogues of the routines described in
-.IM fcall (3) .
+.MR fcall (3) .
They manipulate graphics device protocol messages
rather than 9P protocol messages.
The graphics device protocol is used for internal
communication between the
-.IM devdraw (1)
+.MR devdraw (1)
graphics server
and the
-.IM draw (3)
+.MR draw (3)
library.
A
.B Wsysmsg
.SH SOURCE
.B \*9/src/libdraw/drawfcall.c
.SH SEE ALSO
-.IM devdraw (1) ,
-.IM draw (3) ,
-.IM graphics (3)
+.MR devdraw (1) ,
+.MR draw (3) ,
+.MR graphics (3)
blob - 0a3c34a12a4f525869ece192987e20bbce011c0e
blob + 7871401011edd6f1a4b0199e56791e83be337978
--- man/man3/dsa.3
+++ man/man3/dsa.3
generated by
.IR DSAprimes
(see
-.IM prime (3) ).
+.MR prime (3) ).
Otherwise,
.B p
and
converts an ASN1 formatted DSA private key into the corresponding
.B DSApriv
structure; see
-.IM rsa (3)
+.MR rsa (3)
for other ASN1 routines.
.SH SOURCE
.B \*9/src/libsec
.SH SEE ALSO
-.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)
+.MR mp (3) ,
+.MR aes (3) ,
+.MR blowfish (3) ,
+.MR des (3) ,
+.MR rc4 (3) ,
+.MR rsa (3) ,
+.MR sechash (3) ,
+.MR prime (3) ,
+.MR rand (3)
blob - e313c06821205cf5d3db14ccb3d7381fe482a1be
blob + 26887363060e0a8f831b24ad67da665a8db5ee8e
--- man/man3/dup.3
+++ man/man3/dup.3
is a preprocessor macro defined as
.IR p9dup ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 9fe4e69872676d5ff6b04a18294857512ba43e21
blob + af4bc03b64e5e00a4fd833379ad0c816a2d3bc57
--- man/man3/elgamal.3
+++ man/man3/elgamal.3
.SH SOURCE
.B \*9/src/libsec
.SH SEE ALSO
-.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)
+.MR mp (3) ,
+.MR aes (3) ,
+.MR blowfish (3) ,
+.MR des (3) ,
+.MR dsa (3) ,
+.MR rc4 (3) ,
+.MR rsa (3) ,
+.MR sechash (3) ,
+.MR prime (3) ,
+.MR rand (3)
blob - e3a94860d9394881535fea1a5822b6d1c17de3b6
blob + 57b5cd08116c0e35932bd02ad734cb0debce78b7
--- man/man3/encode.3
+++ man/man3/encode.3
.PP
.I Encodefmt
can be used with
-.IM fmtinstall (3)
+.MR fmtinstall (3)
and
-.IM print (3)
+.MR print (3)
to print encoded representations of byte arrays.
The verbs are
.TP
blob - 70ff003ed93a1be9e5a6848b496795ba1841dfcc
blob + 894020d8708aa9361e4997b361a104744c09519c
--- man/man3/encrypt.3
+++ man/man3/encrypt.3
and
.IR p9decrypt ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 5bc7bf091990dd8c2a68fc471387749c75eb039d
blob + 703f2ee083a38f667dfbd905ebba2d9d17e3001a
--- man/man3/errstr.3
+++ man/man3/errstr.3
The verb
.B r
in
-.IM print (3)
+.MR print (3)
calls
.I errstr
and outputs the error string.
.I Errstr
always returns 0.
.SH SEE ALSO
-.IM intro (3) ,
-.IM perror (3)
+.MR intro (3) ,
+.MR perror (3)
.SH BUGS
The implementation sets
.I errno
.I errno
is set to other values, the error string
is synthesized using
-.IM strerror (3) .
+.MR strerror (3) .
blob - 56ddeb34656932122b8153907be3ff5689981ce7
blob + f76e5ea273562c810ed9bc5c37e41075e126f1b1
--- man/man3/event.3
+++ man/man3/event.3
These routines provide an interface to multiple sources of input for unthreaded
programs.
Threaded programs (see
-.IM thread (3) )
+.MR thread (3) )
should instead use the threaded mouse and keyboard interface described
in
-.IM mouse (3)
+.MR mouse (3)
and
-.IM keyboard (3) .
+.MR keyboard (3) .
.PP
.I Einit
must be called first.
in this case,
.IR initdraw
(see
-.IM graphics (3) )
+.MR graphics (3) )
must have already been called.
The user must provide a function called
.IR eresized
is a flag specifying whether the program must call
.I getwindow
(see
-.IM graphics (3) )
+.MR graphics (3) )
to re-establish a connection to its window.
After resizing (and perhaps calling
.IR getwindow ),
.IR eread .
.PP
As described in
-.IM graphics (3) ,
+.MR graphics (3) ,
the graphics functions are buffered.
.IR Event ,
.IR eread ,
.B Cursor
.I c
(see
-.IM mouse (3) ).
+.MR mouse (3) ).
If
.B c
is nil, it restores the image to the default arrow.
.SH SOURCE
.B \*9/src/libdraw
.SH "SEE ALSO"
-.IM rio (1) ,
-.IM graphics (3) ,
-.IM plumb (3) ,
+.MR rio (1) ,
+.MR graphics (3) ,
+.MR plumb (3) ,
.\" .IR cons (3),
-.IM draw (3)
+.MR draw (3)
blob - cc921dbddc14dfac5eab58a0fde19bed16ab889d
blob + 51096cc91fd354323d743fc7ccf3927e5dde806c
--- man/man3/exec.3
+++ man/man3/exec.3
to be executed; it must not be a directory, and the permissions
must allow the current user to execute it
(see
-.IM stat (3) ).
+.MR stat (3) ).
It should also be a valid binary image, as defined by the local
operating system, or a shell script
(see
-.IM rc (1) ).
+.MR rc (1) ).
The first line of a
shell script must begin with
.L #!
.B OCEXEC
OR'd
into the open mode; see
-.IM open (3) );
+.MR open (3) );
and the working directory and environment
(see
-.IM getenv (3) )
+.MR getenv (3) )
remain the same.
However, a newly
.I exec'ed
process has no notification handlers
(see
-.IM notify (3) ).
+.MR notify (3) ).
.SH SOURCE
.B \*9/src/lib9/exec.c
.br
.B \*9/src/lib9/execl.c
.SH SEE ALSO
-.IM prof (1) ,
-.IM intro (3) ,
-.IM stat (3)
+.MR prof (1) ,
+.MR intro (3) ,
+.MR stat (3)
.SH DIAGNOSTICS
If these functions fail, they return and set
.IR errstr .
and
.IR p9execl ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - c1d47ea8752734581e1fe06d13d755761f1403a3
blob + 2f4b1f4fc68f522e034fe489621bbbb485af5714
--- man/man3/exits.3
+++ man/man3/exits.3
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
-.IM wait (3) .
+.MR wait (3) .
.PP
Before calling
.I _exits
.br
.B \*9/src/lib9/_exits.c
.SH "SEE ALSO"
-.IM fork (2) ,
-.IM wait (3)
+.MR fork (2) ,
+.MR wait (3)
.SH BUGS
Because of limitations of Unix, the exit status of a
process can only be an 8-bit integer.
and
.IR p9atexitdont ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 6dc4bf5ccca91e50ad1c313ae9275512969bf8a2
blob + 5e9bd19582b222c1fe58520dac84fc0ee334b0d1
--- man/man3/fcall.3
+++ man/man3/fcall.3
Another structure is
.BR Dir ,
used by the routines described in
-.IM stat (3) .
+.MR stat (3) .
.I ConvM2D
converts the machine-independent form starting at
.I ap
entry suitable as an argument, for example, for the
.B wstat
(see
-.IM stat (3) )
+.MR stat (3) )
system call.
It checks that the sizes of all the elements of the the entry sum to exactly
.IR nbuf ,
and
.I dirmodefmt
are formatting routines, suitable for
-.IM fmtinstall (3) .
+.MR fmtinstall (3) .
They convert
.BR Dir* ,
.BR Fcall* ,
.PP
.I Read9pmsg
calls
-.IM read (3)
+.MR 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
.SH SOURCE
.B \*9/src/lib9
.SH SEE ALSO
-.IM intro (3) ,
-.IM 9p (3) ,
-.IM stat (3) ,
+.MR intro (3) ,
+.MR 9p (3) ,
+.MR stat (3) ,
.IR intro (9p)
blob - cd90c1f2ad09d9688fcd761b2e03df580609e399
blob + 81f82dcf3bf3daddf1943b59a849d21c868df9df
--- man/man3/flate.3
+++ man/man3/flate.3
.I Mkcrctab
allocates
(using
-.IM malloc (3) ),
+.MR malloc (3) ),
initializes, and returns a table for rapid computation of 32 bit CRC values using the polynomial
.IR poly .
.I Blockcrc
blob - 93bded76160220c83cf8d012152c17e15ce21531
blob + b68cd008cd7925a3e2bfbf330767d698dec7e203
--- man/man3/fmtinstall.3
+++ man/man3/fmtinstall.3
int errfmt(Fmt *f);
.SH DESCRIPTION
The interface described here allows the construction of custom
-.IM print (3)
+.MR print (3)
verbs and output routines.
In essence, they provide access to the workings of the formatted print code.
.PP
The
-.IM print (3)
+.MR print (3)
suite maintains its state with a data structure called
.BR Fmt .
A typical call to
-.IM print (3)
+.MR print (3)
or its relatives initializes a
.B Fmt
structure, passes it to subsidiary routines to process the output,
These behave like
.B fprint
(see
-.IM print (3) )
+.MR print (3) )
or
.B vfprint
except that the characters are buffered until
are the width and precision, and
.IB fp ->flags
the decoded flags for the verb (see
-.IM print (3)
+.MR print (3)
for a description of these items).
The standard flag values are:
.B FmtSign
.PP
Some internal functions may be useful to format primitive types.
They honor the width, precision and flags as described in
-.IM print (3) .
+.MR print (3) .
.I Fmtrune
formats a single character
.BR r .
This function prints an error message with a variable
number of arguments and then quits.
Compared to the corresponding example in
-.IM print (3) ,
+.MR print (3) ,
this version uses a smaller buffer, will never truncate
the output message, but might generate multiple
.B write
.SH SOURCE
.B \*9/src/lib9/fmt
.SH SEE ALSO
-.IM print (3) ,
-.IM utf (7) ,
-.IM errstr (3)
+.MR print (3) ,
+.MR utf (7) ,
+.MR errstr (3)
.SH DIAGNOSTICS
These routines return negative numbers or nil for errors and set
.IR errstr .
blob - 4fb2f8b69116a4db425787a58aaa5b91947fe201
blob + 4b027acb35cc7193c67ccd9669c69581a179d1b5
--- man/man3/frame.3
+++ man/man3/frame.3
This library supports
.I frames
of editable text in a single font on raster displays, such as in
-.IM sam (1)
+.MR sam (1)
and
-.IM 9term (1) .
+.MR 9term (1) .
Frames may hold any character except NUL (0).
Long lines are folded and tabs are at fixed intervals.
.PP
.B Frame
is being moved but not resized, that is, if the shape of its containing
rectangle is unchanged, it is sufficient to use
-.IM draw (3)
+.MR draw (3)
to copy the containing rectangle from the old to the new location and then call
.I frsetrects
to establish the new geometry.
.SH SOURCE
.B \*9/src/libframe
.SH SEE ALSO
-.IM graphics (3) ,
-.IM draw (3) ,
-.IM cachechars (3) .
+.MR graphics (3) ,
+.MR draw (3) ,
+.MR cachechars (3) .
blob - 320ecd14fe3372e473cd9f17bbd25e3be146cc6d
blob + b58756353651f65cbf03c16da41a8668a98504e1
--- man/man3/genrandom.3
+++ man/man3/genrandom.3
truly random bytes read via
.I truerand
(see
-.IM rand (3) ).
+.MR rand (3) ).
.PP
.I Prng
uses the native
-.IM rand (3)
+.MR rand (3)
pseudo-random number generator to fill the buffer. Used with
.IR srand ,
this function can produce a reproducible stream of pseudo random
Both functions may be passed to
.I mprand
(see
-.IM mp (3) ).
+.MR mp (3) ).
.SH SOURCE
.B \*9/src/libsec
.SH SEE ALSO
-.IM mp (3)
+.MR mp (3)
blob - 343ad9d6dd3bcd4b68769b34a6e1e7287ba96f45
blob + a6bdd02f8aba034b592f8b2ceffbf3f4236c2ca4
--- man/man3/get9root.3
+++ man/man3/get9root.3
should be freed with
.I free
(see
-.IM malloc (3) )
+.MR malloc (3) )
when no longer needed.
.PP
As a convention, programs should never
paths obtained from user input.
.SH EXAMPLE
The
-.IM plumber (4)
+.MR plumber (4)
uses this code to find unrooted file names included by plumb rules.
.IP
.EX
.br
.B \*9/src/lib9/unsharp.c
.SH SEE ALSO
-.IM intro (4)
+.MR intro (4)
.SH BUGS
.I Get9root
could be smarter about finding the tree when
blob - 3ce0a316b6cb39ded9a159f8667d7e02f834acff
blob + a37cb6595cd2d94910b7aecc3e27c7313dcac806
--- man/man3/getenv.3
+++ man/man3/getenv.3
fetches the environment value associated with
.I name
into memory allocated with
-.IM malloc (3) ,
+.MR malloc (3) ,
0-terminates it,
and returns a pointer to that area.
If no file exists, 0
and
.IR p9putenv ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 19741b855714ff4c0736e045c3730f6dcb671503
blob + 79a1ed7863096a3ce4470a89f64819f89e40c176
--- man/man3/getfields.3
+++ man/man3/getfields.3
non-zero,
except that fields may be quoted using single quotes, in the manner
of
-.IM rc (1) .
+.MR rc (1) .
See
-.IM quote (3)
+.MR quote (3)
for related quote-handling software.
.PP
.I Tokenize
.SH SEE ALSO
.I strtok
in
-.IM strcat (3) ,
-.IM quote (3) .
+.MR strcat (3) ,
+.MR quote (3) .
blob - a23a856b1d59836c8910a54f49665aec76010bba
blob + 6d0a5a9c2a05ce887dcbae73d57696548180a11e
--- man/man3/getns.3
+++ man/man3/getns.3
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
-.IM intro (4)
+.MR intro (4)
for details.
.SH SOURCE
.B \*9/src/lib9/getns.c
.SH SEE ALSO
-.IM intro (4)
+.MR intro (4)
blob - 323b6ab542788aabc6362f21aebf48cf92f91485
blob + 30d220828e54988b2e465df680a7b7b586d1e3b0
--- man/man3/getsnarf.3
+++ man/man3/getsnarf.3
the returned pointer should be freed with
.I free
(see
-.IM malloc (3) )
+.MR malloc (3) )
when no longer needed.
.PP
.I Putsnarf
.SH SOURCE
.B \*9/src/libdraw/snarf.c
.SH SEE ALSO
-.IM snarfer (1)
+.MR snarfer (1)
blob - dae84a2300c4d40592aecef6c01f5c2a7c715dc2
blob + 45531b4c189010a53ba5a44cfeb9f4458fe7f419
--- man/man3/getuser.3
+++ man/man3/getuser.3
owns the current process.
.I Getuser
calls
-.IM getuid (2)
+.MR getuid (2)
and then reads
.B /etc/passwd
to find the corresponding name.
If there is no such variable,
.I sysname
calls
-.IM gethostname (2)
+.MR gethostname (2)
and truncates the returned name at the first dot.
If
.I gethostname
blob - 9bb36d3097cd2ed22a72c29f221287e96d96cb3b
blob + f9ef1949badbd07761ccadf4140d6822600a5079
--- man/man3/getwd.3
+++ man/man3/getwd.3
.SH SOURCE
.B \*9/src/lib9/getwd.c
.SH "SEE ALSO"
-.IM pwd (1)
+.MR pwd (1)
.SH DIAGNOSTICS
On error, zero is returned.
-.IM Errstr (3)
+.MR Errstr (3)
may be consulted for more information.
.SH BUGS
To avoid name conflicts with the underlying system,
is a preprocessor macro defined as
.IR p9getwd ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 42b797f441b84ab0c6a1624fd4922ba5580a707b
blob + da0b61cfd458987b388c44b4a9f1ff6c5cbe406a
--- man/man3/graphics.3
+++ man/man3/graphics.3
A
.B Display
structure represents a connection to the graphics device,
-.IM draw (3) ,
+.MR 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:
.B Point
is a location in an Image
(see below and
-.IM draw (3) ),
+.MR draw (3) ),
such as the display, and is defined as:
.IP
.EX
The
.B Image
data structure is defined in
-.IM draw (3) .
+.MR draw (3) .
.PP
A
.B Font
is a set of character images, indexed by runes (see
-.IM utf (7) ).
+.MR 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
-.IM cachechars (3) ,
+.MR cachechars (3) ,
is immaterial for most applications.
.B Font
and
the distance from the top of the highest character to the bottom of
the lowest character (and hence, the interline spacing).
See
-.IM cachechars (3)
+.MR cachechars (3)
for more details.
.PP
.I Buildfont
pointer that can be used by
.B string
(see
-.IM draw (3) )
+.MR draw (3) )
to draw characters from the font.
.I Openfont
does the same, but reads the description
In contrast to Plan 9, font names in Plan 9 from User Space are
a small language describing the desired font.
See
-.IM font (7)
+.MR font (7)
for details.
.PP
A
(an
.B Image
representing the display memory itself or, if
-.IM rio (1)
+.MR rio (1)
is running, the client's window),
and
.B font
.B /dev/label
if non-nil
so that it can be used to identify the window when hidden (see
-.IM rio (1) ).
+.MR rio (1) ).
The font is created by reading the named
.I font
file. If
is not set, it imports the default (usually minimal)
font from the operating system.
(See
-.IM font (7)
+.MR font (7)
for a full discussion of font syntaxes.)
The global
.I font
Another effect of
.I initdraw
is that it installs
-.IM print (3)
+.MR print (3)
formats
.I Pfmt
and
files; and
.I ref
specifies the refresh function to be used to create the window, if running under
-.IM rio (1)
+.MR rio (1)
(see
-.IM window (3) ).
+.MR window (3) ).
.\" .PP
.\" The function
.\" .I newwindow
to find the name of the window and opening it using
.B namedimage
(see
-.IM allocimage (3) ).
+.MR allocimage (3) ).
The resulting window will be created using the refresh method
.I ref
(see
-.IM window (3) );
+.MR window (3) );
this should almost always be
.B Refnone
because
a pointer to the
.B Screen
representing the root of the window's hierarchy. (See
-.IM window (3) .
+.MR window (3) .
The overloading of the
.B screen
word is an unfortunate historical accident.)
is a no-op.
.PP
The graphics functions described in
-.IM draw (3) ,
-.IM allocimage (3) ,
-.IM cachechars (3) ,
+.MR draw (3) ,
+.MR allocimage (3) ,
+.MR cachechars (3) ,
and
-.IM subfont (3)
+.MR subfont (3)
are implemented by writing commands to files under
.B /dev/draw
(see
-.IM draw (3) );
+.MR draw (3) );
the writes are buffered, so the functions may not take effect immediately.
.I Flushimage
flushes the buffer, doing all pending graphics operations.
driver to the visible frame buffer.
The various allocation routines in the library flush automatically, as does the event
package (see
-.IM event (3) );
+.MR event (3) );
most programs do not need to call
.IR flushimage .
It returns \-1 on error.
.I chantostr
convert between the channel descriptor strings
used by
-.IM image (7)
+.MR image (7)
and the internal
.B ulong
representation
used by the graphics protocol
(see
-.IM draw (3) 's
+.MR draw (3) 's
.B b
message).
.B Chantostr
.EE
.PP
To create and set up a new
-.IM rio (1)
+.MR rio (1)
window,
.IP
.EX
.SH SOURCE
.B \*9/src/libdraw
.SH "SEE ALSO"
-.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) ,
+.MR rio (1) ,
+.MR addpt (3) ,
+.MR allocimage (3) ,
+.MR cachechars (3) ,
+.MR subfont (3) ,
+.MR draw (3) ,
+.MR event (3) ,
+.MR frame (3) ,
+.MR print (3) ,
+.MR window (3) ,
+.MR draw (3) ,
.\" .IR rio (4),
-.IM image (7) ,
-.IM font (7)
+.MR image (7) ,
+.MR font (7)
.SH DIAGNOSTICS
An error function may call
-.IM errstr (3)
+.MR errstr (3)
for further diagnostics.
.SH BUGS
The names
blob - f99fda1b499b140c016351edb2167025a93d6705
blob + b77fda9190bdb3aa0d320d56c3f5ae54d26ed60d
--- man/man3/html.3
+++ man/man3/html.3
.SH SOURCE
.B \*9/src/libhtml
.SH SEE ALSO
-.IM fmt (1)
+.MR fmt (1)
.PP
W3C World Wide Web Consortium,
``HTML 4.01 Specification''.
blob - 2645a228f3562b39aff60623627484e32209da5d
blob + 38609d7b6af9f4a1670eaaacb03425816122d7e0
--- man/man3/ioproc.3
+++ man/man3/ioproc.3
execute the
similarly named library or system calls
(see
-.IM close (2) ,
-.IM dial (3) ,
-.IM open (3) ,
-.IM read (3) ,
-.IM fcall (3) ,
-.IM sendfd (3) ,
+.MR close (2) ,
+.MR dial (3) ,
+.MR open (3) ,
+.MR read (3) ,
+.MR fcall (3) ,
+.MR sendfd (3) ,
and
-.IM sleep (3) )
+.MR sleep (3) )
in the slave process associated with
.IR io .
It is an error to execute more than one call
.SH SOURCE
.B \*9/src/libthread
.SH SEE ALSO
-.IM dial (3) ,
-.IM open (3) ,
-.IM read (3) ,
-.IM thread (3)
+.MR dial (3) ,
+.MR open (3) ,
+.MR read (3) ,
+.MR thread (3)
.SH BUGS
.I Iointerrupt
is currently unimplemented.
blob - c8305dea42e4da4a68efe31be8516a43ee701966
blob + da3855ed81ea0a64cf8919329c581173b6b24b58
--- man/man3/ip.3
+++ man/man3/ip.3
.PP
.I Eipfmt
is a
-.IM print (3)
+.MR print (3)
formatter for Ethernet (verb
.BR E )
addresses,
.SH SOURCE
.B \*9/src/libip
.SH SEE ALSO
-.IM print (3)
+.MR print (3)
blob - eeaf3ebcb40abd415dc2d1477b8cad3b7932642a
blob + f9b20a0c98a2cc12afd3fd7faca48b1499f9273d
--- man/man3/isalpharune.3
+++ man/man3/isalpharune.3
Unicode defines some characters as alphabetic and specifies three cases:
upper, lower, and title.
Analogously to
-.IM isalpha (3)
+.MR isalpha (3)
for
.SM ASCII\c
,
blob - 6c1bf026e07b44a96990915116bbb8ce6de31c64
blob + feedfd2e9a5eec6fab646ca32961b3314bd8ba0f
--- man/man3/keyboard.3
+++ man/man3/keyboard.3
.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
-.IM mouse (3) .
+.MR mouse (3) .
They use the message-passing
.B Channel
interface in the threads library
(see
-.IM thread (3) );
+.MR thread (3) );
programs that wish a more event-driven, single-threaded approach should use
-.IM event (3) .
+.MR event (3) .
.PP
.I Initkeyboard
opens a connection to the keyboard and returns a
.SH SOURCE
.B \*9/src/libdraw
.SH SEE ALSO
-.IM graphics (3) ,
-.IM draw (3) ,
-.IM event (3) ,
-.IM thread (3) .
+.MR graphics (3) ,
+.MR draw (3) ,
+.MR event (3) ,
+.MR thread (3) .
.SH BUGS
Because the interface delivers complete runes,
there is no way to report lesser actions such as
blob - 31882bb0ccdd77282cc7d734628233c5db1dc5e4
blob + 2dea7467c5bf545f006b3a786f1b5fb66f6dce45
--- man/man3/lock.3
+++ man/man3/lock.3
Locks and rendezvous points have trivial implementations in programs
not using the thread library
(see
-.IM thread (3) ),
+.MR thread (3) ),
since such programs have no concurrency.
.PP
Used carelessly, spin locks can be expensive and can easily generate deadlocks.
blob - 08563eb7599de10a1a779b93c7d6706cf8c2fcae
blob + a2b4462d5125bdebd046a67356b9ba3735f0d5eb
--- man/man3/mach-cmd.3
+++ man/man3/mach-cmd.3
(see
.I symopen
in
-.IM mach-symbol (3) ).
+.MR mach-symbol (3) ).
When dynamically linked objects have been attached,
they are present in this linked list,
and therefore included in searches by
and
.I findsym
(see
-.IM mach-symbol (3) ).
+.MR mach-symbol (3) ).
.TP
.I corhdr
The file header for the core dump, if any.
uses all of these functions while
parsing an argument vector as would be passed to
a debugger like
-.IM db (1)
+.MR db (1)
or
-.IM acid (1) .
+.MR 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
.SH SOURCE
.B \*9/src/libmach
.SH "SEE ALSO
-.IM mach (3) ,
-.IM mach-file (3) ,
-.IM mach-map (3)
+.MR mach (3) ,
+.MR mach-file (3) ,
+.MR mach-map (3)
.SH BUGS
The interface needs to be changed to support
multiple threads, each with its own register set.
blob - 22a61aa0d0076e341e07ea54aa552e0eba333465
blob + cd275c5e8e6cc3ed6023c77d1fd785f26001c17e
--- man/man3/mach-file.3
+++ man/man3/mach-file.3
should be freed via
.I free
(see
-.IM malloc (3) )
+.MR malloc (3) )
when no longer needed.
.SH SOURCE
.B \*9/src/libmach
.SH "SEE ALSO"
-.IM mach (3) ,
-.IM mach-map (3)
+.MR mach (3) ,
+.MR mach-map (3)
blob - 94e73a223901883cca16f8b3a3c937b063847f54
blob + a0e274023945f8be10f860570d763e9a6e7d6e2c
--- man/man3/mach-map.3
+++ man/man3/mach-map.3
data structures that provides access to an address space
and register set.
The functions described in
-.IM mach-file (3)
+.MR mach-file (3)
are typically used to construct these maps.
Related library functions described in
-.IM mach-symbol (3)
+.MR mach-symbol (3)
provide similar access to symbol tables.
.PP
Each
.B rw
function is most commonly used to provide
access to executing processes via
-.IM ptrace (2)
+.MR ptrace (2)
and to zeroed segments.
.PP
.I Allocmap
functions expect locations, such as
.I unwind
(see
-.IM mach-stack (3) ).
+.MR mach-stack (3) ).
.PP
.I Loccmp
compares two locations, returning negative, zero, or positive
.PP
.I Locfmt
is a
-.IM print (3) -verb
+.MR print (3) -verb
that formats a
.B Loc
structure
using
.I findlsym
(see
-.IM mach-symbol (3) )),
+.MR mach-symbol (3) )),
but bothersome in most.
.I Locsimplify
rewrites indirections as absolute memory addresses, by evaluating
.SH SOURCE
.B \*9/src/libmach
.SH "SEE ALSO"
-.IM mach (3) ,
-.IM mach-file (3)
+.MR mach (3) ,
+.MR mach-file (3)
.SH DIAGNOSTICS
These routines set
.IR errstr .
blob - abf413943787ebcd7a9d42b668af81aea194487b
blob + 4c34abb15a4d2b2e8f1af79936a51fb592b3d7da
--- man/man3/mach-stack.3
+++ man/man3/mach-stack.3
.I rget
function, and a symbol
(see
-.IM mach-symbol (3) )
+.MR mach-symbol (3) )
describing the current function
(nil if no symbol is known).
The value returned by the tracer
.SH SOURCE
.B \*9/src/libmach
.SH SEE ALSO
-.IM mach (3)
+.MR mach (3)
.SH BUGS
Need to talk about Regs
blob - 39b18ef9dccc40e94583ae23dd841c7accca885d
blob + eda669117182d109746a0c63f7698c832fad8b26
--- man/man3/mach-swap.3
+++ man/man3/mach-swap.3
.SH SOURCE
.B \*9/src/libmach
.SH "SEE ALSO"
-.IM mach (3)
+.MR mach (3)
blob - fc7bbd28188d28fae0a215616abdd172d1d487b8
blob + a761a12b48c82ecb2a00aa589b8698b6dc5d1a0c
--- man/man3/mach-symbol.3
+++ man/man3/mach-symbol.3
.SH DESCRIPTION
These functions provide machine-independent access to the
symbol table of an executable file or executing process.
-.IM Mach (3) ,
-.IM mach-file (3) ,
+.MR Mach (3) ,
+.MR mach-file (3) ,
and
-.IM mach-map (3)
+.MR mach-map (3)
describe additional library functions for
accessing executable files and executing processes.
.PP
structure filled by
.I crackhdr
(see
-.IM mach-file (3) )
+.MR mach-file (3) )
to initialize in-memory structures used to access the symbol
tables contained in the file.
.IR Symclose
.SH SOURCE
.B \*9/src/libmach
.SH "SEE ALSO"
-.IM mach (3) ,
-.IM mach-file (3) ,
-.IM mach-map (3)
+.MR mach (3) ,
+.MR mach-file (3) ,
+.MR mach-map (3)
blob - 71742155c205b5490cf637e9e8e0811155977259
blob + bf260d581ec8dd3d80227737b47eb1ed3d07b1aa
--- man/man3/mach.3
+++ man/man3/mach.3
It is set implicitly by
.I crackhdr
(see
-.IM mach-file (3) )
+.MR mach-file (3) )
and can be set explicitly by calling
.I machbyname
or
Other manual pages
describe the library functions in detail.
.PP
-.IM Mach-cmd (3)
+.MR Mach-cmd (3)
describes some convenience routines for attaching to
processes and core files.
.PP
-.IM Mach-file (3)
+.MR Mach-file (3)
describes the manipulation of binary files.
.PP
-.IM Mach-map (3)
+.MR Mach-map (3)
describes the interface to address spaces and register sets
in executable files and executing programs.
.PP
-.IM Mach-stack (3)
+.MR Mach-stack (3)
describes support for unwinding the stack.
.PP
-.IM Mach-swap (3)
+.MR Mach-swap (3)
describes helper functions for accessing data
in a particular byte order.
.PP
-.IM Mach-symbol (3)
+.MR Mach-symbol (3)
describes the interface to debugging symbol information.
.SH SOURCE
.B \*9/src/libmach
.SH "SEE ALSO
-.IM mach-file (3) ,
-.IM mach-map (3) ,
-.IM mach-stack (3) ,
-.IM mach-swap (3) ,
-.IM mach-symbol (3)
+.MR mach-file (3) ,
+.MR mach-map (3) ,
+.MR mach-stack (3) ,
+.MR mach-swap (3) ,
+.MR mach-symbol (3)
blob - 300b9c5b0e9baedca4a548162b382a93f4ee75ed
blob + 02498ab9bb6ab3cd08b60b7b8cf8c6693364829f
--- man/man3/malloc.3
+++ man/man3/malloc.3
.SH SEE ALSO
.I trump
(in
-.IM acid (1) ),
-.IM getcallerpc (3)
+.MR acid (1) ),
+.MR getcallerpc (3)
.SH DIAGNOSTICS
.I Malloc, realloc
and
library for
.I acid
can be used to obtain traces of malloc execution; see
-.IM acid (1) .
+.MR acid (1) .
.SH BUGS
The different specification of
.I calloc
and
.IR p9free ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - b66170efdc705e7ed91e60d478acf80eb65bf6db
blob + 7d6c9e6b2fa18c12986464ca00d4f863245cf643
--- man/man3/matrix.3
+++ man/man3/matrix.3
.SH SOURCE
.B \*9/src/libgeometry/matrix.c
.SH "SEE ALSO
-.IM arith3 (3)
+.MR arith3 (3)
blob - 89e073b92a8697ae46e8bdd7cac1ef8bc416a627
blob + 8dad89d0b5a625284b8cac5d38c8e456222ebc1a
--- man/man3/memdraw.3
+++ man/man3/memdraw.3
differ from
.BR Image s
(see
-.IM draw (3) )
+.MR draw (3) )
in that they are manipulated directly in user memory rather than by
RPCs to the
.B /dev/draw
The
.Bmemdraw
library is the basis for the kernel
-.IM draw (3)
+.MR draw (3)
driver and also used by a number of programs that must manipulate
images without a display.
.PP
(see
.B strtochan
in
-.IM graphics (3) ),
+.MR graphics (3) ),
creating a fresh
.B Memdata
structure and associated storage.
to file descriptor
.IR fd .
For more on bitmap formats, see
-.IM image (7) .
+.MR image (7) .
.I Freememimage
frees images returned by any of these routines.
The
.I Memfillcolor
fills an image with the given color, a 32-bit number as
described in
-.IM color (3) .
+.MR color (3) .
.PP
.IR Memarc ,
.IR mempoly ,
and
.IR gendraw ,
routines described in
-.IM draw (3) ,
+.MR draw (3) ,
except that they operate on
.BR Memimage s
rather than
and
.B string
(see
-.IM subfont (3)
+.MR subfont (3)
and
-.IM graphics (3) ),
+.MR graphics (3) ),
except that they operate
only on
.BR Memsubfont s
.SH SOURCE
.B \*9/src/libmemdraw
.SH SEE ALSO
-.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)
+.MR addpt (3) ,
+.MR color (3) ,
+.MR draw (3) ,
+.MR graphics (3) ,
+.MR memlayer (3) ,
+.MR stringsize (3) ,
+.MR subfont (3) ,
+.MR color (7) ,
+.MR utf (7)
.SH BUGS
.I Memimagestring
is unusual in using a subfont rather than a font,
blob - c13a72a453598b270a777f393a441956ad91e1a5
blob + d7f065100930f8127afcf98359ee422ed1d989dc
--- man/man3/memlayer.3
+++ man/man3/memlayer.3
.PP
.SH DESCRIPTION
These functions build upon the
-.IM memdraw (3)
+.MR 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
-.IM draw (3)
+.MR draw (3)
and
-.IM window (3)
+.MR 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
-.IM memdraw (3) )
+.MR memdraw (3) )
to include overlapping windows defined by the
.B Memlayer
type.
and
.I memimageline
(see
-.IM memdraw (3) )
+.MR memdraw (3) )
but accept
.B Memlayer
or
.I buf
are in compressed image format
(see
-.IM image (7) ).
+.MR image (7) ).
.SH SOURCE
.B \*9/src/libmemlayer
.SH SEE ALSO
-.IM graphics (3) ,
-.IM memdraw (3) ,
-.IM stringsize (3) ,
-.IM window (3) ,
-.IM draw (3)
+.MR graphics (3) ,
+.MR memdraw (3) ,
+.MR stringsize (3) ,
+.MR window (3) ,
+.MR draw (3)
blob - fefb9ba3ad660f0c54eca738758839fb7503b318
blob + 5f191dd4ef60885327926dc4ade10c7493573d4c
--- man/man3/memory.3
+++ man/man3/memory.3
.\" Most also have machine-dependent assembly language implementations in
.\" .BR \*9/lib9/$objtype .
.SH SEE ALSO
-.IM strcat (3)
+.MR strcat (3)
.SH BUGS
ANSI C does not require
.I memcpy
blob - 6974dfa632e7298767c24e324829e8f8fd717cf8
blob + 9b835891bc02aa1c2c360cf824602d896240196f
--- man/man3/mouse.3
+++ man/man3/mouse.3
.B Channel
interface in the threads library
(see
-.IM thread (3) );
+.MR thread (3) );
programs that wish a more event-driven, single-threaded approach should use
-.IM event (3) .
+.MR event (3) .
.PP
The state of the mouse is recorded in a structure,
.BR Mouse ,
naming the device file connected to the mouse and an
.I Image
(see
-.IM draw (3) )
+.MR draw (3) )
on which the mouse will be visible.
Typically the file is
nil,
tells the program that it should call
.B getwindow
(see
-.IM graphics (3) )
+.MR graphics (3) )
to reconnect to the window.
.PP
.I Readmouse
It calls
.B flushimage
(see
-.IM graphics (3) )
+.MR graphics (3) )
before blocking, so any buffered graphics requests are displayed.
.PP
.I Closemouse
The format of the cursor data is spelled out in
.B <cursor.h>
and described in
-.IM graphics (3) .
+.MR graphics (3) .
.PP
.I Getrect
returns the dimensions of a rectangle swept by the user, using the mouse,
in the manner
-.IM rio (1)
+.MR rio (1)
or
-.IM sam (1)
+.MR sam (1)
uses to create a new window.
The
.I but
behaves the same as its namesake
.I emenuhit
described in
-.IM event (3) ,
+.MR event (3) ,
with two exceptions.
First, it uses a
.B Mousectl
.B Screen
.I scr
(see
-.IM window (3) ),
+.MR window (3) ),
permitting the menu to be displayed in parallel with other activities on the display.
If
.I scr
.SH SOURCE
.B \*9/src/libdraw
.SH SEE ALSO
-.IM graphics (3) ,
-.IM draw (3) ,
-.IM event (3) ,
-.IM keyboard (3) ,
-.IM thread (3) .
+.MR graphics (3) ,
+.MR draw (3) ,
+.MR event (3) ,
+.MR keyboard (3) ,
+.MR thread (3) .
blob - 4595a68d5b6e21683e9c8d202d3f025a04d899f4
blob + c4c24b10b356a8d0ef94bcf4b3b49d0c037f3e9b
--- man/man3/mousescrollsize.3
+++ man/man3/mousescrollsize.3
.PP
.I Mousescrollsize
is used by
-.IM 9term (1)
+.MR 9term (1)
and
-.IM acme (1)
+.MR acme (1)
to set their scrolling behavior.
.SH SOURCE
.B \*9/src/libdraw/scroll.c
.SH SEE ALSO
-.IM 9term (1) ,
-.IM acme (1)
+.MR 9term (1) ,
+.MR 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 - ad61ed9048a29305c47edfe3f4f98574e2be8f86
blob + 8ea365dc2422e02c5da226799e6afa8a9bc3cf29
--- man/man3/mp.3
+++ man/man3/mp.3
the buffer is allocated.
.I Mpfmt
can be used with
-.IM fmtinstall (3)
+.MR fmtinstall (3)
and
-.IM print (3)
+.MR print (3)
to print hexadecimal representations of
.BR mpint s.
.PP
blob - 180528b9e93fae685bc5f62608a3d094ac910388
blob + ed82294038cecf61aadc464b1049c81f4c8de9d8
--- man/man3/mux.3
+++ man/man3/mux.3
.I Muxprocs
allocates new procs
(see
-.IM thread (3) )
+.MR thread (3) )
in which to run
.I send
and
.I Libmux
also provides a non-blocking interface, useful for programs forced
to use a
-.IM select (3) -based
+.MR select (3) -based
main loop.
.I Muxrpcstart
runs the first half of
.SH SOURCE
.B \*9/src/libmux
.SH SEE ALSO
-.IM thread (3) ,
+.MR thread (3) ,
.IR intro (9p)
.SH BUGS
.I Libmux
blob - 2392f3ff5c75d5b5a2b5051cd4461bdcf59b0b3d
blob + 413c11d6284b7587a6f365ce33fb9d453e71f61d
--- man/man3/ndb.3
+++ man/man3/ndb.3
These routines are used by network administrative programs to search
the network database.
They operate on the database files described in
-.IM ndb (7) .
+.MR ndb (7) .
.PP
.I Ndbopen
opens the database
.I file
and calls
-.IM malloc (3)
+.MR malloc (3)
to allocate a buffer for it.
If
.I file
On a successful search both return a linked list of
.I Ndbtuple
structures acquired by
-.IM malloc (3)
+.MR malloc (3)
that represent the attribute/value pairs in the
entry.
On failure they return zero.
.SH SOURCE
.B \*9/src/libndb
.SH SEE ALSO
-.IM ndb (1)
-.IM ndb (7)
+.MR ndb (1)
+.MR ndb (7)
.SH DIAGNOSTICS
.IR Ndbgetvalue
and
blob - c19d15534166bcd9b6572f6ae0d8f6e6e27c99be
blob + 52fa8785aed70bc1de0e15a7a06fafcfc651d2d0
--- man/man3/needstack.3
+++ man/man3/needstack.3
.I Needstack
should be thought of as a comment checked at run time,
like
-.IM assert (3) .
+.MR assert (3) .
.SH EXAMPLE
The X Window library implementation of
.I XLookupString
.IR XLookupString .
If a thread (in this case, the keyboard-reading thread used
inside the
-.IM draw (3)
+.MR draw (3)
library)
does not allocate a large enough stack, the problem is diagnosed
immediately rather than left to corrupt memory.
.br
.B \*9/src/libthread
.SH SEE ALSO
-.IM thread (3)
+.MR thread (3)
blob - 269fe4b07ec0b7a4e6e768fea5c1f1c3e27aa41f
blob + 9f2efb6dbf847fa69f30c36fc3862fa0fb597e70
--- man/man3/notify.3
+++ man/man3/notify.3
is posted to communicate the exception.
A note may also be posted by another process
via
-.IM postnote (3) .
+.MR postnote (3) .
On Unix, notes are implemented as signals.
.PP
When a note is received, the action taken depends on the note.
See
-.IM signal (7)
+.MR signal (7)
for the full description of the defaults.
.PP
The default actions may be overridden.
An argument of zero cancels a previous handler,
restoring the default action.
A
-.IM fork (2)
+.MR fork (2)
system call leaves the handler registered in
both the parent and the child;
-.IM exec (3)
+.MR exec (3)
restores the default behavior.
Handlers may not perform floating point operations.
.PP
using the
.I notejmp
function (see
-.IM setjmp (3) ).
+.MR 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
-.IM sigprocmask (2) )
+.MR sigprocmask (2) )
and to ignore certain notes by setting the signal hander to the special value
.B SIG_IGN
(see
-.IM signal (2) ).
+.MR signal (2) ).
.I Noteenable
and
.I notedisable
Regardless of the origin of the note or the presence of a handler,
if the process is being debugged
(see
-.IM ptrace (2) )
+.MR ptrace (2) )
the arrival of a note puts the process in the
.B Stopped
state and awakens the debugger.
.br
.B \*9/src/lib9/atnotify.c
.SH SEE ALSO
-.IM intro (3) ,
+.MR intro (3) ,
.I notejmp
in
-.IM setjmp (3)
+.MR setjmp (3)
blob - adc38feb109a5ce04f6712a611fc7459f857ede8
blob + d4b2e27252b9a52beec93b889b1eb48e025bbba3
--- man/man3/open.3
+++ man/man3/open.3
to zero length before opening it;
.B OCEXEC
says to close the file when an
-.IM exec (3)
+.MR exec (3)
or
.I execl
system call is made;
fails if the file does not exist or the user does not have
permission to open it for the requested purpose
(see
-.IM stat (3)
+.MR stat (3)
for a description of permissions).
The user must have write permission on the
.I file
(unlike the implicit
.I open
in
-.IM exec (3) ),
+.MR exec (3) ),
.B OEXEC
is actually identical to
.BR OREAD .
.SH SOURCE
.B \*9/src/lib9
.SH SEE ALSO
-.IM intro (3) ,
-.IM stat (3)
+.MR intro (3) ,
+.MR stat (3)
.SH DIAGNOSTICS
These functions set
.IR errstr .
and
.IR p9create ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 33c0b060a9a516c2642e217c07aee688de74e510
blob + f105a57fd53903123c8c3cbc186e7cc02b645521
--- man/man3/opentemp.3
+++ man/man3/opentemp.3
.L z
are tried until the name of a file that does not yet exist
(see
-.IM access (2) )
+.MR access (2) )
is generated.
.I Opentemp
then opens the file for the given
.SH "SEE ALSO
.I create
in
-.IM open (3)
+.MR open (3)
blob - c134eaa27ffc10d0436015247771ab9d67560212
blob + ef4de31322333b7fc7d31005f079dc4af0784f43
--- man/man3/pipe.3
+++ man/man3/pipe.3
After the pipe has been established,
cooperating processes
created by subsequent
-.IM fork (2)
+.MR fork (2)
calls may pass data through the
pipe with
.I read
.\" .IR stat (3)).
.PP
When all the data has been read from a pipe and the writer has closed the pipe or exited,
-.IM read (3)
+.MR 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
-.IM intro (3) ,
-.IM read (3)
+.MR intro (3) ,
+.MR read (3)
.SH DIAGNOSTICS
Sets
.IR errstr .
In order to ensure a bidirectional channel,
.I p9pipe
creates Unix domain sockets via the
-.IM socketpair (2)
+.MR socketpair (2)
instead of Unix pipes.
.PP
The implementation of pipes as Unix domain sockets
descriptor 0, some implementations disallow the opening of
.BR /dev/fd/0 ;
instead one must
-.IM connect (2)
+.MR connect (2)
to it.
If this functionality is important
(as it is for
-.IM rc (1) ),
+.MR rc (1) ),
one must
.B #undef
.B pipe
blob - 28185a882422a70438a8162e4e118f3bd8010b9c
blob + 409c40bc2ae810e7f85963949478c0ea976ca86c
--- man/man3/plumb.3
+++ man/man3/plumb.3
int plumbsendtofid(CFid *fid, Plumbmsg *m)
.SH DESCRIPTION
These routines manipulate
-.IM plumb (7)
+.MR plumb (7)
messages, transmitting them, receiving them, and
converting them between text and these data structures:
.IP
opens the named plumb
.IR port ,
using
-.IM open (3)
+.MR open (3)
mode
.IR omode .
If
otherwise
.I plumbopen
searches for the location of the
-.IM plumber (4)
+.MR plumber (4)
service and opens the port there.
.PP
For programs using the
-.IM event (3)
+.MR event (3)
interface,
.I eplumb
registers, using the given
.IR port .
.PP
The library mounts the
-.IM plumber (4)
+.MR plumber (4)
service on demand (using the
-.IM 9pclient (3) )
+.MR 9pclient (3) )
library and reuses the mount instance for future
calls to
.IR plumbopen .
frees all the data associated with the message
.IR m ,
all the components of which must therefore have been allocated with
-.IM malloc (3) .
+.MR malloc (3) .
.PP
.I Plumbrecv
returns the next message available on the file descriptor
is created with
.I fsopenfd
(see
-.IM 9pclient (3) ),
+.MR 9pclient (3) ),
which masks information about read and write errors.
This is acceptable for use in
.I plumbrecv
.SH SOURCE
.B \*9/src/libplumb
.SH SEE ALSO
-.IM plumb (1) ,
-.IM event (3) ,
-.IM plumber (4) ,
-.IM plumb (7)
+.MR plumb (1) ,
+.MR event (3) ,
+.MR plumber (4) ,
+.MR plumb (7)
.SH DIAGNOSTICS
When appropriate, including when a
.I plumbsend
blob - 4bf1a68b13a8b7a56a898b811e0fcb16d160aedb
blob + 5eeae234fbea3541dbc7075b914a1b8952d330e3
--- man/man3/post9pservice.3
+++ man/man3/post9pservice.3
.SH DESCRIPTION
.I Post9pservice
invokes
-.IM 9pserve (4)
+.MR 9pserve (4)
to post a new 9P service in the current
``name space''
(see
-.IM intro (4) )
+.MR intro (4) )
named
.IR name .
Clients connecting to the posted service
mounts the service on
.IR mtpt ,
using
-.IM 9pfuse (4) .
+.MR 9pfuse (4) .
.SH "SEE ALSO
-.IM intro (4) ,
-.IM 9pfuse (4) ,
-.IM 9pserve (4)
+.MR intro (4) ,
+.MR 9pfuse (4) ,
+.MR 9pserve (4)
.SH SOURCE
.B \*9/src/lib9/post9p.c
blob - 3dd7796d0c52df77fa5620d099cd41f503efe2d8
blob + 907710a1f6fa9e288bfb266c7e0bd01b20da6ca9
--- man/man3/postnote.3
+++ man/man3/postnote.3
.SH SOURCE
.B \*9/src/lib9/postnote.c
.SH "SEE ALSO"
-.IM notify (3) ,
-.IM intro (3)
+.MR notify (3) ,
+.MR intro (3)
.SH DIAGNOSTICS
Sets
.IR errstr .
blob - 4e4987d3fcb57685a2c4a88528926323ce5e08f2
blob + d364b30cbaacea064a5af9d51204623c058191d0
--- man/man3/prime.3
+++ man/man3/prime.3
.SH SOURCE
.B \*9/src/libsec
.SH SEE ALSO
-.IM aes (3)
-.IM blowfish (3) ,
-.IM des (3) ,
-.IM elgamal (3) ,
-.IM rsa (3) ,
+.MR aes (3)
+.MR blowfish (3) ,
+.MR des (3) ,
+.MR elgamal (3) ,
+.MR rsa (3) ,
blob - 997b5cb3a91ac87c1f2c949c1a39184384cfa438
blob + 452ed7c812e05cc9c69816de89391bf123ed3169
--- man/man3/print.3
+++ man/man3/print.3
file descriptor:
a buffered form
is described in
-.IM bio (3) .
+.MR bio (3) .
.I Sprint
places text
followed by the NUL character
.IR sprint ,
except that it prints into and returns a string of the required length, which is
allocated by
-.IM malloc (3) .
+.MR malloc (3) .
.PP
The routines
.IR runesprint ,
.B S
verb is similar, but it interprets its pointer as an array
of runes (see
-.IM utf (7) );
+.MR utf (7) );
the runes are converted to
.SM UTF
before output.
The
.B r
verb takes no arguments; it copies the error string returned by a call to
-.IM errstr (3) .
+.MR errstr (3) .
.PP
Custom verbs may be installed using
-.IM fmtinstall (3) .
+.MR fmtinstall (3) .
.SH EXAMPLE
This function prints an error message with a variable
number of arguments and then quits.
.SH SOURCE
.B \*9/src/lib9/fmt
.SH SEE ALSO
-.IM fmtinstall (3) ,
-.IM fprintf (3) ,
-.IM utf (7)
+.MR fmtinstall (3) ,
+.MR fprintf (3) ,
+.MR utf (7)
.SH DIAGNOSTICS
Routines that write to a file descriptor or call
.IR malloc
.IR errstr .
.SH BUGS
The formatting is close to that specified for ANSI
-.IM fprintf (3) ;
+.MR fprintf (3) ;
the main difference is that
.B b
and
blob - eceb6381322fd8d130de275125bf9318362dcb34
blob + 571b932e6e2e17d16d940c8389ab37eb716829f5
--- man/man3/proto.3
+++ man/man3/proto.3
.SH SOURCE
.B \*9/src/libdisk/proto.c
.SH SEE ALSO
-.IM mk9660 (1) ,
+.MR mk9660 (1) ,
Plan 9's
.IR mkfs (8)
blob - 21730d337b6d484948ef9656785cef4e2d3edea1
blob + 7a086f00e2b9d7fdd7b7c189841f401af2f2be12
--- man/man3/pushtls.3
+++ man/man3/pushtls.3
On output, the connection directory is set, as with
.B listen
(see
-.IM dial (3) ).
+.MR dial (3) ).
The input
.I cert
is freed and a freshly allocated copy of the remote's certificate
.I cert.pem
should have been previously loaded into factotum.
(See
-.IM rsa (3)
+.MR rsa (3)
.\" XXX should be rsa(8)
for more about key generation.)
By setting
.\" .br
.B \*9/src/libsec/port
.SH "SEE ALSO"
-.IM dial (3) ,
-.IM thumbprint (7) ;
+.MR dial (3) ,
+.MR thumbprint (7) ;
Plan 9's
.IR factotum (4)
and
blob - 785158c69793a8ef2f09b602c80652fda390dfc2
blob + a5a67a790cb677b1bb793f6b436652a5d696e5ce
--- man/man3/qball.3
+++ man/man3/qball.3
.SH SOURCE
.B \*9/src/libgeometry/qball.c
.SH SEE ALSO
-.IM quaternion (3)
+.MR quaternion (3)
.br
Ken Shoemake,
``Animating Rotation with Quaternion Curves'',
blob - f51a1e7f2b3130bdbca65545238498b615ce9582
blob + 31b59b90fa9d2de0ff63593549b14b57fba354dd
--- man/man3/quaternion.3
+++ man/man3/quaternion.3
.TP
.B mtoq
Convert a rotation matrix (see
-.IM matrix (3) )
+.MR matrix (3) )
to a unit quaternion.
.TP
.B qtom
.SH SOURCE
.B \*9/src/libgeometry/quaternion.c
.SH SEE ALSO
-.IM matrix (3) ,
-.IM qball (3)
+.MR matrix (3) ,
+.MR qball (3)
.SH BUGS
To avoid name conflicts with NetBSD,
.I qdiv
is a preprocessor macro defined as
.IR p9qdiv ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - d34e4893d50c602f300b2f34bab121e4e5164807
blob + 30e85bdf55f71985cbdc1355d0ae749a32337c02
--- man/man3/quote.3
+++ man/man3/quote.3
The first four functions act as variants of
.B strdup
(see
-.IM strcat (3) ).
+.MR strcat (3) ).
Each returns a
freshly allocated copy of the string, created using
-.IM malloc (3) .
+.MR malloc (3) .
.I Quotestrdup
returns a quoted copy of
.IR s ,
versions of these functions do the same for
.CW Rune
strings (see
-.IM runestrcat (3) ).
+.MR runestrcat (3) ).
.PP
The string returned by
.I quotestrdup
is provided as a
.I doquote
function that flags any character special to
-.IM rc (1) .
+.MR rc (1) .
.PP
.I Quotestrfmt
and
.I quoterunestrfmt
are
-.IM print (3)
+.MR print (3)
formatting routines that produce quoted strings as output.
They may be installed by hand, but
.I quotefmtinstall
and
.B %Q
in
-.IM print (3)
+.MR print (3)
format strings.
.SH SOURCE
.B \*9/src/lib9/quote.c
.br
.B \*9/src/lib9/fmt/fmtquote.c
.SH "SEE ALSO
-.IM rc (1) ,
-.IM malloc (3) ,
-.IM print (3) ,
-.IM strcat (3)
+.MR rc (1) ,
+.MR malloc (3) ,
+.MR print (3) ,
+.MR strcat (3)
.SH BUGS
Because it is provided by the format library,
.I doquote
is a preprocessor macro defined as
.IR fmtdoquote ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 8d35e444b0632f048ca32229faa903cf653c36ea
blob + ba7ef97f8b5fddc1455aa62581d269f6b702b048
--- man/man3/rand.3
+++ man/man3/rand.3
.PP
.I Prng
uses the native
-.IM rand (3)
+.MR rand (3)
pseudo-random number generator to fill the buffer. Used with
.IR srand ,
this function can produce a reproducible stream of pseudo random
may be passed to
.I mprand
(see
-.IM mp (3) ).
+.MR mp (3) ).
.PP
.I Fastrand
uses
.B \*9/src/libsec/port
.SH "SEE ALSO
.\" .IR cons (3),
-.IM mp (3)
+.MR mp (3)
.SH BUGS
.I Truerand
and
.IR p9lrand ,
and so on;
see
-.IM intro (3) .
+.MR intro (3) .
.ie \n(HT .ds HT "
.el .ds HT " (see HTML-formatted man page for link)
.PP
blob - 1b7888d9d38cf06c6c5393dad52c3ae295a793d9
blob + 60849150fdc3a5ff490fb80592bef2c9dd7c2f72
--- man/man3/rc4.3
+++ man/man3/rc4.3
.SH SOURCE
.B \*9/src/libsec
.SH SEE ALSO
-.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)
+.MR mp (3) ,
+.MR aes (3) ,
+.MR blowfish (3) ,
+.MR des (3) ,
+.MR dsa (3) ,
+.MR elgamal (3) ,
+.MR rsa (3) ,
+.MR sechash (3) ,
+.MR prime (3) ,
+.MR rand (3)
blob - a176ad6d957621c0ca022d39cda5d77eb8d1de5b
blob + 6fd9feb02cd291cba88ec6284df89ce1fbb122f6
--- man/man3/read.3
+++ man/man3/read.3
and
.I Pwrite
equivalent to a
-.IM seek (3)
+.MR seek (3)
to
.I offset
followed by a
.SH SOURCE
.B \*9/src/lib9/readn.c
.SH SEE ALSO
-.IM intro (3) ,
+.MR intro (3) ,
.IR open (3),
-.IM dup (3) ,
-.IM pipe (3)
+.MR dup (3) ,
+.MR pipe (3)
.SH DIAGNOSTICS
These functions set
.IR errstr .
blob - d559cdabe06b6688fc85775724c605cc281602cb
blob + f0c048653ce5c5d3e6a161a73333dcc61eff9ccf
--- man/man3/readcolmap.3
+++ man/man3/readcolmap.3
.PP
Changing the hardware color map does not change
the color map used by the
-.IM draw (3)
+.MR draw (3)
operator to convert between
mapped and true color or greyscale images,
which is described in
-.IM color (7) .
+.MR color (7) .
.SH SOURCE
.B \*9/src/libdraw
.SH "SEE ALSO"
-.IM graphics (3) ,
-.IM draw (3) ,
-.IM color (7)
+.MR graphics (3) ,
+.MR draw (3) ,
+.MR color (7)
blob - cf2df9bad37de1396ca7882e56dd0ca3dc6d23b7
blob + 9deaa44ef9ae9348638aae856382e0a40e210bdc
--- man/man3/readcons.3
+++ man/man3/readcons.3
A stripped-down version of
.I netkey
(see
-.IM passwd (1) ):
+.MR passwd (1) ):
.IP
.EX
pass = readcons("password", nil, 1);
blob - a7a5ac8b1c1638b9154d24f30c5a225b5f0f6fa8
blob + 854ad99672e632e83e436d8903f1ea62d35d349c
--- man/man3/regexp.3
+++ man/man3/regexp.3
regular expression and returns
a pointer to the generated description.
The space is allocated by
-.IM malloc (3)
+.MR malloc (3)
and may be released by
.IR free .
Regular expressions are exactly as in
-.IM regexp (7) .
+.MR regexp (7) .
.PP
.I Regcomplit
is like
.SH SOURCE
.B \*9/src/libregexp
.SH "SEE ALSO"
-.IM grep (1)
+.MR grep (1)
.SH DIAGNOSTICS
.I Regcomp
returns
blob - df5048f775f6400fd25aa858ca3138904bfb502d
blob + 102ec3b348c36e414949e86cd9cc8c1f7edc650c
--- man/man3/rfork.3
+++ man/man3/rfork.3
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
-.IM fork (2) .
+.MR fork (2) .
It cannot be used to create shared-memory processes
(Plan 9's
.B RFMEM
flag); for that functionality use
.I proccreate
(see
-.IM thread (3) ).
+.MR thread (3) ).
.PP
The
.I flags
exit the child will leave no
.B Waitmsg
(see
-.IM wait (3) )
+.MR wait (3) )
for the parent to collect.
.\" .TP
.\" .B RFNAMEG
Each process is a member of a group of processes that all
receive notes when a note is sent to the group
(see
-.IM postnote (3)
+.MR postnote (3)
and
-.IM signal (2) ).
+.MR signal (2) ).
The group of a new process is by default the same as its parent, but if
.B RFNOTEG
is set (regardless of
Calling
.B rfork(RFFDG|RFPROC)
is equivalent to calling
-.IM fork (2) .
+.MR fork (2) .
.SH SOURCE
.B \*9/src/lib9/rfork.c
.SH DIAGNOSTICS
blob - 8bea1aab40f68147b574aac946576d6ba82cc276
blob + 35145bda0ddc056cf2a86044f5f08763b2ce0fba
--- man/man3/rsa.3
+++ man/man3/rsa.3
using the quoting conventions of
.I tokenize
(see
-.IM getfields (3) ).
+.MR getfields (3) ).
.PP
.I X509req
creates an X.509 certification request.
.SH SOURCE
.B \*9/src/libsec
.SH SEE ALSO
-.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)
+.MR mp (3) ,
+.MR aes (3) ,
+.MR blowfish (3) ,
+.MR des (3) ,
+.MR dsa (3) ,
+.MR elgamal (3) ,
+.MR rc4 (3) ,
+.MR sechash (3) ,
+.MR prime (3) ,
+.MR rand (3)
.\" .IR pem (8)
blob - d4fcf89d17c7128f304d75268938560e8d7b97f5
blob + 2cff02e37f0446ad894ea4a148421ca10ec2501b
--- man/man3/rune.3
+++ man/man3/rune.3
.br
.B \*9/src/lib9/utf/utfrune.c
.SH SEE ALSO
-.IM utf (7) ,
-.IM tcs (1)
+.MR utf (7) ,
+.MR tcs (1)
blob - eff637e41f1dfdd50ce69f8f3f7cddcc6bf3025e
blob + 42686f10fe9f5a79249a015e568890cf5620c9b9
--- man/man3/runestrcat.3
+++ man/man3/runestrcat.3
.SH DESCRIPTION
These functions are rune string analogues of
the corresponding functions in
-.IM strcat (3) .
+.MR strcat (3) .
.SH SOURCE
.B \*9/src/lib9
.SH SEE ALSO
-.IM memory (3) ,
-.IM rune (3) ,
-.IM strcat (3)
+.MR memory (3) ,
+.MR rune (3) ,
+.MR strcat (3)
.SH BUGS
The outcome of overlapping moves varies among implementations.
blob - 77c91f94c26b0e3378b27f338e43e2eb414760d4
blob + 10b741ebb832f49f42f0165d73437cdda1069f6c
--- man/man3/searchpath.3
+++ man/man3/searchpath.3
searches for the executable
.I name
in the same way that
-.IM sh (1)
+.MR sh (1)
and
-.IM rc (1)
+.MR rc (1)
do.
.PP
The environment variable
or simply
.IR name )
suitable for use in
-.IM open (3)
+.MR open (3)
or
-.IM exec (3) .
+.MR exec (3) .
.PP
If
.I name
blob - a7c6970d4bb9cb0fd0f78fc4158fac6708a81d5e
blob + cabfbce337e7868b3a5dd69049b3450f93428bb7
--- man/man3/sechash.3
+++ man/man3/sechash.3
.I sha1unpickle
unmarshal a pickled digest.
All four routines return a pointer to a newly
-.IM malloc (3) 'd
+.MR malloc (3) 'd
object.
.SH SOURCE
.B \*9/src/libsec
.SH SEE ALSO
-.IM aes (3) ,
-.IM blowfish (3) ,
-.IM des (3) ,
-.IM elgamal (3) ,
-.IM rc4 (3) ,
-.IM rsa (3)
+.MR aes (3) ,
+.MR blowfish (3) ,
+.MR des (3) ,
+.MR elgamal (3) ,
+.MR rc4 (3) ,
+.MR rsa (3)
blob - a95f37ff48dc7cbf37aecb0b4bdf1b3c360a96f7
blob + 7282c36636672a5b738ae3ed0ec9a441cf4b61d8
--- man/man3/seek.3
+++ man/man3/seek.3
.SH SOURCE
.B \*9/src/lib9/seek.c
.SH SEE ALSO
-.IM intro (3) ,
-.IM open (3)
+.MR intro (3) ,
+.MR open (3)
.SH DIAGNOSTICS
Sets
.IR errstr .
is a preprocessor macro defined as
.IR p9seek ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 82fd8a499997d8092689ace8d90850e42949a77c
blob + fe6391c2d2224a95afb8e16ff7bc2291efe3bea0
--- man/man3/sendfd.3
+++ man/man3/sendfd.3
can be used to pass an open file descriptor over
a Unix domain socket from one process to another.
Since
-.IM pipe (3)
+.MR pipe (3)
is implemented with
-.IM socketpair (2)
+.MR socketpair (2)
instead of
-.IM pipe (2) ,
+.MR pipe (2) ,
.I socket
can be a file descriptor obtained from
-.IM pipe (3) .
+.MR pipe (3) .
.PP
.I Sendfd
sends the file descriptor
.SH SOURCE
.B \*9/src/lib9/sendfd.c
.SH SEE ALSO
-.IM socketpair (2) ,
+.MR socketpair (2) ,
.I sendmsg
in
-.IM send (2)
+.MR send (2)
blob - 16fb0387e5942f4903359e89a9856831a7a27360
blob + 33573ba88bc80f74ff5f355299b4ba3a7fbd3a21
--- man/man3/setjmp.3
+++ man/man3/setjmp.3
is the same as
.I longjmp
except that it is to be called from within a note handler (see
-.IM notify (3) ).
+.MR notify (3) ).
The
.I uregs
argument should be the first argument passed to the note handler.
.SH SOURCE
.B \*9/src/lib9/jmp.c
.SH SEE ALSO
-.IM notify (3)
+.MR notify (3)
.SH BUGS
.PP
.I Notejmp
and
.IR p9jmp_buf ;
see
-.IM intro (3) .
+.MR intro (3) .
.PP
.I P9setjmp
is implemented as a preprocessor macro that calls
blob - 0bccc15f8645971dc1debb50677a136ea6e02a8d
blob + fabd2b4b940d957c5f4a2ffd27b5662bc8ca3f02
--- man/man3/sleep.3
+++ man/man3/sleep.3
causes an
.B alarm
note (see
-.IM notify (3) )
+.MR notify (3) )
to be sent to the invoking process after the number of milliseconds
given by the argument.
Successive calls to
.SH SOURCE
.B \*9/src/lib9/sleep.c
.SH SEE ALSO
-.IM intro (3)
+.MR intro (3)
.SH DIAGNOSTICS
These functions set
.IR errstr .
and
.IR p9alarm ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 253833f64f75abe9eea663c61440159d806af9e2
blob + 3a652d1083c3c860ada40a9ee99ed6f8473040d9
--- man/man3/stat.3
+++ man/man3/stat.3
.EE
.PP
The returned structure is allocated by
-.IM malloc (3) ;
+.MR malloc (3) ;
freeing it also frees the associated strings.
.PP
This structure and
.SH SOURCE
.B \*9/src/lib9/dirstat.c
.SH SEE ALSO
-.IM intro (3) ,
-.IM fcall (3) ,
-.IM dirread (3) ,
+.MR intro (3) ,
+.MR fcall (3) ,
+.MR dirread (3) ,
.IR stat (9p)
.SH DIAGNOSTICS
The
is too short for the returned data, the return value will be
.B BIT16SZ
(see
-.IM fcall (3) )
+.MR fcall (3) )
and the two bytes
returned will contain the initial count field of the
returned data;
blob - 3cf29477876c02510170393f191e0666427295fc
blob + 7dcf51f70664fe11daccd355560f84431b2b555f
--- man/man3/strcat.3
+++ man/man3/strcat.3
returns a pointer to a distinct copy of the null-terminated string
.I s
in space obtained from
-.IM malloc (3)
+.MR malloc (3)
or
.L 0
if no space can be obtained.
.SH SOURCE
.B \*9/src/lib9
.SH SEE ALSO
-.IM memory (3) ,
-.IM rune (3) ,
-.IM runestrcat (3)
+.MR memory (3) ,
+.MR rune (3) ,
+.MR runestrcat (3)
.SH BUGS
These routines know nothing about
.SM UTF.
Use the routines in
-.IM rune (3)
+.MR rune (3)
as appropriate.
Note, however, that the definition of
.SM UTF
blob - 7862bb280553871572e9546e60281684d91a0e4d
blob + 301185f75cde1b01cde3f659e320bc0b0bb4c49f
--- man/man3/string.3
+++ man/man3/string.3
.SH SOURCE
.B \*9/src/libString
.SH SEE ALSO
-.IM bio (3)
+.MR bio (3)
blob - 3ad0054cf0693f28803dbd6b44f6a56a7f434a5e
blob + c0639ab34bff289f73ba13bb2ee298223814d300
--- man/man3/stringsize.3
+++ man/man3/stringsize.3
.SH SOURCE
.B \*9/src/libdraw
.SH "SEE ALSO"
-.IM addpt (3) ,
-.IM cachechars (3) ,
-.IM subfont (3) ,
-.IM draw (3) ,
-.IM draw (3) ,
-.IM image (7) ,
-.IM font (7)
+.MR addpt (3) ,
+.MR cachechars (3) ,
+.MR subfont (3) ,
+.MR draw (3) ,
+.MR draw (3) ,
+.MR image (7) ,
+.MR 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 - e321b7da590398e89d86186d230fb3723ee284cb
blob + 1de30246ef969dc23dceab046699be179f17cd9e
--- man/man3/subfont.3
+++ man/man3/subfont.3
.SH DESCRIPTION
Subfonts are the components of fonts that hold the character images.
A font comprises an array of subfonts; see
-.IM cachechars (3) .
+.MR cachechars (3) .
A new
.B Subfont
is allocated and initialized with
.IR allocsubfont .
See
-.IM cachechars (3)
+.MR cachechars (3)
for the meaning of
.IR n ,
.IR height ,
structure are set to
the passed arguments, and the image is registered as a subfont
with the graphics device
-.IM draw (3) .
+.MR draw (3) .
.I Allocsubfont
returns 0 on failure.
.PP
if
.B f->info
was not allocated by
-.IM malloc (3)
+.MR malloc (3)
it should be zeroed before calling
.IR subffree .
.PP
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
-.IM font (7) .
+.MR font (7) .
Briefly, it contains a image with all the characters in it,
followed by a subfont header, followed by character information.
.I Readsubfont
a call to
.IR writeimage
(see
-.IM allocimage (3) ).
+.MR allocimage (3) ).
.PP
.I Stringsubfont
is analogous to
.B string
(see
-.IM draw (3) )
+.MR draw (3) )
for subfonts. Rather than use the underlying font caching primitives,
it calls
.B draw
.SH SOURCE
.B \*9/src/libdraw
.SH SEE ALSO
-.IM graphics (3) ,
-.IM allocimage (3) ,
-.IM draw (3) ,
-.IM cachechars (3) ,
-.IM image (7) ,
-.IM font (7)
+.MR graphics (3) ,
+.MR allocimage (3) ,
+.MR draw (3) ,
+.MR cachechars (3) ,
+.MR image (7) ,
+.MR font (7)
.SH DIAGNOSTICS
All of the functions use the graphics error function (see
-.IM graphics (3) ).
+.MR graphics (3) ).
blob - 8684ea1271d9362e9f3b4daa4c40abc73d31b47d
blob + 210136a978e8f1c9765b538e39d5f20d10d59039
--- man/man3/sysfatal.3
+++ man/man3/sysfatal.3
prints to standard error the name of the running program,
a colon and a space,
the message described by the
-.IM print (3)
+.MR print (3)
format string
.I fmt
and subsequent arguments, and a newline.
It then calls
-.IM exits (3)
+.MR 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
-.IM arg (3)
+.MR arg (3)
interface to process its arguments.
If
.B argv0
the name of the machine writing the message;
the date and time;
the message specified by the
-.IM print (3)
+.MR print (3)
format
.I fmt
and any following arguments;
.br
.B \*9/src/lib9/syslog.c
.SH "SEE ALSO"
-.IM intro (3) ,
-.IM errstr (3) ,
+.MR intro (3) ,
+.MR errstr (3) ,
the
.B %r
format in
-.IM print (3)
+.MR print (3)
blob - 41ac565f37d9f586837c6dc1a5b435c75c0cddaf
blob + 6c6b4602219ea8402fdb46eb7f07c8176d014f81
--- man/man3/thread.3
+++ man/man3/thread.3
actions using
.B qlocks
(see
-.IM lock (3) )
+.MR lock (3) )
or channel communication.
System calls such as
-.IM read (3)
+.MR read (3)
block the entire proc;
all threads in a proc block until the system call finishes.
.PP
and
.I execl
(see
-.IM exec (3) );
+.MR exec (3) );
on success,
they replace the calling thread
and invoke the external program, never returning.
.I threadexec
will duplicate
(see
-.IM dup (3) )
+.MR dup (3) )
the three file descriptors in
.I fd
onto standard input, output, and error for the external program
returns a channel of pointers to
.B Waitmsg
structures (see
-.IM wait (3) ).
+.MR 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
-.IM malloc (3)
+.MR malloc (3)
and should be freed after use.
.PP
A
.PP
.I Chanprint
formats its arguments in the manner of
-.IM print (3)
+.MR print (3)
and sends the result to the channel
.IR c.
The string delivered by
.I chanprint
is allocated with
-.IM malloc (3)
+.MR malloc (3)
and should be freed upon receipt.
.PP
Thread library functions do not return on failure;
in place of
.I atnotify
(see
-.IM notify (3) ).
+.MR notify (3) ).
.PP
It is safe to use
-.IM sysfatal (3)
+.MR sysfatal (3)
in threaded programs.
.I Sysfatal
will print the error string and call
.SH FILES
.B \*9/acid/thread
contains useful
-.IM acid (1)
+.MR acid (1)
functions for debugging threaded programs.
.PP
.B \*9/src/libthread/test
.SH SOURCE
.B \*9/src/libthread
.SH SEE ALSO
-.IM intro (3) ,
-.IM ioproc (3)
+.MR intro (3) ,
+.MR ioproc (3)
.SH BUGS
To avoid name conflicts,
.IR alt ,
is defined as a macro that expands to
.IR threadyield .
See
-.IM intro (3) .
+.MR intro (3) .
.PP
Threadint,
threadintgrp,
blob - 583a2d7fd1b2dabaa1e9137fed591607d3d56791
blob + 6095c32918b6a32da832d7ac170c6f543e3ed9fc
--- man/man3/time.3
+++ man/man3/time.3
and
.IR p9nsec ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 80142526ee0cb68913580ebd973860621ba1cfde
blob + ebf0b9975eb9d7c422e5bd5822393fa952b9e5f7
--- man/man3/udpread.3
+++ man/man3/udpread.3
.SH SOURCE
.B \*9/src/lib9/udp.c
.SH SEE ALSO
-.IM ip (3)
+.MR ip (3)
blob - 8c2bd33d8d53b1ddca0519452c2682e1e5ef38bd
blob + 15d141ead6d76cfbea4fa3fd54825fd7a401d42a
--- man/man3/venti-cache.3
+++ man/man3/venti-cache.3
allocates a new cache using the client connection
.I z
(see
-.IM venti-conn (3)
+.MR venti-conn (3)
and
-.IM venti-client (3) ),
+.MR venti-client (3) ),
with
.I maxmem
bytes of memory.
function is
.I vtwrite
(see
-.IM venti-client (3) );
+.MR venti-client (3) );
.I vtsetcachewrite
sets it.
.I Vtsetcachewrite
.SH SOURCE
.B \*9/src/libventi
.SH SEE ALSO
-.IM venti (3) ,
-.IM venti-client (3) ,
-.IM venti-conn (3) ,
-.IM venti-file (3) ,
-.IM venti (7)
+.MR venti (3) ,
+.MR venti-client (3) ,
+.MR venti-conn (3) ,
+.MR venti-file (3) ,
+.MR venti (7)
blob - e475ef300a94f1341eb2a6fb62014b674bb535b0
blob + 1f81acaf47411bc2d2e1da4d9d4d8949fbcabe0f
--- man/man3/venti-client.3
+++ man/man3/venti-client.3
extern int ventidoublechecksha1; /* default 1 */
.SH DESCRIPTION
These routines execute the client side of the
-.IM venti (7)
+.MR venti (7)
protocol.
.PP
.I Vtrpc
calls
.I vtversion
(see
-.IM venti-conn (3) )
+.MR venti-conn (3) )
and
.IR vthello ,
in that order, returning success only
and
.I vtrecvproc
as described in
-.IM venti-conn (3) .
+.MR venti-conn (3) .
.SH SOURCE
.B \*9/src/libventi
.SH SEE ALSO
-.IM venti (3) ,
-.IM venti-conn (3) ,
-.IM venti-packet (3) ,
-.IM venti (7)
+.MR venti (3) ,
+.MR venti-conn (3) ,
+.MR venti-packet (3) ,
+.MR venti (7)
.SH DIAGNOSTICS
.I Vtrpc
and
blob - 0c1b95d54ec788853ed874649b07580ad058ea71
blob + ba40ff6ec64c4ee73a9d70f34498ce330be49b5f
--- man/man3/venti-conn.3
+++ man/man3/venti-conn.3
.I Vtdial
dials the given network address
(see
-.IM dial (3) )
+.MR 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
-.IM venti (7) .
+.MR venti (7) .
The negotiated version is stored in
.IB z ->version \fR.
.PP
.I Vtsend
writes a packet
(see
-.IM venti-packet (3) )
+.MR venti-packet (3) )
on the connection
.IR z .
The packet
.I vtsend
will add the two-byte length field
(see
-.IM venti (7) )
+.MR venti (7) )
at the begnning.
.I Vtsend
frees
block until the packet can be written or read from the network.
In a threaded program
(see
-.IM thread (3) ),
+.MR thread (3) ),
this may not be desirable.
If the caller arranges for
.IR vtsendproc
.SH SOURCE
.B \*9/src/libventi
.SH SEE ALSO
-.IM venti (1) ,
-.IM venti (3) ,
-.IM venti-client (3) ,
-.IM venti-packet (3) ,
-.IM venti-server (3) ,
-.IM venti (7)
+.MR venti (1) ,
+.MR venti (3) ,
+.MR venti-client (3) ,
+.MR venti-packet (3) ,
+.MR venti-server (3) ,
+.MR venti (7)
.SH DIAGNOSTICS
Routines that return pointers return nil on error.
Routines returning integers return 0 on success, \-1 on error.
blob - e463c141fbfbc99cba9913edb6d5eca9d4ea5ed2
blob + f721669ec67e99cce8b20f5dea984f52fdc84f4d
--- man/man3/venti-fcall.3
+++ man/man3/venti-fcall.3
.B VtEntry
structure describing a Venti file
(see
-.IM venti (7) )
+.MR venti (7) )
into a 40-byte
.RB ( VtEntrySize )
structure at
.B VtFcall
structure describing a Venti protocol message
(see
-.IM venti (7) )
+.MR venti (7) )
into a packet.
.I Vtfcallunpack
does the reverse conversion.
The fields in a
.B VtFcall
are named after the protocol fields described in
-.IM venti (7) ,
+.MR venti (7) ,
except that the
.B type
field is renamed
The block type enumeration defined in
.B <venti.h>
(presented in
-.IM venti (7) )
+.MR venti (7) )
differs from the one used on disk and in the network
protocol.
The disk and network representation uses different
and
.I vtscorefmt
are
-.IM print (3)
+.MR print (3)
formatters to print
.B VtFcall
structures and scores.
.SH SOURCE
.B \*9/src/libventi
.SH SEE ALSO
-.IM venti (1) ,
-.IM venti (3) ,
-.IM venti (7)
+.MR venti (1) ,
+.MR venti (3) ,
+.MR venti (7)
.SH DIAGNOSTICS
.IR Vtentrypack ,
.IR vtfcallpack ,
blob - 01003f7834c3944b3c3ba6c9d4c928712e8f0f3b
blob + 9f3698c95cec8e28fac57a97af0932e5100c55af
--- man/man3/venti-file.3
+++ man/man3/venti-file.3
.SH DESCRIPTION
These routines provide a simple interface to create and
manipulate Venti file trees (see
-.IM venti (7) ).
+.MR venti (7) ).
.PP
.I Vtfilecreateroot
creates a new Venti file.
.I Vtfilewrite
writes to an in-memory copy of the data blocks
(see
-.IM venti-cache (3) )
+.MR venti-cache (3) )
instead of writing directly to Venti.
.I Vtfileflush
writes all copied blocks associated with
.SH SOURCE
.B \*9/src/libventi/file.c
.SH SEE ALSO
-.IM venti-cache (3) ,
-.IM venti-conn (3) ,
-.IM venti-client (3) ,
-.IM venti (7)
+.MR venti-cache (3) ,
+.MR venti-conn (3) ,
+.MR venti-client (3) ,
+.MR venti (7)
blob - 0d05af2ef8b5d69272ce980374f3e866163481ed
blob + b0a99062bcb960f47d53fc02cd728951172d3409
--- man/man3/venti-log.3
+++ man/man3/venti-log.3
.PP
The server library
(see
-.IM venti-conn (3)
+.MR venti-conn (3)
and
-.IM venti-server (3) )
+.MR venti-server (3) )
writes debugging information to the log named
.IR VtServerLog ,
which defaults to the string
.SH SOURCE
.B \*9/src/libventi
.SH SEE ALSO
-.IM venti (3) ,
-.IM venti (8)
+.MR venti (3) ,
+.MR venti (8)
blob - 6877f0b6817f8f89fc66d2f967725b7e455f1e2f
blob + f9f83fb641a93b64e00b509d6985f58b6ec10a5f
--- man/man3/venti-mem.3
+++ man/man3/venti-mem.3
.SH DESCRIPTION
These routines allocate and free memory.
On failure, they print an error message and call
-.IM sysfatal (3) .
+.MR sysfatal (3) .
They do not return.
.PP
.I Vtbrk
.SH SOURCE
.B \*9/src/libventi
.SH SEE ALSO
-.IM venti (3)
+.MR venti (3)
blob - 0f7386904bc34a2d8a92869d86a8cbcf802416bf
blob + faea58c2c6f1f2550a1ce6e8eaee7dc91fa9b54c
--- man/man3/venti-packet.3
+++ man/man3/venti-packet.3
compares the data sections of two packets as
.I memcmp
(see
-.IM memory (3) )
+.MR memory (3) )
would.
.PP
.I Packetconcat
.SH SOURCE
.B \*9/src/libventi
.SH SEE ALSO
-.IM venti (3)
+.MR venti (3)
.SH DIAGNOSTICS
These functions return errors only when passed
invalid inputs,
blob - 54b8cb4ac8669585cdda3a41d3719253305c8bd1
blob + 0265781aaf51e4d8198206dc408a05ba64862498
--- man/man3/venti-server.3
+++ man/man3/venti-server.3
void vtrespond(VtReq *req)
.SH DESCRIPTION
These routines execute the server side of the
-.IM venti (7)
+.MR venti (7)
protocol.
.PP
.I Vtsrvhello
.SH SOURCE
.B \*9/src/libventi
.SH SEE ALSO
-.IM venti (3) ,
-.IM venti-conn (3) ,
-.IM venti-packet (3) ,
-.IM venti (7) ,
-.IM venti (8)
+.MR venti (3) ,
+.MR venti-conn (3) ,
+.MR venti-packet (3) ,
+.MR venti (7) ,
+.MR venti (8)
blob - 4ee8f940145b970e36f919d197637efde654f7b2
blob + 26bc3fe74969a56945a2fe3b06899eb980e0642c
--- man/man3/venti-zero.3
+++ man/man3/venti-zero.3
.br
.B \*9/src/libventi/zeroscore.c
.SH SEE ALSO
-.IM venti (3) ,
-.IM venti (7)
+.MR venti (3) ,
+.MR venti (7)
blob - 368b70ebf50fb55fb08fc10088ac8cf32007e1f7
blob + f5222fad06dbbfb574896efe3422c0bce6f9f3ae
--- man/man3/venti.3
+++ man/man3/venti.3
.PP
Other manual pages describe the library functions in detail.
.PP
-.IM Venti-cache (3)
+.MR Venti-cache (3)
describes a simple in-memory block cache to help clients.
.PP
-.IM Venti-conn (3)
+.MR Venti-conn (3)
describes routines for manipulating network connections
between Venti clients and servers.
-.IM Venti-client (3)
+.MR Venti-client (3)
and
-.IM venti-server (3)
+.MR venti-server (3)
describe routines for writing clients
and servers on top of these.
.PP
-.IM Venti-fcall (3)
+.MR 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
-.IM Venti-file (3)
+.MR Venti-file (3)
describes routines for writing clients that manipulate
Venti file trees
(see
-.IM venti (7) ).
+.MR venti (7) ).
.PP
-.IM Venti-log (3)
+.MR Venti-log (3)
describes routines to access in-memory log buffers
as well as the logging that is done automatically by
the library.
.PP
-.IM Venti-mem (3)
+.MR Venti-mem (3)
describes wrappers around the canonical
-.IM malloc (3)
+.MR malloc (3)
routines that abort on error.
.PP
-.IM Venti-packet (3)
+.MR Venti-packet (3)
describes routines for
manipulating zero-copy chains of
data buffers.
.PP
-.IM Venti-zero (3)
+.MR Venti-zero (3)
describes routines to zero truncate and zero extend blocks
(see
-.IM venti (7) ).
+.MR venti (7) ).
.SH SOURCE
.B \*9/src/libventi
.SH SEE ALSO
-.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)
+.MR venti (1) ,
+.MR venti-cache (3) ,
+.MR venti-client (3) ,
+.MR venti-fcall (3) ,
+.MR venti-file (3)
+.MR venti-log (3) ,
+.MR venti-mem (3) ,
+.MR venti-packet (3) ,
+.MR venti-server (3) ,
+.MR venti-zero (3) ,
+.MR venti (7) ,
+.MR venti (8)
blob - c51df3c3681e8487e34a6e4c3d62a476b9dbfd3b
blob + 889ccd1fafc0b80ecb8f7119fc2164106b51be78
--- man/man3/wait.3
+++ man/man3/wait.3
.SH DESCRIPTION
.I Wait
causes a process to wait for any child process (see
-.IM fork (2)
+.MR fork (2)
and
-.IM rfork (3) )
+.MR rfork (3) )
to exit.
It returns a
.B Waitmsg
all in units of milliseconds.
.B Msg
contains the message that the child specified in
-.IM exits (3) .
+.MR exits (3) .
For a normal exit,
.B msg[0]
is zero,
The
.B Waitmsg
structure is allocated by
-.IM malloc (3)
+.MR malloc (3)
and should be freed after use.
For programs that only need the pid of the exiting program,
.I waitpid
may be parsed (after appending a NUL) using
.IR tokenize
(see
-.IM getfields (3) );
+.MR getfields (3) );
the resulting fields are, in order, pid, the three times, and the exit string,
which will be
.B ''
.PP
.B \*9/src/lib9/await.c
.SH "SEE ALSO"
-.IM rfork (3) ,
-.IM exits (3) ,
+.MR rfork (3) ,
+.MR exits (3) ,
.SH DIAGNOSTICS
These routines set
.IR errstr .
and
.IR p9waitfor ;
see
-.IM intro (3) .
+.MR intro (3) .
blob - 2663171f530fcf615c0ebf60b6346cc272a9a8f9
blob + b8a6db180a62a7fc084d4944ca5cc7e98169cfdc
--- man/man3/window.3
+++ man/man3/window.3
The refresh methods are
.BR Refbackup ,
which provides backing store and is the method used by
-.IM rio (1)
+.MR rio (1)
for its clients;
.BR Refnone ,
which provides no refresh and is designed for temporary uses
In particular, it is freed by calling
.B freeimage
(see
-.IM allocimage (3) ).
+.MR allocimage (3) ).
The following functions, however, apply only to windows, not regular images.
.PP
.B Bottomwindow
.RI ( scr ).
Their usage is shown in the Examples section.
.PP
-.IM Rio (1)
+.MR Rio (1)
creates its client windows with backing store,
.BR Refbackup .
The graphics initialization routine,
.B initdraw
(see
-.IM graphics (3) ),
+.MR graphics (3) ),
builds a
.B Screen
upon this, and then allocates upon that another window indented
.SH SOURCE
.B \*9/src/libdraw
.SH SEE ALSO
-.IM graphics (3) ,
-.IM draw (3) ,
-.IM cachechars (3) ,
-.IM draw (3)
+.MR graphics (3) ,
+.MR draw (3) ,
+.MR cachechars (3) ,
+.MR draw (3)
.SH BUGS
The refresh method
.B Refmesg
blob - 598a03fbd484abc9d2b6e1d7f9db149612f42ffb
blob + c80db20809c855f2e62052d9bd12bdfd968ade4c
--- man/man4/0intro.4
+++ man/man4/0intro.4
\fImnt\fR(3)
acts as a client to the 9P servers mounted in the current name space,
translating system calls such as
-.IM open (2)
+.MR open (2)
into 9P transactions such as
.IR open (9p).
The kernel also multiplexes the potentially many processes onto a single 9P conversation
file system call interface. Only the Unix name space can be accessed
that way.
Instead, 9P clients use the
-.IM 9pclient (3)
+.MR 9pclient (3)
library to connect and interact directly with particular 9P servers.
The
-.IM 9p (1)
+.MR 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
-.IM 9pserve (4) ,
+.MR 9pserve (4) ,
typically via
-.IM post9pservice (3) .
+.MR post9pservice (3) .
.I 9pserve
announces a 9P service at a particular
network address and multiplexes the clients that connect to
.B $NAMESPACE
environment variable overrides this default.
The
-.IM namespace (1)
+.MR namespace (1)
command prints the current name space directory.
.PP
Occasionally it is useful to be able to connect the input or output
(see also
.I fsopenfd
in
-.IM 9pclient (3) )
+.MR 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 - 5bcafe52a6a14b7ce6a1667df005917bfdbb6ae3
blob + 6ddff346c275d075e6862f067fdfc991a6c34f0d
--- man/man4/9import.4
+++ man/man4/9import.4
on a remote
.I system,
with the capability of running the Plan 9
-.IM exportfs (4)
+.MR exportfs (4)
service,
to be imported into the local name space.
Usually
remote machine, with authority of the user of
.IR 9import ,
to perform work for the local machine using the
-.IM exportfs (4)
+.MR exportfs (4)
service.
The default port used is TCP 17007.
If
.I keypattern
to select a key to authenticate to the remote side
(see
-.IM auth (2) ).
+.MR auth (2) ).
.TP
.B -p
Push the
-.IM aan (8)
+.MR aan (8)
filter onto the connection to protect against
temporary network outages.
.TP
.SH SOURCE
.B \*9/src/cmd/9import.c
.SH SEE ALSO
-.IM srv (4) ,
-.IM aan (8) ,
-.IM listen1 (8) ,
+.MR srv (4) ,
+.MR aan (8) ,
+.MR listen1 (8) ,
.B cs
in
-.IM ndb (7)
+.MR ndb (7)
.SH BUGS
Encryption is not implemented.
blob - 7eaa975f0de1ecc40ba2f4a42173447ff725cf6d
blob + 7f691b588c833b3da6694e1fa223a5a41bbf606d
--- man/man4/9pserve.4
+++ man/man4/9pserve.4
.PP
.I 9pserve
is typically not invoked directly; use
-.IM post9pservice (3)
+.MR post9pservice (3)
instead.
.PP
The options are:
and
.IR afid ;
used to implement
-.IM srv (4) 's
+.MR srv (4) 's
.B -a
option
.TP
.IR msize
.PD
.SH "SEE ALSO
-.IM intro (4) ,
+.MR intro (4) ,
.IR intro (9p),
-.IM 9pfuse (4)
+.MR 9pfuse (4)
.SH SOURCE
.B \*9/src/cmd/9pserve.c
blob - 1ed287fb3bb5198eadc8f36b9d3de606395ece0f
blob + a285b3b8954ba5773766573124da4ed6ac3673b9
--- man/man4/acme.4
+++ man/man4/acme.4
\&... ]
.SH DESCRIPTION
The text window system
-.IM acme (1)
+.MR acme (1)
serves a variety of files for reading, writing, and controlling
windows.
Some of them are virtual versions of system files for dealing
a directory holding these files is posted as the 9P service
.B acme
(using
-.IM 9pserve (4) ).
+.MR 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
is a subdirectory used by
.B win
(see
-.IM acme (1) )
+.MR acme (1) )
as a mount point for the
.I acme
files associated with the window in which
.SH SOURCE
.B \*9/src/cmd/acme
.SH SEE ALSO
-.IM rio (1) ,
-.IM acme (1)
+.MR rio (1) ,
+.MR acme (1)
blob - 453965df9c24da588f0265ec1fe59b7f28b8afac
blob + 02466fcfb1a0f0bac1abdd1095b30f90253112dc
--- man/man4/factotum.4
+++ man/man4/factotum.4
passwords in the clear.
.TP
.B vnc
-.IM vnc (1) 's
+.MR vnc (1) 's
challenge/response.
.TP
.B wep
key from NVRAM using
.B readnvram
(see
-.IM authsrv (3) ),
+.MR authsrv (3) ),
prompting for anything it needs.
It will never subsequently prompt for a
key that it doesn't have.
.PP
All keys can have additional attibutes that act either as comments
or as selectors to distinguish them in the
-.IM auth (3)
+.MR auth (3)
library calls.
.PP
The factotum owner can use any key stored by factotum.
and
.B auth_challenge
(see
-.IM auth (3) )
+.MR 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
.IB attribute = value
option.
.PP
By default when factotum starts it looks for a
-.IM secstore (1)
+.MR secstore (1)
account on $auth for the user and, if one exists,
prompts for a secstore password in order to fetch
the file
generated by
.B ssh_genkey
(see
-.IM ssh (1) ).
+.MR ssh (1) ).
.PD
.SS "Confirming key use
.PP
if successful, reading back an
.I AuthInfo
structure (see
-.IM authsrv (3) ).
+.MR authsrv (3) ).
.PP
The RPC protocol is normally embodied by one of the
routines in
-.IM auth (3) .
+.MR auth (3) .
We describe it here should anyone want to extend
the library.
.PP
authentication has succeeded, an
.B AuthInfo
structure (see
-.IM auth (3) )
+.MR auth (3) )
can be retrieved with an
.B authinfo
RPC
are intended to be proxied via
.I auth_proxy
(see
-.IM auth (3) ).
+.MR auth (3) ).
.\" The protocols follow
.\" .IR p9any (7)
.\" and
.PP
.I Vnc
is the challenge-response protocol used by
-.IM vnc (1) ;
+.MR vnc (1) ;
valid roles are
.B client
and
that can be parsed with
.I tokenize
(see
-.IM getfields (3) ).
+.MR getfields (3) ).
Conventionally, client keys have distinguishing attributes
like
.B service
.BR !dk
specifying the private half of the key;
see
-.IM rsa (3) .
+.MR rsa (3) .
Conventionally,
.I rsa
keys also have
If the key is to be used for signing, it must also have a
.B !secret
attribute; see
-.IM dsa (3) .
+.MR dsa (3) .
Conventionally,
.I dsa
keys
.SH SOURCE
.B \*9/src/cmd/auth/factotum
.SH SEE ALSO
-.IM ssh-agent (1)
+.MR ssh-agent (1)
blob - a270b2f10e767b3d888cde1b5b40e55c5d77e75e
blob + 6cc0d0a7dc62a53e049c5c15993569236d362215
--- man/man4/fontsrv.4
+++ man/man4/fontsrv.4
presents the host window system's fonts
in the standard Plan 9 format
(see
-.IM font (7) ).
+.MR font (7) ).
It serves a virtual directory tree mounted at
.I mtpt
(if the
.PP
.I Openfont
(see
-.IM graphics (3) )
+.MR graphics (3) )
recognizes font paths beginning with
.B /mnt/font
and implements them by invoking
.IR fontsrv ;
it need not be running already.
See
-.IM font (7)
+.MR font (7)
for a full discussion of font name syntaxes.
.SH EXAMPLES
List the fonts on the system:
.EE
.LP
Run
-.IM acme (1)
+.MR acme (1)
using the operating system's Monaco as the fixed-width font:
.IP
.EX
.EE
.LP
Run
-.IM sam (1)
+.MR sam (1)
using the same font:
.IP
.EX
.SH SOURCE
.B \*9/src/cmd/fontsrv
.SH SEE ALSO
-.IM font (7)
+.MR font (7)
.SH BUGS
.PP
Due to OS X restrictions,
blob - 6072a39a1c4fb0c650c3dce47adcb04ed2bd439d
blob + fd6dd0a9af70e299bf877542a20087e60664d375
--- man/man4/fossil.4
+++ man/man4/fossil.4
The attach name used in
.I mount
(see
-.IM bind (1) ,
-.IM bind (2)
+.MR bind (1) ,
+.MR bind (2)
and
-.IM attach (5) )
+.MR attach (5) )
selects a file system to be served
and optionally a subtree,
in the format
normally requires all users except
.L none
to provide authentication tickets on each
-.IM attach (5) .
+.MR attach (5) .
To keep just anyone from connecting,
.L none
is only allowed to attach after another user
or
.B srv
(see
-.IM fossilcons (8) ).
+.MR fossilcons (8) ).
.PP
The groups called
.B noworld
starts a new instance of the fossil file server.
It is configured mainly through console commands,
documented in
-.IM fossilcons (8) .
+.MR fossilcons (8) .
.PP
The options are:
.TF "-c\fI cmd
which starts a file server console on
.BI /srv/ cons \fR.
See
-.IM fossilcons (8)
+.MR fossilcons (8)
for more information.
.TP
.BI -f " file
is deprecated in favor of the console
.B check
command (see
-.IM fossilcons (8) ).
+.MR fossilcons (8) ).
.I Flchk
prints
.I fossil
The score should have been generated by
.I fossil
rather than by
-.IM vac (1) ,
+.MR vac (1) ,
so that the appropriate snapshot metadata is present.
.PD
.PP
and
.B uname
commands in
-.IM fossilcons (8)
+.MR fossilcons (8)
for more about the user table.
.ne 3
.PP
.SH SOURCE
.B \*9/src/cmd/fossil
.SH SEE ALSO
-.IM yesterday (1) ,
-.IM fs (3) ,
-.IM fs (4) ,
-.IM srv (4) ,
-.IM fossilcons (8) ,
-.IM loadfossil (8) ,
-.IM venti (8)
+.MR yesterday (1) ,
+.MR fs (3) ,
+.MR fs (4) ,
+.MR srv (4) ,
+.MR fossilcons (8) ,
+.MR loadfossil (8) ,
+.MR 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 - 7d67a449394d277058826d99aa75a0d09c439987
blob + 434a23bd071d621c375e3cb49a540301120bd990
--- man/man4/import.4
+++ man/man4/import.4
connects to
.I system
using
-.IM ssh (1) .
+.MR ssh (1) .
It invokes
.I import
on the remote system to carry out the remote
.SH SOURCE
.B \*9/src/cmd/import.c
.SH SEE ALSO
-.IM 9pserve (4) ,
-.IM intro (4)
+.MR 9pserve (4) ,
+.MR intro (4)
blob - a86f032a0de0c0196dfe744bfce5f7f8f9cbbba1
blob + c309a39c2696cfb5a8e16fd8d482145413249f8a
--- man/man4/plumber.4
+++ man/man4/plumber.4
The
.I plumber
is a user-level file server that receives, examines, rewrites, and dispatches
-.IM plumb (7)
+.MR plumb (7)
messages between programs.
Its behavior is programmed by a
.I plumbing
file (default
.BR $HOME/lib/plumbing )
in the format of
-.IM plumb (7) .
+.MR plumb (7) .
.PP
Its services are posted via
-.IM 9pserve (4)
+.MR 9pserve (4)
as
.BR plumb ,
and consist of two
Programs use
.B fswrite
(see
-.IM 9pclient (3) )
+.MR 9pclient (3) )
to deliver messages to the
.B send
file, and
.I fsread
to receive them from the corresponding port.
For example,
-.IM sam (1) 's
+.MR sam (1) 's
.B plumb
menu item or the
.B B
.TP
.B plumb
mount name for
-.IM plumber (4) .
+.MR plumber (4) .
.SH SOURCE
.B \*9/src/cmd/plumb
.SH "SEE ALSO"
-.IM plumb (1) ,
-.IM plumb (3) ,
-.IM plumb (7)
+.MR plumb (1) ,
+.MR plumb (3) ,
+.MR plumb (7)
.\" .SH BUGS
.\" .IR Plumber 's
.\" file name space is fixed, so it is difficult to plumb
blob - 20e72b3859d0dc5ff76b555e2ec732052604b27c
blob + 794519810dd2d8c7926c497a8d2e88ae476632cd
--- man/man4/ramfs.4
+++ man/man4/ramfs.4
posts its service as
.B ramfs
using
-.IM 9pserve (4) .
+.MR 9pserve (4) .
.PP
The
.B -S
.SH SOURCE
.B \*9/src/cmd/ramfs.c
.SH "SEE ALSO"
-.IM 9p (3) ,
-.IM 9pserve (4)
+.MR 9p (3) ,
+.MR 9pserve (4)
blob - fdea4e470a885dd9ffe7d97d4ff9de046aa0230b
blob + be3404b1b50c7c80010172d15d682285464d0b22
--- man/man4/smugfs.4
+++ man/man4/smugfs.4
stored on the SmugMug photo sharing service.
It logs in after
obtaining a password from
-.IM factotum (4)
+.MR factotum (4)
using
.B server=smugmug.com
and
(if any)
as key criteria
(see
-.IM auth (3) ).
+.MR auth (3) ).
Then
.I smugfs
serves a virtual directory tree mounted at
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
-.IM mv (1)
+.MR mv (1)
will resolve the problem.
.PP
Boolean values appear as
blob - 469b2b4ca53457109be82193b7667fe55ccdf677
blob + ae6a7634996bc52cbb82001a5fca51d67e49872b
--- man/man4/srv.4
+++ man/man4/srv.4
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
-.IM intro (4) )
+.MR intro (4) )
as
.I srvname
(default
.IR sources .
.I 9fs
is an
-.IM rc (1)
+.MR rc (1)
script; examine it to see what local conventions apply.
.SH EXAMPLES
List the root directory on
.br
.B \*9/bin/9fs
.SH "SEE ALSO
-.IM dial (3) ,
-.IM intro (4) ,
-.IM netfiles (1)
+.MR dial (3) ,
+.MR intro (4) ,
+.MR netfiles (1)
blob - b8843173abae4e733ebc107104aa7ba69e393fe9
blob + 669cc819bc0fa02d4d15f98a10c9d061c536a7f2
--- man/man4/tapefs.4
+++ man/man4/tapefs.4
.PP
.I Zipfs
interprets zip archives (see
-.IM gzip (1) ).
+.MR gzip (1) ).
.SH SOURCE
.PP
These commands are constructed in a highly stereotyped
.BR \*9/src/cmd/tapefs ,
which in
turn derive substantially from
-.IM ramfs (4) .
+.MR ramfs (4) .
.SH "SEE ALSO
-.IM intro (7) ,
-.IM ramfs (4) .
+.MR intro (7) ,
+.MR ramfs (4) .
blob - 0c92ff60c14ead8d8358cff730d3e33455f13100
blob + f3287e3599d89164ae489b8bbacac59c449f5b77
--- man/man4/vacfs.4
+++ man/man4/vacfs.4
.SH DESCRIPTION
.I Vacfs
interprets the file system created by
-.IM vac (1)
+.MR 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
.SH SOURCE
.B \*9/src/cmd/vac
.SH "SEE ALSO"
-.IM vac (1) ,
+.MR vac (1) ,
Plan 9's
.IR venti (8)
blob - 7e9a39b771492822bb17c4cf73dfa3cd40720f2b
blob + 917c252173ce4aacdafedb85fd061079f858b6ec
--- man/man7/color.7
+++ man/man7/color.7
The alpha is
.I premultiplied
into the other channels, as described in the paper by Porter and Duff cited in
-.IM draw (3) .
+.MR draw (3) .
The function
.B setalpha
(see
-.IM allocimage (3) )
+.MR allocimage (3) )
aids the initialization of color values with non-trivial alpha.
.PP
The packing of pixels into bytes and words is odd.
.PP
To maintain a constant external representation,
the
-.IM draw (3)
+.MR draw (3)
interface
as well as the
various graphics libraries represent colors
by 32-bit numbers, as described in
-.IM color (3) .
+.MR color (3) .
.SH "SEE ALSO"
-.IM color (3) ,
-.IM graphics (3) ,
-.IM draw (3)
+.MR color (3) ,
+.MR graphics (3) ,
+.MR draw (3)
blob - a69aac98938c5029d3c44c934e81c5cc81150506
blob + 8cd378257a1975b5003947fe973ac11bd649123a
--- man/man7/face.7
+++ man/man7/face.7
The large files serve no special purpose; they are stored
as images
(see
-.IM image (7) ).
+.MR image (7) ).
The small files are the `icons' displayed by
.B faces
and
.B .dict
files.
.SH "SEE ALSO"
-.IM mail (1) ,
-.IM tweak (1) ,
-.IM image (7)
+.MR mail (1) ,
+.MR tweak (1) ,
+.MR image (7)
blob - a11ca53c8092800fe7528d11bc2a672ce12f2080
blob + c9ebb9197fb337f416486ae057c3987a8b53e711
--- man/man7/font.7
+++ man/man7/font.7
.B #include <draw.h>
.SH DESCRIPTION
Fonts and subfonts are described in
-.IM cachechars (3) .
+.MR cachechars (3) .
.PP
External bitmap fonts are described by a plain text file that can be read using
.IR openfont .
and the file name names an external file suitable for
.I readsubfont
(see
-.IM graphics (3) ).
+.MR graphics (3) ).
The minimum number of a covered range is mapped to the specified starting position
(default zero) of the
corresponding subfont.
and
.I writesubfont
(see
-.IM subfont (3) ).
+.MR 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
-.IM image (7) .
+.MR image (7) .
The subfont header has 3
decimal strings:
.BR n ,
.PP
Note that the convention of using the character with value zero (NUL) to represent
characters of zero width (see
-.IM draw (3) )
+.MR draw (3) )
means that fonts should have, as their zeroth character,
one with non-zero width.
.SS "Font Names
.B .
lists the available fonts.
See
-.IM fontsrv (4)
+.MR fontsrv (4)
for more.
.PP
If the font name has the form
When used on screens with pixel density above 200 DPI,
the bitmap fonts are automatically pixel doubled.
Similarly, fonts loaded from
-.IM fontsrv (4)
+.MR fontsrv (4)
are automatically doubled in size by varying the effective
.I size
path element.
.B \*9/font/*
font directories
.SH "SEE ALSO"
-.IM graphics (3) ,
-.IM draw (3) ,
-.IM cachechars (3) ,
-.IM subfont (3)
+.MR graphics (3) ,
+.MR draw (3) ,
+.MR cachechars (3) ,
+.MR subfont (3)
blob - 56874b1bb6b32d64721d1075b7dce4a38bd5a93a
blob + 34f2cc5bddc1492474c718cfc22d4cc12700dc06
--- man/man7/htmlroff.7
+++ man/man7/htmlroff.7
.SH NAME
htmlroff \- HTML formatting and typesetting
.SH DESCRIPTION
-.IM Htmlroff (1)
+.MR Htmlroff (1)
accepts
.I troff
input with a few extensions and changes.
.B <sub>
tags.
This heuristic handles simple equations formatted by
-.IM eqn (1) .
+.MR eqn (1) .
.SS Conditional input
.PP
To make it easier to write input files that can be formatted by both
redefines the
.B PS
macro that marks the beginning of a
-.IM pic (1)
+.MR pic (1)
picture:
.IP
.EX
blob - b412742fcb8b078bd6910078763815b725639b7a
blob + bfb299bd351f7121839cc6461dc269b97dc138a4
--- man/man7/image.7
+++ man/man7/image.7
.B #include <draw.h>
.SH DESCRIPTION
Images are described in
-.IM graphics (3) ,
+.MR graphics (3) ,
and the definition of pixel values is in
-.IM color (7) .
+.MR color (7) .
Fonts and images are stored in external files
in machine-independent formats.
.PP
and
.B writememimage
(see
-.IM memdraw (3) ).
+.MR memdraw (3) ).
An uncompressed image file starts with 5
strings:
.BR chan ,
(see
.B strtochan
in
-.IM graphics (3)
+.MR graphics (3)
and the discussion of channel descriptors below),
and the rectangle coordinates are decimal strings.
The rest of the file contains the
and
.B unloadimage
functions described in
-.IM allocimage (3)
+.MR 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,
.B 'r8g8b8'
pixels have byte ordering blue, green, and red within the file.
See
-.IM color (7)
+.MR color (7)
for more details of the pixel format.
.PP
A venerable yet deprecated format replaces the channel string
(see Plan 9's
.IR faces (1)
and
-.IM face (7) )
+.MR 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
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
-.IM tweak (1) .)
+.MR 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"
-.IM jpg (1) ,
-.IM tweak (1) ,
-.IM graphics (3) ,
-.IM draw (3) ,
-.IM allocimage (3) ,
-.IM color (7) ,
-.IM face (7) ,
-.IM font (7)
+.MR jpg (1) ,
+.MR tweak (1) ,
+.MR graphics (3) ,
+.MR draw (3) ,
+.MR allocimage (3) ,
+.MR color (7) ,
+.MR face (7) ,
+.MR font (7)
blob - 56c0d3aeea8a5c67ac6a32503457de825a29d6b4
blob + 69094a221dc6f16dcb6879026070a5e94e6860a3
--- man/man7/keyboard.7
+++ man/man7/keyboard.7
.PP
The down arrow,
used by
-.IM 9term (1) ,
-.IM acme (1) ,
+.MR 9term (1) ,
+.MR acme (1) ,
and
-.IM sam (1) ,
+.MR sam (1) ,
causes windows to scroll forward.
The up arrow scrolls backward.
.PP
Characters in Plan 9 are runes (see
-.IM utf (7) ).
+.MR 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:
The full list is too long to repeat here, but is contained in the file
.L \*9/lib/keyboard
in a format suitable for
-.IM grep (1)
+.MR grep (1)
or
-.IM look (1) .
+.MR look (1) .
To add a sequence, edit that file and then rebuild
-.IM devdraw (1) .
+.MR devdraw (1) .
.PP
There are several rules guiding the design of the sequences, as
illustrated by the following examples.
sorted table of characters and keyboard sequences
.PD
.SH "SEE ALSO"
-.IM intro (1) ,
-.IM ascii (1) ,
-.IM tcs (1) ,
-.IM 9term (1) ,
-.IM acme (1) ,
-.IM sam (1) ,
-.IM utf (7)
+.MR intro (1) ,
+.MR ascii (1) ,
+.MR tcs (1) ,
+.MR 9term (1) ,
+.MR acme (1) ,
+.MR sam (1) ,
+.MR utf (7)
blob - 98fae1c3edb23b4434bfd39f945e04373fce125c
blob + f82a1bc7c87c613441516849ae4782cc1b258f56
--- man/man7/man.7
+++ man/man7/man.7
The
.B -man
macros admit equations and tables in the style of
-.IM eqn (1)
+.MR eqn (1)
and
-.IM tbl (1) ,
+.MR tbl (1) ,
but do not support arguments on
.B .EQ
and
.B \*9/tmac/tmac.antimes
.SH SEE ALSO
.IR troff (1),
-.IM man (1)
+.MR man (1)
.SH REQUESTS
.ta \w'.TH n c x 'u +\w'Cause 'u +\w'Argument\ 'u
.di xx
blob - 72925e414db3b0c3953058a31a933dc7a77c49dc
blob + ced8db491e44d2f12662aaad1315b40cef637772
--- man/man7/map.7
+++ man/man7/map.7
Both the map file and the index file are ordered by
patch latitude and longitude.
.SH "SEE ALSO"
-.IM map (7)
+.MR map (7)
.br
The data comes from the World Data Bank I and II and
U.S. Government sources: the Census Bureau, Geological
blob - 95439641ffc1f27f6ba9528399b818a1b498f827
blob + f561fb43a808df220684a434f86dfa0a61093cba
--- man/man7/mhtml.7
+++ man/man7/mhtml.7
\&...
.SH DESCRIPTION
This package of
-.IM htmlroff (1)
+.MR htmlroff (1)
macro definitions provides convenient macros for formatting HTML.
It is usually used along with
-.IM troff (1)
+.MR troff (1)
macro packages such as
-.IM man (7)
+.MR man (7)
and
-.IM ms (7) .
+.MR ms (7) .
.I Mhtml
replaces some macros defined in the other packages,
so it should be listed after them on the
Accumulate footnotes and print them at the end of the
document under a \fBNotes\fP heading.
These replace the macros in
-.IM ms (7) .
+.MR ms (7) .
To emit the notes accumulated so far, invoke
.BR .NOTES .
.TP
.B .PE
with a PNG image corresponding to the output of
running
-.IM troff (1)
+.MR troff (1)
on the input.
.TP
.B .TS\fR, \fP.TE
.SH FILES
.B \*9/tmac/tmac.html
.SH SEE ALSO
-.IM htmlroff (1) ,
-.IM htmlroff (7) ,
-.IM ms (7)
+.MR htmlroff (1) ,
+.MR htmlroff (7) ,
+.MR ms (7)
blob - c6eaf555cad5d304706e48556c2c7efb7bfe1a68
blob + 5da1d547af368b4b230efbf70994b8bbff20a44c
--- man/man7/mpictures.7
+++ man/man7/mpictures.7
.SH DESCRIPTION
.I Mpictures
macros insert PostScript pictures into
-.IM troff (1)
+.MR troff (1)
documents.
The macros are:
.TP
assumed to fill an 8.5\(mu11-inch page.
Nothing prevents the picture from being placed off the page.
.SH SEE ALSO
-.IM troff (1)
+.MR troff (1)
.SH DIAGNOSTICS
A picture file that can't be read by the PostScript
postprocessor is replaced by white space.
blob - 7d50c89acd85f316a982da8d8d8483600e4301e9
blob + 5886a7e19e932c11009f8e759ae6aa226c8a8804
--- man/man7/ms.7
+++ man/man7/ms.7
This package of
.I nroff
and
-.IM troff (1)
+.MR troff (1)
macro definitions provides a canned formatting
facility for tech%nical papers in various formats.
.PP
.LR .na .
.PP
Output of the
-.IM eqn (1) ,
-.IM tbl (1) ,
-.IM pic (1)
+.MR eqn (1) ,
+.MR tbl (1) ,
+.MR pic (1)
and
-.IM grap (1)
+.MR grap (1)
preprocessors
for equations, tables, pictures, and graphs is acceptable as input.
.SH FILES
.br
.IR eqn (1),
.IR troff (1),
-.IM tbl (1) ,
-.IM pic (1)
+.MR tbl (1) ,
+.MR pic (1)
.SH REQUESTS
.ta \w'..ND \fIdate\fR 'u +\w'Initial 'u +\w'Cause 'u
.br
produced by
.I neqn
or
-.IM eqn (1) .
+.MR eqn (1) .
.ti0
\fL\&.EQ\fP \fIx y\fR - yes Display equation.
Equation number is
\fL\&.P2\fP - yes End program display.
.ti0
\fL\&.PE\fP - yes End picture; see
-.IM pic (1) .
+.MR pic (1) .
.ti0
\fL\&.PF\fP - yes End picture; restore vertical
position.
Default is 5 10 15 ...
.ti0
\fL\&.TE\fP - yes End table; see
-.IM tbl (1) .
+.MR tbl (1) .
.ti0
\fL\&.TH\fP - yes End heading section of table.
.ti0
blob - 9ab448fe50235e3443f7a46cf7e8e89785011f12
blob + bb59d8aab7c7c88b3ef9afdd91be18dc62bbcc6e
--- man/man7/ndb.7
+++ man/man7/ndb.7
pairs on different lines.
.PP
Programs search the database directly using the routines in
-.IM ndb (3) .
+.MR ndb (3) .
.\" or indirectly using
.\" .B ndb/cs
.\" and
first database file searched
.SH "SEE ALSO"
.\" .IR dial (2),
-.IM ndb (1) ,
-.IM ndb (3)
+.MR ndb (1) ,
+.MR ndb (3)
.\" .IR dhcpd (8),
.\" .IR ipconfig (8),
.\" .IR con (1)
blob - 31cb41a007b5771869d70d301fa507e4835a53ec
blob + 87308b3f20ca9714b1a85effae4f5b3e30463932
--- man/man7/plot.7
+++ man/man7/plot.7
.PD
.SH "SEE ALSO"
.IR plot (1),
-.IM graph (1)
+.MR graph (1)
blob - 446b4340adbce2a2efe793dd2a9dd80612b1f259
blob + 37b2385b5348d2c21dcb52f37fb53ae32483a3bb
--- man/man7/plumb.7
+++ man/man7/plumb.7
.SH DESCRIPTION
.SS "Message format
The messages formed by the
-.IM plumb (3)
+.MR plumb (3)
library are formatted for transmission between
processes into textual form, using newlines to separate
the fields.
The
.B plumber
(see
-.IM plumb (1) )
+.MR plumb (1) )
receives messages on its
.B send
port (applications
.RE
.PP
The arguments to all rules may contain quoted strings, exactly as in
-.IM rc (1) .
+.MR 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
.B $plan9
The root directory of the Plan 9 tree
(see
-.IM get9root (3) ).
+.MR get9root (3) ).
.RE
.SH EXAMPLE
The following is a modest, representative file of plumbing rules.
.TP
.B plumb
service name for
-.IM plumber (4) .
+.MR plumber (4) .
.TP
.B \*9/plumb
directory for
.B \*9/plumb/basic
basic rule set.
.SH "SEE ALSO"
-.IM plumb (1) ,
-.IM plumb (3) ,
-.IM plumber (4) ,
-.IM regexp (7)
+.MR plumb (1) ,
+.MR plumb (3) ,
+.MR plumber (4) ,
+.MR regexp (7)
blob - dbc5a9a16f25ba631927e84aca313e53af11a0e8
blob + 73fd4dded6e2d5fa3fe3e8ea862608b9f3361c78
--- man/man7/regexp.7
+++ man/man7/regexp.7
.SH DESCRIPTION
This manual page describes the regular expression
syntax used by the Plan 9 regular expression library
-.IM regexp (3) .
+.MR regexp (3) .
It is the form used by
-.IM egrep (1)
+.MR egrep (1)
before
.I egrep
got complicated.
extends as far as possible without preventing
a match to the remainder of the regular expression.
.SH "SEE ALSO"
-.IM regexp (3)
+.MR regexp (3)
blob - 4d90f43771334f4ab6231892211f0850fe509434
blob + 5a4b933babeaaf32252b5cf240a38ac272c0f691
--- man/man7/thumbprint.7
+++ man/man7/thumbprint.7
and
.B okThumbprint
(see
-.IM pushtls (3) ),
+.MR 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
x509 sha1=8fe472d31b360a8303cd29f92bd734813cbd923c cn=*.cs.bell-labs.com
.EE
.SH "SEE ALSO"
-.IM pushtls (3)
+.MR pushtls (3)
blob - 0a963c8cd7b5b95abd90e8711183ec943eb6eae4
blob + 5ad61764ad20ea1e414fd9845ee51266892381fa
--- man/man7/utf.7
+++ man/man7/utf.7
.SM ASCII
input.
See
-.IM rune (3) .
+.MR rune (3) .
.PP
Letting numbers be binary,
a rune x is converted to a multibyte
any sequence except those described above
is incorrect and is converted to rune hexadecimal 0080.
.SH "SEE ALSO"
-.IM ascii (1) ,
-.IM tcs (1) ,
-.IM rune (3) ,
+.MR ascii (1) ,
+.MR tcs (1) ,
+.MR rune (3) ,
.IR "The Unicode Standard" .
blob - 960920fcd4771ff6a8774c59eff898930c961128
blob + 800c85f3bb67d1eb5f83d6f4d219277c77bfa9ef
--- man/man7/venti.7
+++ man/man7/venti.7
This manual page documents the basic concepts of
block storage using Venti as well as the Venti network protocol.
.PP
-.IM Venti (1)
+.MR Venti (1)
documents some simple clients.
-.IM Vac (1) ,
-.IM vacfs (4) ,
+.MR Vac (1) ,
+.MR vacfs (4) ,
and
-.IM vbackup (8)
+.MR vbackup (8)
are more complex clients.
.PP
-.IM Venti (3)
+.MR Venti (3)
describes a C library interface for accessing
Venti servers and manipulating Venti data structures.
.PP
-.IM Venti (8)
+.MR Venti (8)
describes the programs used to run a Venti server.
.PP
.SS "Scores
prefix, typically used to
describe the format of the data.
For example,
-.IM vac (1)
+.MR vac (1)
uses a
.B vac:
prefix, while
-.IM vbackup (8)
+.MR vbackup (8)
uses prefixes corresponding to the file system
types:
.BR ext2: ,
but makes it possible for general programs like
.I venti/copy
(see
-.IM venti (1) )
+.MR venti (1) )
to traverse the block tree without knowing the specific details
of any particular program's data.
.SS "Block Types
using a two-byte count with
the text itself stored as a UTF-encoded sequence
of Unicode characters (see
-.IM utf (7) ).
+.MR utf (7) ).
Text strings are not
.SM NUL\c
-terminated:
and
.I vtfromdisktype
(see
-.IM venti (3) )
+.MR venti (3) )
to convert a block type enumeration value
.RB ( VtDataType ,
etc.)
packet may be either 2 or 4 bytes;
the total packet length distinguishes the two cases.
.SH SEE ALSO
-.IM venti (1) ,
-.IM venti (3) ,
-.IM venti (8)
+.MR venti (1) ,
+.MR venti (3) ,
+.MR venti (8)
.br
Sean Quinlan and Sean Dorward,
``Venti: a new approach to archival storage'',
blob - 49a42e094bb75f9a7064377fba6ca329c1081ae0
blob + 8ad9d4beb5b7b3ab4a0e549bc982abc11cb3a15a
--- man/man8/fossilcons.8
+++ man/man8/fossilcons.8
.SH DESCRIPTION
These are configuration and maintenance commands
executed at the console of a
-.IM fossil (4)
+.MR fossil (4)
file server.
The commands are split into three groups above:
file server configuration,
.I 9p
executes a 9P transaction; the arguments
are in the same format used by
-.IM 9pcon (8) .
+.MR 9pcon (8) .
.PP
.I Bind
behaves similarly to
-.IM bind (1) .
+.MR bind (1) .
It is useful when fossil
is started without devices it needs configured
into its namespace.
.PP
.I Echo
behaves identically to
-.IM echo (1) ,
+.MR echo (1) ,
writing to the console.
.PP
.I Listen
.TP
.I leader
the group's leader (see Plan 9's
-.IM stat (5)
+.MR stat (5)
for a description of the special privileges held by a group leader)
.TP
.I members
A subsequent
.I flchk
(see
-.IM fossil (4) )
+.MR fossil (4) )
will identify the abandoned storage so it can be reclaimed with
.I bfree
commands.
recording it in
.BI /snapshot/ yyyy / mmdd / hhmm \fR,
as described in
-.IM fossil (4) .
+.MR fossil (4) .
The
.B -a
flag causes
to take an archival snapshot, recording it in
.BI /archive/ yyyy / mmdd \fR,
also described in
-.IM fossil (4) .
+.MR fossil (4) .
By default the snapshot is taken of
.BR /active ,
the root of the active file system.
.PP
.I Vac
prints the Venti score for a
-.IM vac (1)
+.MR vac (1)
archive containing the tree rooted
at
.IR dir ,
blob - 02c774f578681af1087a3f5f822bbd665c7bc259
blob + 776a17aa218db25111fc52976e9d11beea065b59
--- man/man8/getflags.8
+++ man/man8/getflags.8
names of its arguments.
.I Getflags
prints an
-.IM rc (1)
+.MR rc (1)
script on standard output which initializes the
environment variable
.BI $flag x
.BR $0 ,
the program name
(see
-.IM rc (1) ).
+.MR rc (1) ).
If run under
-.IM sh (1) ,
+.MR 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
-.IM leak (1) :
+.MR leak (1) :
.IP
.EX
flagfmt='b,s,f binary,r res,x width'
.br
.B \*9/src/cmd/usage.c
.SH SEE ALSO
-.IM arg (3)
+.MR arg (3)
blob - 2de33f1fca0545a23ebad43d6e3665966c742bfb
blob + 98f560f3217ef4e17af8d4eb3cc507e1ae587885
--- man/man8/listen1.8
+++ man/man8/listen1.8
.SH SOURCE
.B \*9/src/cmd/listen1.c
.SH "SEE ALSO"
-.IM dial (3)
+.MR dial (3)
blob - fb4fa2e606ff566e6df7954be89f8312d62539f2
blob + 073e55b2fa2f5e036e7a1745109a9fdd0cf3eba2
--- man/man8/mkfs.8
+++ man/man8/mkfs.8
to a
.B kfs
file system (see
-.IM kfs (4) ).
+.MR kfs (4) ).
The kfs service is mounted on
.I root
(default
.I proto
files are read
(see
-.IM proto (2)
+.MR proto (2)
for their format)
and any files specified in them that are out of date are copied to
.BR /n/kfs .
.br
.B \*9/src/cmd/disk/mkext.c
.SH "SEE ALSO"
-.IM prep (8) ,
-.IM tar (1)
+.MR prep (8) ,
+.MR tar (1)
blob - e212435edc2b846f2085dfa6aa231ffff22e8a40
blob + fa201f40070ce1982a8492434e918b47589e9b75
--- man/man8/vbackup.8
+++ man/man8/vbackup.8
.SH DESCRIPTION
These programs back up and restore standard
Unix file system images stored in
-.IM venti (8) .
+.MR venti (8) .
Images stored in
.I venti
are named by
.I disk
should be a disk or disk partition device
that would be appropriate to pass to
-.IM mount (8) .
+.MR mount (8) .
.PP
The optional argument
.I score
is the name returned by
.I sysname
(see
-.IM getuser (3) ).
+.MR getuser (3) ).
The default
.I mtpt
is the place where
The default is the name returned by
.I sysname
(see
-.IM getuser (3) ).
+.MR getuser (3) ).
.TP
.B -n
No-op mode: do not write any blocks to the server
.PP
.I Vftp
presents an
-.IM ftp (1) -like
+.MR ftp (1) -like
interface to a physical or backed-up disk image.
It is used mainly for debugging.
Type
Because
.I address
is passed to the host OS kernel rather than interpreted by
-.IM dial (3) ,
+.MR dial (3) ,
it must be only an IP address, not a full dial address.
.PP
.I Vnfs
blob - 88bad8f33d93937199be77703423cb1732eae515
blob + 131514c65e339b656780720ecc1f543372498655
--- man/man8/venti-backup.8
+++ man/man8/venti-backup.8
.SH SOURCE
.B \*9/src/cmd/venti/srv
.SH SEE ALSO
-.IM venti (7) ,
-.IM venti (8)
+.MR venti (7) ,
+.MR venti (8)
.SH BUGS
.I Wrarena
can't read a pipe or network connection containing an arena;
blob - 19679ca0ef5dae9c65c94fc129489567830bdc0e
blob + 399068621e00a0e66e19d3467187a055bdaa0ee3
--- man/man8/venti-fmt.8
+++ man/man8/venti-fmt.8
These commands aid in the setup, maintenance, and debugging of
venti servers.
See
-.IM venti (7)
+.MR venti (7)
for an overview of the venti system and
-.IM venti (8)
+.MR 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
.I file
as a Bloom filter
(see
-.IM venti (7) ).
+.MR venti (7) ).
The options are:
.TF "\fL-s\fI size"
.PD
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
-.IM venti (8)
+.MR venti (8)
for more.
.PP
.I Fmtindex
.SH SOURCE
.B \*9/src/cmd/venti/srv
.SH SEE ALSO
-.IM venti (7) ,
-.IM venti (8)
+.MR venti (7) ,
+.MR venti (8)
.SH BUGS
.I Buildindex
should allow an individual index section to be rebuilt.
blob - d6c26903f9a7890c42a8a41d650ab4d78e933f7c
blob + 6a6d53e0db2a0cd4dec3e0887e7bcb8eb4818ba8
--- man/man8/venti.8
+++ man/man8/venti.8
.I Venti
is a SHA1-addressed archival storage server.
See
-.IM venti (7)
+.MR venti (7)
for a full introduction to the system.
This page documents the structure and operation of the server.
.PP
greater than 24 are probably a waste of memory.
.I Fmtbloom
(see
-.IM venti-fmt (8) )
+.MR venti-fmt (8) )
can be given either
.I nhash
or
.BR venti ,
17034) serving
the venti protocol as described in
-.IM venti (7) ,
+.MR venti (7) ,
and one serving HTTP
(conventionally TCP port
.BR http ,
or
.I fmtisect
(see
-.IM venti-fmt (8) ).
+.MR venti-fmt (8) ).
In particular, only the configuration needs to be
changed if a component is moved to a different file.
.PP
.SH SOURCE
.B \*9/src/cmd/venti/srv
.SH "SEE ALSO"
-.IM venti (1) ,
-.IM venti (3) ,
-.IM venti (7) ,
-.IM venti-backup (8)
-.IM venti-fmt (8)
+.MR venti (1) ,
+.MR venti (3) ,
+.MR venti (7) ,
+.MR venti-backup (8)
+.MR venti-fmt (8)
.br
Sean Quinlan and Sean Dorward,
``Venti: a new approach to archival storage'',
partition its memory usage.
.PP
Users of shells other than
-.IM rc (1)
+.MR rc (1)
will not be able to use the program names shown.
One solution is to define
.B "V=$PLAN9/bin/venti"
blob - c759a59eefb61fdca9827df66c3b0c4df131e776
blob + 02b31bbfab93cfe518941210b70688b1747ccc4e
--- tmac/tmac.an
+++ tmac/tmac.an
.HY
.}f
..
-.de IM
+.\" MR - manual reference, as in .MR cat (1) ,
+.\" $3 is the punctuation after the reference ends, if any.
+.de MR
+.nh
.}S 2 1 \& "\Xhtml manref start \\$1 \\$2\\$1" "\\$2\Xhtml manref end \\$1 \\$2\\$3"
.HY
.}f