o5r/plan9port
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

tmac: introduce real manual reference macro instead of overloading IR

Browse source 
The overloading of IR emits magic \X'...' sequences that turn into HTML manual links.
But not all such IR invocations should be manual links;
those had to be written to avoid the IR macro before.
Worse, the \X'...' ending the IR causes troff to emit only a single space after a period.

Defining a new IM macro for manual references fixes both problems.

Fixes #441.
This commit is contained in:
Russ Cox 2020-08-13 23:41:59 -04:00
parent a1c4307800
commit 977b25a76a
297 changed files with 1790 additions and 1774 deletions
Download patch file Download diff file Expand all files Collapse all files

148
man/man1/0intro.1
View file

@ -32,15 +32,15 @@ they expect the
environment variable environment variable
to contain the name of the root of the tree. to contain the name of the root of the tree.
See See
.IR install (1) .IM install (1)
for details about installation. for details about installation.
.PP .PP
Many of the familiar Unix commands, Many of the familiar Unix commands,
for example for example
.IR cat (1), .IM cat (1) ,
.IR ls (1), .IM ls (1) ,
and and
.IR wc (1), .IM wc (1) ,
are present, but in their Plan 9 forms: are present, but in their Plan 9 forms:
.I cat .I cat
takes no options, takes no options,
@ -50,12 +50,12 @@ and
.I wc .I wc
counts UTF characters. counts UTF characters.
In some cases, the differences are quite noticeable: In some cases, the differences are quite noticeable:
.IR grep (1) .IM grep (1)
and and
.IR sed (1) .IM sed (1)
expect Plan 9 regular expressions expect Plan 9 regular expressions
(see (see
.IR regexp (7)), .IM regexp (7) ),
which are closest to what Unix calls extended regular expressions. which are closest to what Unix calls extended regular expressions.
Because of these differences, it is not recommended to put Because of these differences, it is not recommended to put
.B $PLAN9/bin .B $PLAN9/bin
@ -63,16 +63,16 @@ before the usual system
.B bin .B bin
directories in your search path. directories in your search path.
Instead, put it at the end of your path and use the Instead, put it at the end of your path and use the
.IR 9 (1) .IM 9 (1)
script when you want to invoke the Plan 9 version of a script when you want to invoke the Plan 9 version of a
traditional Unix command. traditional Unix command.
.PP .PP
Occasionally the Plan 9 programs have been Occasionally the Plan 9 programs have been
changed to adapt to Unix. changed to adapt to Unix.
.IR Mk (1) .IM Mk (1)
now allows mkfiles to choose their own shell, now allows mkfiles to choose their own shell,
and and
.IR rc (1) .IM rc (1)
has a has a
.I ulimit .I ulimit
builtin and manages builtin and manages
@ -80,14 +80,14 @@ builtin and manages
.PP .PP
Many of the graphical programs from Plan 9 are present, Many of the graphical programs from Plan 9 are present,
including including
.IR sam (1) .IM sam (1)
and and
.IR acme (1). .IM acme (1) .
An X11 window manager An X11 window manager
.IR rio (1) .IM rio (1)
mimics Plan 9's window system, with command windows mimics Plan 9's window system, with command windows
implemented by the external program implemented by the external program
.IR 9term (1). .IM 9term (1) .
Following the style of X Windows, these programs run in new Following the style of X Windows, these programs run in new
windows rather than the one in which they are invoked. windows rather than the one in which they are invoked.
They all take a They all take a
@ -101,10 +101,10 @@ The argument is one of
\fIxmin\fL,\fIymin\fL,\fIxmax\fL,\fIymax\fR. \fIxmin\fL,\fIymin\fL,\fIxmax\fL,\fIymax\fR.
.PP .PP
The The
.IR plumber (4) .IM plumber (4)
helps to connect the various Plan 9 programs together, helps to connect the various Plan 9 programs together,
and fittings like and fittings like
.IR web (1) .IM web (1)
connect it to external programs such as web browsers; connect it to external programs such as web browsers;
one can click on a URL in one can click on a URL in
.I acme .I acme
@ -119,17 +119,17 @@ with file servers by reading and writing files.
This cannot be done directly on Unix. This cannot be done directly on Unix.
Instead the servers listen for 9P connections on Unix domain sockets; Instead the servers listen for 9P connections on Unix domain sockets;
clients connect to these sockets and speak 9P directly using the clients connect to these sockets and speak 9P directly using the
.IR 9pclient (3) .IM 9pclient (3)
library. library.
.IR Intro (4) .IM Intro (4)
tells more of the story. tells more of the story.
The effect is not as clean as on Plan 9, but it gets the job done 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. and still provides a uniform and easy-to-understand mechanism.
The The
.IR 9p (1) .IM 9p (1)
client can be used in shell scripts or by hand to carry out client can be used in shell scripts or by hand to carry out
simple interactions with servers. simple interactions with servers.
.IR Netfiles (1) .IM Netfiles (1)
is an experimental client for acme. is an experimental client for acme.
.SS External databases .SS External databases
Some programs rely on large databases that would be Some programs rely on large databases that would be
@ -146,7 +146,7 @@ The shell scripts
and and
.I 9l .I 9l
(see (see
.IR 9c (1)) .IM 9c (1) )
provide a simple interface to the underlying system compiler and linker, provide a simple interface to the underlying system compiler and linker,
similar to the similar to the
.I 2c .I 2c
@ -165,22 +165,22 @@ so that no
options are needed. options are needed.
.PP .PP
The only way to write multithreaded programs is to use the The only way to write multithreaded programs is to use the
.IR thread (3) .IM thread (3)
library. library.
.IR Rfork (3) .IM Rfork (3)
exists but is not as capable as on Plan 9. exists but is not as capable as on Plan 9.
There are many unfortunate by necessary preprocessor There are many unfortunate by necessary preprocessor
diversions to make Plan 9 and Unix libraries coexist. diversions to make Plan 9 and Unix libraries coexist.
See See
.IR intro (3) .IM intro (3)
for details. for details.
.PP .PP
The debuggers The debuggers
.IR acid (1) .IM acid (1)
and and
.IR db (1) .IM db (1)
and the debugging library and the debugging library
.IR mach (3) .IM mach (3)
are works in progress. are works in progress.
They are platform-independent, so that x86 Linux core dumps They are platform-independent, so that x86 Linux core dumps
can be inspected on PowerPC Mac OS X machines, can be inspected on PowerPC Mac OS X machines,
@ -203,22 +203,22 @@ but that it is the extent to which they have been developed and exercised.
.SS Porting programs .SS Porting programs
The vast majority of the familiar Plan 9 programs The vast majority of the familiar Plan 9 programs
have been ported, including the Unicode-aware have been ported, including the Unicode-aware
.IR troff (1). .IM troff (1) .
.PP .PP
Of the more recent additions to Plan 9, Of the more recent additions to Plan 9,
.IR factotum (4), .IM factotum (4) ,
.IR secstore (1), .IM secstore (1) ,
and and
.IR secstored (1), .IM secstored (1) ,
.IR vac (1), .IM vac (1) ,
.IR vacfs (4), .IM vacfs (4) ,
and and
.IR venti (8) .IM venti (8)
are all ported. are all ported.
.PP .PP
A backup system providing a dump file system built atop Venti A backup system providing a dump file system built atop Venti
is in progress; see is in progress; see
.IR vbackup (8). .IM vbackup (8) .
.SS Porting to new systems .SS Porting to new systems
Porting the tree to new operating systems or architectures Porting the tree to new operating systems or architectures
should be straightforward, as system-specific code has been should be straightforward, as system-specific code has been
@ -240,9 +240,9 @@ need to write any system specific code at all.
.PP .PP
There are other smaller system dependencies, There are other smaller system dependencies,
such as the terminal handling code in such as the terminal handling code in
.IR 9term (1) .IM 9term (1)
and the implementation of and the implementation of
.IR getcallerpc (3), .IM getcallerpc (3) ,
but these are usually simple and are not on the critical but these are usually simple and are not on the critical
path for getting the system up and running. path for getting the system up and running.
.SH SEE ALSO .SH SEE ALSO
@ -255,7 +255,7 @@ The manual pages are in a Unix style tree, with names like
instead of Plan 9's simpler instead of Plan 9's simpler
.BR $PLAN9/man/1/cat , .BR $PLAN9/man/1/cat ,
so that the Unix so that the Unix
.IR man (1) .IM man (1)
utility can handle it. utility can handle it.
Some systems, for example Debian Linux, Some systems, for example Debian Linux,
deduce the man page locations from the search path, so that deduce the man page locations from the search path, so that
@ -300,52 +300,52 @@ describes the Plan 9 file protocol 9P.
These pages describe parts of the system These pages describe parts of the system
that are new or different from Plan 9 from Bell Labs: that are new or different from Plan 9 from Bell Labs:
.IP .IP
.IR 9 (1), .IM 9 (1) ,
.IR 9c (1), .IM 9c (1) ,
.IR 9p (1), .IM 9p (1) ,
.IR 9term (1), .IM 9term (1) ,
.I acidtypes .I acidtypes
in in
.IR acid (1), .IM acid (1) ,
.IR dial (1), .IM dial (1) ,
.IR git (1), .IM git (1) ,
.IR label (1), .IM label (1) ,
the the
.B MKSHELL .B MKSHELL
variable in variable in
.IR mk (1), .IM mk (1) ,
.IR namespace (1), .IM namespace (1) ,
.IR netfiles (1), .IM netfiles (1) ,
.IR page (1), .IM page (1) ,
.IR psfonts (1), .IM psfonts (1) ,
.IR rio (1), .IM rio (1) ,
.IR web (1), .IM web (1) ,
.IR wintext (1) .IM wintext (1)
.IP .IP
.IR intro (3), .IM intro (3) ,
.IR 9pclient (3), .IM 9pclient (3) ,
the the
.B unix .B unix
network in network in
.IR dial (3), .IM dial (3) ,
.IR exits (3), .IM exits (3) ,
.IR get9root (3), .IM get9root (3) ,
.IR getns (3), .IM getns (3) ,
.IR notify (3), .IM notify (3) ,
.IR post9pservice (3), .IM post9pservice (3) ,
.IR rfork (3), .IM rfork (3) ,
.IR searchpath (3), .IM searchpath (3) ,
.IR sendfd (3), .IM sendfd (3) ,
.IR udpread (3), .IM udpread (3) ,
.IR venti (3), .IM venti (3) ,
.IR wait (3), .IM wait (3) ,
.IR wctl (3) .IM wctl (3)
.IP .IP
.IR intro (4), .IM intro (4) ,
.IR 9pserve (4), .IM 9pserve (4) ,
.IR import (4), .IM import (4) ,
.IP .IP
.IR vbackup (8) .IM vbackup (8)
.IP .IP
.IR openfd (9p) .IR openfd (9p)
.SH DIAGNOSTICS .SH DIAGNOSTICS
@ -356,4 +356,4 @@ exit with string statuses. In fact, exiting with an empty status
corresponds to exiting with status 0, corresponds to exiting with status 0,
and exiting with any non-empty string corresponds to exiting with status 1. and exiting with any non-empty string corresponds to exiting with status 1.
See See
.IR exits (3). .IM exits (3) .

14
man/man1/9.1
View file

@ -12,7 +12,7 @@
.B . .B .
.B 9 .B 9
(from (from
.IR sh (1)) .IM sh (1) )
.PP .PP
.B 9.rc .B 9.rc
.I cmd .I cmd
@ -24,7 +24,7 @@
.B . .B .
.B 9.rc .B 9.rc
(from (from
.IR rc (1)) .IM rc (1) )
.PP .PP
.B u .B u
.I cmd .I cmd
@ -36,7 +36,7 @@
.B . .B .
.B u .B u
(from (from
.IR sh (1)) .IM sh (1) )
.PP .PP
.B u.rc .B u.rc
.I cmd .I cmd
@ -48,7 +48,7 @@
.B . .B .
.B u.rc .B u.rc
(from (from
.IR rc (1)) .IM rc (1) )
.SH DESCRIPTION .SH DESCRIPTION
Because Plan 9 supplies commands with the same name as but different Because Plan 9 supplies commands with the same name as but different
behavior than many basic Unix system commands behavior than many basic Unix system commands
@ -86,7 +86,7 @@ in order to make the current shell start running in the Plan 9 environment.
is the same as is the same as
.I 9 .I 9
but written for use by the shell but written for use by the shell
.IR rc (1). .IM rc (1) .
.PP .PP
.I U .I U
and and
@ -106,7 +106,7 @@ $ 9 grep '[α-ζ]' /etc/passwd
.EE .EE
.PP .PP
Start an Start an
.IR rc (1) .IM rc (1)
with the Plan 9 commands in the path before the system commands, with the Plan 9 commands in the path before the system commands,
and then run the Unix and then run the Unix
.IR ls : .IR ls :
@ -124,7 +124,7 @@ $ 9 rc
.br .br
.B \*9/bin/u.rc .B \*9/bin/u.rc
.SH SEE ALSO .SH SEE ALSO
.IR intro (1) .IM intro (1)
.SH BUGS .SH BUGS
Some shell configurations Some shell configurations
(notably, oh-my-zsh) (notably, oh-my-zsh)

2
man/man1/9c.1
View file

@ -164,7 +164,7 @@ With
.BR t , .BR t ,
give a long listing of all information about the files, give a long listing of all information about the files,
somewhat like a listing by somewhat like a listing by
.IR ls (1), .IM ls (1) ,
showing showing
.br .br
.ns .ns

14
man/man1/9p.1
View file

@ -121,11 +121,11 @@ copy a line from standard input to the file.
Print errors, but don't give up. Print errors, but don't give up.
.B Rdwr .B Rdwr
is useful for interacting with servers like is useful for interacting with servers like
.IR factotum (4). .IM factotum (4) .
.TP .TP
.B ls .B ls
Print a directory listing in the format of Print a directory listing in the format of
.IR ls (1). .IM ls (1) .
The The
.B -d .B -d
and and
@ -150,12 +150,12 @@ it connects to the Unix domain socket
.I service .I service
in the name space directory in the name space directory
(see (see
.IR intro (4)) .IM intro (4) )
and then accesses and then accesses
.IR subpath . .IR subpath .
.SH EXAMPLE .SH EXAMPLE
To update To update
.IR plumber (4)'s .IM plumber (4) 's
copy of your plumbing rules after editing copy of your plumbing rules after editing
.BR $HOME/lib/plumbing : .BR $HOME/lib/plumbing :
.IP .IP
@ -164,7 +164,7 @@ cat $HOME/lib/plumbing | 9p write plumb/rules
.EE .EE
.PP .PP
To display the contents of the current To display the contents of the current
.IR acme (4) .IM acme (4)
window: window:
.IP .IP
.EX .EX
@ -173,6 +173,6 @@ window:
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/9p.c .B \*9/src/cmd/9p.c
.SH SEE ALSO .SH SEE ALSO
.IR intro (4), .IM intro (4) ,
.IR intro (9p), .IR intro (9p),
.IR 9pclient (3) .IM 9pclient (3)

18
man/man1/9term.1
View file

@ -58,7 +58,7 @@ uses the imported value of
.B $font .B $font
if set; otherwise it uses the graphics system default. if set; otherwise it uses the graphics system default.
(See (See
.IR font (7) .IM font (7)
for a full discussion of font syntaxes.) for a full discussion of font syntaxes.)
.PP .PP
.I 9term .I 9term
@ -96,7 +96,7 @@ Characters typed on the keyboard replace the selected text;
if this text is not empty, it is placed in a if this text is not empty, it is placed in a
.I snarf buffer .I snarf buffer
common to all windows but distinct from that of common to all windows but distinct from that of
.IR sam (1). .IM sam (1) .
.PP .PP
Programs access the text in the window at a single point Programs access the text in the window at a single point
maintained automatically by maintained automatically by
@ -163,7 +163,7 @@ and erases the character before the word.
.PP .PP
An ACK character (control-F) or Insert character triggers file name completion An ACK character (control-F) or Insert character triggers file name completion
for the preceding string (see for the preceding string (see
.IR complete (3)). .IM complete (3) ).
.PP .PP
Text may be moved vertically within the window. 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 A scroll bar on the left of the window shows in its clear portion what fragment of the
@ -201,7 +201,7 @@ EOT, so the terminal must be set up with EOT
as the ``eof'' character. as the ``eof'' character.
.I 9term .I 9term
runs runs
.IR stty (1) .IM stty (1)
to establish this when the terminal is created. to establish this when the terminal is created.
.PP .PP
.I 9term .I 9term
@ -231,13 +231,13 @@ are a few common ones where they fall short.
First, programs using the GNU readline library typically First, programs using the GNU readline library typically
disable terminal echo and perform echoing themselves. disable terminal echo and perform echoing themselves.
The most common example is the shell The most common example is the shell
.IR bash (1). .IM bash (1) .
Disabling the use of readline with Disabling the use of readline with
.RB `` "set +o emacs" '' .RB `` "set +o emacs" ''
.RI [ sic ] .RI [ sic ]
usually restores the desired behavior. usually restores the desired behavior.
Second, remote terminal programs such as Second, remote terminal programs such as
.IR ssh (1) .IM ssh (1)
typically run with echo disabled, relying on the typically run with echo disabled, relying on the
remote system to echo characters as desired. remote system to echo characters as desired.
Plan 9's Plan 9's
@ -279,7 +279,7 @@ The
menu item sends the contents of the selection (not the snarf buffer) to the menu item sends the contents of the selection (not the snarf buffer) to the
.I plumber .I plumber
(see (see
.IR plumb (1)). .IM plumb (1) ).
If the selection is empty, it sends the white-space-delimited text If the selection is empty, it sends the white-space-delimited text
containing the selection (typing cursor). containing the selection (typing cursor).
A typical use of this feature is to tell the editor to find the source of an error A typical use of this feature is to tell the editor to find the source of an error
@ -323,7 +323,7 @@ Not a
.IR 9term .IR 9term
bug: bug:
when running when running
.IR bash (1) .IM bash (1)
in in
.RB `` "set +o emacs" '' .RB `` "set +o emacs" ''
mode, its handling of interrupts is broken. mode, its handling of interrupts is broken.
@ -334,4 +334,4 @@ character typed.
.PP .PP
Unix makes everything harder. Unix makes everything harder.
.SH SEE ALSO .SH SEE ALSO
.IR wintext (1) .IM wintext (1)

14
man/man1/acid.1
View file

@ -70,7 +70,7 @@ at startup; see below.
.BI -m " machine .BI -m " machine
Assume instructions are for the given CPU type Assume instructions are for the given CPU type
(see (see
.IR mach (3)) .IM mach (3) )
instead of using the executable header to select instead of using the executable header to select
the CPU type. the CPU type.
.TP .TP
@ -145,7 +145,7 @@ subscripts counted from 0.
.BI delete " list", " subscript .BI delete " list", " subscript
.PP .PP
Format codes are the same as in Format codes are the same as in
.IR db (1). .IM db (1) .
Formats may be attached to (unary) expressions with Formats may be attached to (unary) expressions with
.BR \e , .BR \e ,
e.g. e.g.
@ -230,7 +230,7 @@ Print 10 lines of source around the program address.
.BI Bsrc( address ) .BI Bsrc( address )
Get the source line for the program address Get the source line for the program address
into a window of a running into a window of a running
.IR sam (1) .IM sam (1)
and select it. and select it.
.TP .TP
.BI line( address ) .BI line( address )
@ -323,7 +323,7 @@ Make the given process current.
.TP .TP
.BI rc( string ) .BI rc( string )
Escape to the shell, Escape to the shell,
.IR rc (1), .IM rc (1) ,
to execute the command string. to execute the command string.
.TP .TP
.BI include( string ) .BI include( string )
@ -449,7 +449,7 @@ notation)
.BR *array . .BR *array .
.PP .PP
Trace the system calls executed by Trace the system calls executed by
.IR ls (1) .IM ls (1)
(neither does this one): (neither does this one):
.IP .IP
.EX .EX
@ -503,8 +503,8 @@ acid: cont()
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/acid .B \*9/src/cmd/acid
.SH "SEE ALSO" .SH "SEE ALSO"
.IR mk (1), .IM mk (1) ,
.IR db (1) .IM db (1)
.br .br
Phil Winterbottom, Phil Winterbottom,
``Acid Manual''. ``Acid Manual''.

42
man/man1/acme.1
View file

@ -45,7 +45,7 @@ The interactive interface uses the keyboard and mouse; external programs
use a set of files served by use a set of files served by
.IR acme ; .IR acme ;
these are discussed in these are discussed in
.IR acme (4). .IM acme (4) .
.PP .PP
Any named Any named
.I files .I files
@ -86,7 +86,7 @@ The
option instructs option instructs
.I acme .I acme
to use FUSE (see to use FUSE (see
.IR 9pfuse (4)) .IM 9pfuse (4) )
to mount itself at to mount itself at
.IR mtpt . .IR mtpt .
(Experimental.) (Experimental.)
@ -98,10 +98,10 @@ windows are in two parts: a one-line
above a multi-line above a multi-line
.IR body . .IR body .
The body typically contains an image of a file, as in The body typically contains an image of a file, as in
.IR sam (1), .IM sam (1) ,
or the output of a or the output of a
program, as in an program, as in an
.IR rio (1) .IM rio (1)
window. window.
The tag contains a number of The tag contains a number of
blank-separated words, followed by a vertical bar character, followed by anything. blank-separated words, followed by a vertical bar character, followed by anything.
@ -118,9 +118,9 @@ a slash.
.SS Scrolling .SS Scrolling
Each window has a scroll bar to the left of the body. Each window has a scroll bar to the left of the body.
The scroll bar behaves much as in The scroll bar behaves much as in
.IR sam (1) .IM sam (1)
or or
.IR rio (1) .IM rio (1)
except that scrolling occurs when the button is pressed, rather than released, except that scrolling occurs when the button is pressed, rather than released,
and continues and continues
as long as the mouse button is held down in the scroll bar. as long as the mouse button is held down in the scroll bar.
@ -131,7 +131,7 @@ down the scroll bar speeds up the rate of scrolling.
.B -r .B -r
reverses the scrolling behavior of buttons 1 and 3, to behave reverses the scrolling behavior of buttons 1 and 3, to behave
more like more like
.IR xterm (1).) .IM xterm (1) .)
.SS Layout .SS Layout
.I Acme .I Acme
windows are arranged in columns. By default, it creates two columns when starting; windows are arranged in columns. By default, it creates two columns when starting;
@ -164,7 +164,7 @@ pre-loads them with useful commands.
Also, the tag across the top maintains a list of executing long-running commands. Also, the tag across the top maintains a list of executing long-running commands.
.SS Typing .SS Typing
The behavior of typed text is similar to that in The behavior of typed text is similar to that in
.IR rio (1) .IM rio (1)
except that the characters are delivered to the tag or body under the mouse; there is no except that the characters are delivered to the tag or body under the mouse; there is no
`click to type'. `click to type'.
(The experimental option (The experimental option
@ -172,7 +172,7 @@ except that the characters are delivered to the tag or body under the mouse; the
causes typing to go to the most recently clicked-at or made window.) causes typing to go to the most recently clicked-at or made window.)
The usual backspacing conventions apply. The usual backspacing conventions apply.
As in As in
.IR sam (1) .IM sam (1)
but not but not
.IR rio , .IR rio ,
the ESC key selects the text typed since the last mouse action, the ESC key selects the text typed since the last mouse action,
@ -249,7 +249,7 @@ is identified by the context of the command.
These error windows are created when needed. These error windows are created when needed.
.SS "Mouse button 1 .SS "Mouse button 1
Mouse button 1 selects text just as in Mouse button 1 selects text just as in
.IR sam (1) .IM sam (1)
or or
.IR rio (1) , .IR rio (1) ,
including the usual double-clicking conventions. including the usual double-clicking conventions.
@ -305,7 +305,7 @@ by default.
.TP .TP
.B Edit .B Edit
Treat the argument as a text editing command in the style of Treat the argument as a text editing command in the style of
.IR sam (1). .IM sam (1) .
The full The full
.B Sam .B Sam
language is implemented except for the commands language is implemented except for the commands
@ -379,7 +379,7 @@ With no arguments,
prints the supplementary list. prints the supplementary list.
This command is largely superseded by plumbing This command is largely superseded by plumbing
(see (see
.IR plumb (7)). .IM plumb (7) ).
.TP .TP
.B Indent .B Indent
Set the autoindent mode according to the argument: Set the autoindent mode according to the argument:
@ -507,7 +507,7 @@ If the text indicated with button 2 is not a recognized built-in, it is executed
a shell command. For example, indicating a shell command. For example, indicating
.B date .B date
with button 2 runs with button 2 runs
.IR date (1). .IM date (1) .
The standard The standard
and error outputs of commands are sent to the error window associated with 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 the directory from which the command was run, which will be created if
@ -525,7 +525,7 @@ in a window containing
executing executing
.B mk .B mk
will run will run
.IR mk (1) .IM mk (1)
in in
.BR /home/rob/sam , .BR /home/rob/sam ,
producing output in a window labeled producing output in a window labeled
@ -539,12 +539,12 @@ and
.B $winid .B $winid
set to the window's id number set to the window's id number
(see (see
.IR acme (4)). .IM acme (4) ).
.PP .PP
The environment variable The environment variable
.B $acmeshell .B $acmeshell
determines which shell is used to execute such commands; the determines which shell is used to execute such commands; the
.IR rc (1) .IM rc (1)
shell is used by default. shell is used by default.
.SS "Mouse button 3 .SS "Mouse button 3
Pointing at text with button 3 instructs Pointing at text with button 3 instructs
@ -574,7 +574,7 @@ command adds directories to the standard list.)
.PP .PP
If the text begins with a colon, it is taken to be an address, in If the text begins with a colon, it is taken to be an address, in
the style of the style of
.IR sam (1), .IM sam (1) ,
within the body of the window containing the text. within the body of the window containing the text.
The address is evaluated, the resulting text highlighted, and the mouse moved to it. The address is evaluated, the resulting text highlighted, and the mouse moved to it.
Thus, in Thus, in
@ -644,7 +644,7 @@ then execute
clicking button 1 while 2 is held down. clicking button 1 while 2 is held down.
.PP .PP
When an external command (e.g. When an external command (e.g.
.IR echo (1)) .IM echo (1) )
is executed this way, the extra argument is passed as expected and an is executed this way, the extra argument is passed as expected and an
environment variable environment variable
.B $acmeaddr .B $acmeaddr
@ -677,7 +677,7 @@ window and runs a
(default (default
.BR $SHELL ) .BR $SHELL )
in it, turning the window into something analogous to an in it, turning the window into something analogous to an
.IR 9term (1) .IM 9term (1)
window. window.
Executing text in a Executing text in a
.I win .I win
@ -686,7 +686,7 @@ window with button
.BR Send . .BR Send .
.I Win .I Win
windows follow the same scrolling heuristic as in windows follow the same scrolling heuristic as in
.IR 9term (1): .IM 9term (1) :
the window scrolls on output only if the window is displaying the end of the buffer. the window scrolls on output only if the window is displaying the end of the buffer.
.PP .PP
.I Awd .I Awd
@ -774,7 +774,7 @@ MIPS-specific binaries for applications
.br .br
.B \*9/bin/awd .B \*9/bin/awd
.SH SEE ALSO .SH SEE ALSO
.IR acme (4) .IM acme (4)
.br .br
Rob Pike, Rob Pike,
.I .I

22
man/man1/acmeevent.1
View file

@ -61,7 +61,7 @@ acmeevent, acme.rc \- shell script support for acme clients
and and
.I acme.rc .I acme.rc
make it easy to write simple make it easy to write simple
.IR acme (1) .IM acme (1)
client programs as shell scripts. client programs as shell scripts.
.PP .PP
.I Acme .I Acme
@ -69,14 +69,14 @@ clients read the
.B event .B event
files files
(see (see
.IR acme (4)) .IM acme (4) )
for the windows they control, reacting to the events. for the windows they control, reacting to the events.
The events are presented in a format that is easy to read with C programs The events are presented in a format that is easy to read with C programs
but hard to read with shell scripts. but hard to read with shell scripts.
.PP .PP
.I Acmeevent .I Acmeevent
reads an reads an
.IR acme (4) .IM acme (4)
event stream from standard input, printing a shell-friendly event stream from standard input, printing a shell-friendly
version of the events, one per line, on standard output. version of the events, one per line, on standard output.
Each output line from Each output line from
@ -165,7 +165,7 @@ above);
below). below).
.I Flag .I Flag
remains from the remains from the
.IR acme (4) .IM acme (4)
event format. event format.
Because Because
.IR eq0 , .IR eq0 ,
@ -174,7 +174,7 @@ and
.I chordarg .I chordarg
are explicit in each event are explicit in each event
(unlike in (unlike in
.IR acme (4) .IM acme (4)
events), events),
.I flag .I flag
can usually be ignored. can usually be ignored.
@ -221,7 +221,7 @@ window.
.PP .PP
.I Acme.rc .I Acme.rc
is a library of is a library of
.IR rc (1) .IM rc (1)
shell functions useful for writing acme clients. shell functions useful for writing acme clients.
.PP .PP
.I Newwindow .I Newwindow
@ -259,14 +259,14 @@ The most commonly-used command is
.BR clean , .BR clean ,
which marks the window as clean. which marks the window as clean.
See See
.IR acme (4) .IM acme (4)
for a full list of commands. for a full list of commands.
.PP .PP
.I Windump .I Windump
sets the window's dump directory sets the window's dump directory
and dump command and dump command
(see (see
.IR acme (4)). .IM acme (4) ).
If either argument is omitted or is If either argument is omitted or is
.BR - , .BR - ,
that argument is not set. that argument is not set.
@ -381,9 +381,9 @@ for the full implementation.
.br .br
.B \*9/lib/acme.rc .B \*9/lib/acme.rc
.SH SEE ALSO .SH SEE ALSO
.IR acme (1), .IM acme (1) ,
.IR acme (4), .IM acme (4) ,
.IR rc (1) .IM rc (1)
.SH BUGS .SH BUGS
There is more that could be done to ease the writing There is more that could be done to ease the writing
of complicated clients. of complicated clients.

12
man/man1/ascii.1
View file

@ -91,7 +91,7 @@ control characters or insert newlines.
is similar; it converts between is similar; it converts between
.SM UTF .SM UTF
and character values from the Unicode Standard (see and character values from the Unicode Standard (see
.IR utf (7)). .IM utf (7) ).
If given a range of hexadecimal numbers, If given a range of hexadecimal numbers,
.I unicode .I unicode
prints a table of the specified Unicode characters \(em their values and prints a table of the specified Unicode characters \(em their values and
@ -126,7 +126,7 @@ The file
contains a contains a
table of characters and descriptions, sorted in hexadecimal order, table of characters and descriptions, sorted in hexadecimal order,
suitable for suitable for
.IR look (1) .IM look (1)
on the lower case on the lower case
.I hex .I hex
values of characters. values of characters.
@ -154,7 +154,7 @@ table of characters and descriptions.
.br .br
.B \*9/src/cmd/unicode.c .B \*9/src/cmd/unicode.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR look (1), .IM look (1) ,
.IR tcs (1), .IM tcs (1) ,
.IR utf (7), .IM utf (7) ,
.IR font (7) .IM font (7)

2
man/man1/astro.1
View file

@ -114,7 +114,7 @@ default latitude (N), longitude (W), and elevation (meters)
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/astro .B \*9/src/cmd/astro
.SH SEE ALSO .SH SEE ALSO
.IR scat (1) .IM scat (1)
.SH BUGS .SH BUGS
The The
.B k .B k

6
man/man1/awk.1
View file

@ -377,7 +377,7 @@ Patterns are arbitrary Boolean combinations
of regular expressions and of regular expressions and
relational expressions. relational expressions.
Regular expressions are as in Regular expressions are as in
.IR regexp (7). .IM regexp (7) .
Isolated regular expressions Isolated regular expressions
in a pattern apply to the entire line. in a pattern apply to the entire line.
Regular expressions may also occur in Regular expressions may also occur in
@ -534,8 +534,8 @@ BEGIN { # Simulate echo(1)
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/awk .B \*9/src/cmd/awk
.SH SEE ALSO .SH SEE ALSO
.IR sed (1), .IM sed (1) ,
.IR regexp (7), .IM regexp (7) ,
.br .br
A. V. Aho, B. W. Kernighan, P. J. Weinberger, A. V. Aho, B. W. Kernighan, P. J. Weinberger,
.I .I

6
man/man1/bc.1
View file

@ -218,7 +218,7 @@ Assignment to
.B scale .B scale
influences the number of digits to be retained on arithmetic influences the number of digits to be retained on arithmetic
operations in the manner of operations in the manner of
.IR dc (1). .IM dc (1) .
Assignments to Assignments to
.B ibase .B ibase
or or
@ -235,7 +235,7 @@ empty square brackets must follow the array name.
.PP .PP
.I Bc .I Bc
is actually a preprocessor for is actually a preprocessor for
.IR dc (1), .IM dc (1) ,
which it invokes automatically, unless the which it invokes automatically, unless the
.B -c .B -c
(compile only) (compile only)
@ -273,7 +273,7 @@ mathematical library
.B \*9/src/cmd/bc.y .B \*9/src/cmd/bc.y
.SH "SEE ALSO" .SH "SEE ALSO"
.IR dc (1), .IR dc (1),
.IR hoc (1) .IM hoc (1)
.SH BUGS .SH BUGS
No No
.LR && , .LR && ,

10
man/man1/bundle.1
View file

@ -7,20 +7,20 @@ bundle \- collect files for distribution
.SH DESCRIPTION .SH DESCRIPTION
.I Bundle .I Bundle
writes on its standard output a shell script for writes on its standard output a shell script for
.IR rc (1) .IM rc (1)
or a Bourne shell or a Bourne shell
which, when executed, which, when executed,
will recreate the original will recreate the original
.IR files . .IR files .
Its main use is for distributing small numbers of text files by Its main use is for distributing small numbers of text files by
.IR mail (1). .IM mail (1) .
.PP .PP
Although less refined than standard archives from Although less refined than standard archives from
.I 9ar .I 9ar
(see (see
.IR 9c (1)) .IM 9c (1) )
or or
.IR tar (1), .IM tar (1) ,
a a
.IR bundle .IR bundle
file file
@ -49,7 +49,7 @@ cd gift; sh horse; mk
(in (in
.IR 9c (1)), .IR 9c (1)),
.IR tar (1), .IR tar (1),
.IR mail (1) .IM mail (1)
.SH BUGS .SH BUGS
.I Bundle .I Bundle
will not create directories and is unsatisfactory for non-text files. will not create directories and is unsatisfactory for non-text files.

2
man/man1/calendar.1
View file

@ -43,7 +43,7 @@ processing at the end of the week.
On Friday and Saturday, events through Monday are printed. On Friday and Saturday, events through Monday are printed.
.PP .PP
To have your calendar mailed to you every day, use To have your calendar mailed to you every day, use
.IR cron (8). .IM cron (8) .
.SH FILES .SH FILES
.TF $HOME/lib/calendar .TF $HOME/lib/calendar
.TP .TP

8
man/man1/cat.1
View file

@ -51,7 +51,7 @@ copies to standard output exactly one line from the named
.IR file , .IR file ,
default standard input. default standard input.
It is useful in interactive It is useful in interactive
.IR rc (1) .IM rc (1)
scripts. scripts.
.PP .PP
The The
@ -76,11 +76,11 @@ characters and the characters that precede them.
It is useful to use as It is useful to use as
.B $PAGER .B $PAGER
with the Unix version of with the Unix version of
.IR man (1) .IM man (1)
when run inside a when run inside a
.I win .I win
(see (see
.IR acme (1)) .IM acme (1) )
window. window.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/cat.c .B \*9/src/cmd/cat.c
@ -89,7 +89,7 @@ window.
.br .br
.B \*9/bin/nobs .B \*9/bin/nobs
.SH SEE ALSO .SH SEE ALSO
.IR cp (1) .IM cp (1)
.SH DIAGNOSTICS .SH DIAGNOSTICS
.I Read .I Read
exits with status exits with status

2
man/man1/cleanname.1
View file

@ -29,4 +29,4 @@ before processing.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/cleanname.c .B \*9/src/cmd/cleanname.c
.SH SEE ALSO .SH SEE ALSO
.IR cleanname (3). .IM cleanname (3) .

8
man/man1/col.1
View file

@ -14,11 +14,11 @@ and half line feeds (ESC-9 and ESC-8)
as produced by as produced by
.I nroff .I nroff
for .2C in for .2C in
.IR ms (7) .IM ms (7)
or or
.IR man (7) .IM man (7)
and for and for
.IR tbl (1). .IM tbl (1) .
.I Col .I Col
is a pure filter. is a pure filter.
It normally emits only full line feeds; It normally emits only full line feeds;
@ -47,7 +47,7 @@ paginate the output.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/col.c .B \*9/src/cmd/col.c
.SH SEE ALSO .SH SEE ALSO
.IR pr (1) .IM pr (1)
.SH BUGS .SH BUGS
.I Col .I Col
can't back up more than 128 lines or can't back up more than 128 lines or

6
man/man1/colors.1
View file

@ -17,13 +17,13 @@ colors, cmapcube \- display color map
.I Colors .I Colors
presents a grid showing the colors in the RGBV color map presents a grid showing the colors in the RGBV color map
(see (see
.IR color (7)). .IM color (7) ).
.PP .PP
Clicking mouse button 1 over a color in the grid will display the map index for that color, Clicking mouse button 1 over a color in the grid will display the map index for that color,
its its
red, green, and blue components, red, green, and blue components,
and the 32-bit hexadecimal color value as defined in and the 32-bit hexadecimal color value as defined in
.IR allocimage (3). .IM allocimage (3) .
If the If the
.B -x .B -x
option is specified, the components will also be listed in hexadecimal. option is specified, the components will also be listed in hexadecimal.
@ -53,4 +53,4 @@ to black or white.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/draw/colors.c .B \*9/src/cmd/draw/colors.c
.SH SEE ALSO .SH SEE ALSO
.IR color (7) .IM color (7)

4
man/man1/comm.1
View file

@ -41,7 +41,7 @@ Print lines common to two sorted files.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/comm.c .B \*9/src/cmd/comm.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR sort (1), .IM sort (1) ,
.IR cmp (1), .IR cmp (1),
.IR diff (1), .IR diff (1),
.IR uniq (1) .IM uniq (1)

8
man/man1/core.1
View file

@ -35,7 +35,7 @@ The
command, if run, prints a stack trace of the command, if run, prints a stack trace of the
executing thread at the time of the core dump; executing thread at the time of the core dump;
see see
.IR db (1). .IM db (1) .
.PP .PP
If no arguments are given, If no arguments are given,
.I core .I core
@ -50,6 +50,6 @@ searches the current directory.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/core.c .B \*9/src/cmd/core.c
.SH "SEE ALSO .SH "SEE ALSO
.IR acid (1), .IM acid (1) ,
.IR db (1), .IM db (1) ,
.IR core (5) .IM core (5)

12
man/man1/crop.1
View file

@ -53,9 +53,9 @@ crop, iconv \- frame, crop, and convert image
.SH DESCRIPTION .SH DESCRIPTION
.I Crop .I Crop
reads an reads an
.IR image (7) .IM image (7)
file (default standard input), crops it, and writes it as a compressed file (default standard input), crops it, and writes it as a compressed
.IR image (7) .IM image (7)
file to standard output. file to standard output.
There are two ways to specify a crop, by color value or by geometry. There are two ways to specify a crop, by color value or by geometry.
They may be combined in a single run of They may be combined in a single run of
@ -65,7 +65,7 @@ in which case the color value crop will be done first.
The The
.B -c .B -c
option takes a red-green-blue triplet as described in option takes a red-green-blue triplet as described in
.IR color (3). .IM color (3) .
(For example, white (For example, white
is is
.B 255 .B 255
@ -118,7 +118,7 @@ changes the format of pixels in the image
Pixels in the image are converted according to the channel descriptor Pixels in the image are converted according to the channel descriptor
.IR chandesc , .IR chandesc ,
(see (see
.IR image (7)). .IM image (7) ).
For example, to convert a 4-bit-per-pixel grey-scale image to an 8-bit-per-pixel For example, to convert a 4-bit-per-pixel grey-scale image to an 8-bit-per-pixel
color-mapped image, color-mapped image,
.I chandesc .I chandesc
@ -139,8 +139,8 @@ crop -c 255 255 255 -i -10 -b 255 150 150 imagefile > cropped
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/draw/crop.c .B \*9/src/cmd/draw/crop.c
.SH SEE ALSO .SH SEE ALSO
.IR image (7), .IM image (7) ,
.IR color (3) .IM color (3)
.SH BUGS .SH BUGS
.I Iconv .I Iconv
should be able to do Floyd-Steinberg error diffusion or dithering should be able to do Floyd-Steinberg error diffusion or dithering

2
man/man1/date.1
View file

@ -28,7 +28,7 @@ epoch, 00:00:00 GMT, January 1, 1970.
The conversion from Greenwich Mean Time to local time depends on the The conversion from Greenwich Mean Time to local time depends on the
.B $timezone .B $timezone
environment variable; see environment variable; see
.IR ctime (3). .IM ctime (3) .
.PP .PP
If the optional argument If the optional argument
.I seconds .I seconds

10
man/man1/db.1
View file

@ -45,11 +45,11 @@ specifies the memory image of a process.
A A
.I pid .I pid
gives the id of an executing process to be accessed via gives the id of an executing process to be accessed via
.IR ptrace (2). .IM ptrace (2) .
A A
.I corefile .I corefile
specifies the name of a core dump (see specifies the name of a core dump (see
.IR core (5) .IM core (5)
on your system of choice) containing the on your system of choice) containing the
memory image of a terminated process. memory image of a terminated process.
This manual refers to the memory image specified by This manual refers to the memory image specified by
@ -628,7 +628,7 @@ Dot is assigned to the variable or register named.
.TP .TP
.B ! .B !
The rest of the line is passed to The rest of the line is passed to
.IR rc (1) .IM rc (1)
for execution. for execution.
.TP .TP
.BI $ modifier .BI $ modifier
@ -969,8 +969,8 @@ is one the breakpoint will fire.
Beware that local variables may be stored in registers; see the Beware that local variables may be stored in registers; see the
BUGS section. BUGS section.
.SH "SEE ALSO" .SH "SEE ALSO"
.IR acid (1), .IM acid (1) ,
.IR core (1) .IM core (1)
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/db .B \*9/src/cmd/db
.SH DIAGNOSTICS .SH DIAGNOSTICS

4
man/man1/dc.1
View file

@ -235,8 +235,8 @@ lyx
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/dc.c .B \*9/src/cmd/dc.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR bc (1), .IM bc (1) ,
.IR hoc (1) .IM hoc (1)
.SH DIAGNOSTICS .SH DIAGNOSTICS
.I x .I x
.LR "is unimplemented" , .LR "is unimplemented" ,

2
man/man1/dd.1
View file

@ -191,7 +191,7 @@ options become a simple file copy.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/dd.c .B \*9/src/cmd/dd.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR cp (1) .IM cp (1)
.SH DIAGNOSTICS .SH DIAGNOSTICS
.I Dd .I Dd
reports the number of full + partial input and output reports the number of full + partial input and output

16
man/man1/deroff.1
View file

@ -16,13 +16,13 @@ reads each file in sequence
and removes all and removes all
.I nroff .I nroff
and and
.IR troff (1) .IM troff (1)
requests and non-text arguments, backslash constructions, requests and non-text arguments, backslash constructions,
and constructs of preprocessors such as and constructs of preprocessors such as
.IR eqn (1), .IM eqn (1) ,
.IR pic (1), .IM pic (1) ,
and and
.IR tbl (1). .IM tbl (1) .
Remaining text is written on the standard output. Remaining text is written on the standard output.
.I Deroff .I Deroff
follows files included by follows files included by
@ -67,7 +67,7 @@ requests.
Remove titles, attachments, etc., as well as ordinary Remove titles, attachments, etc., as well as ordinary
.IR troff .IR troff
constructs, from constructs, from
.IR ms (7) .IM ms (7)
or or
.I mm .I mm
documents. documents.
@ -84,7 +84,7 @@ does for
and and
.I latex .I latex
(see (see
.IR tex (1)) .IM tex (1) )
files what files what
.B deroff -wi .B deroff -wi
does for does for
@ -96,8 +96,8 @@ files.
.B \*9/src/cmd/delatex.lx .B \*9/src/cmd/delatex.lx
.SH "SEE ALSO" .SH "SEE ALSO"
.IR troff (1), .IR troff (1),
.IR tex (1), .IM tex (1) ,
.IR spell (1) .IM spell (1)
.SH BUGS .SH BUGS
These filters are not complete interpreters of These filters are not complete interpreters of
.I troff .I troff

8
man/man1/devdraw.1
View file

@ -5,7 +5,7 @@ devdraw \- draw device simulator
invoked via invoked via
.I initdraw .I initdraw
(see (see
.IR graphics (3)) .IM graphics (3) )
.SH DESCRIPTION .SH DESCRIPTION
.I Devdraw .I Devdraw
serves a custom graphics protocol and is the only program serves a custom graphics protocol and is the only program
@ -20,9 +20,9 @@ to use all available physical pixels on a retina display.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/devdraw .B \*9/src/cmd/devdraw
.SH "SEE ALSO .SH "SEE ALSO
.IR draw (3), .IM draw (3) ,
.IR drawfcall (3), .IM drawfcall (3) ,
.IR graphics (3) .IM graphics (3)
.SH BUGS .SH BUGS
.I Devdraw .I Devdraw
should probably present a standard 9P server should probably present a standard 9P server

4
man/man1/dial.1
View file

@ -12,7 +12,7 @@ dial \- connect to a remote service
connects to the network address connects to the network address
.I addr .I addr
(see (see
.IR dial (3)) .IM dial (3) )
and then copies data from the connection to standard output, and then copies data from the connection to standard output,
and from standard input to the connection. and from standard input to the connection.
.PP .PP
@ -27,4 +27,4 @@ to exit only in response to end of file on the network connection.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/dial.c .B \*9/src/cmd/dial.c
.SH SEE ALSO .SH SEE ALSO
.IR dial (3) .IM dial (3)

6
man/man1/dict.1
View file

@ -53,7 +53,7 @@ Print a pronunciation key.
.PD .PD
.PP .PP
Patterns are regular expressions (see Patterns are regular expressions (see
.IR regexp (7)), .IM regexp (7) ),
with an implicit leading with an implicit leading
.L ^ .L ^
and trailing and trailing
@ -154,7 +154,7 @@ searches for dictionaries in the directory named by
.PP .PP
.I Adict .I Adict
is a dictionary browser for is a dictionary browser for
.IR acme (1). .IM acme (1) .
When run with no arguments, it creates a new When run with no arguments, it creates a new
.I acme .I acme
window named window named
@ -193,7 +193,7 @@ window.
dictionaries dictionaries
.PD .PD
.SH "SEE ALSO" .SH "SEE ALSO"
.IR regexp (7) .IM regexp (7)
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/dict .B \*9/src/cmd/dict
.br .br

8
man/man1/diff.1
View file

@ -19,7 +19,7 @@ two directories are compared by the method of
.I diff .I diff
for text for text
files and files and
.IR cmp (1) .IM cmp (1)
otherwise. otherwise.
If more than two file names are given, then each argument is compared If more than two file names are given, then each argument is compared
to the last argument as above. to the last argument as above.
@ -140,9 +140,9 @@ differences.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/diff .B \*9/src/cmd/diff
.SH "SEE ALSO" .SH "SEE ALSO"
.IR cmp (1), .IM cmp (1) ,
.IR comm (1), .IM comm (1) ,
.IR ed (1) .IM ed (1)
.SH DIAGNOSTICS .SH DIAGNOSTICS
Exit status is the empty string Exit status is the empty string
for no differences, for no differences,

14
man/man1/doctype.1
View file

@ -17,16 +17,16 @@ doctype \- intuit command line for formatting a document
.SH DESCRIPTION .SH DESCRIPTION
.I Doctype .I Doctype
examines a examines a
.IR troff (1) .IM troff (1)
input file to deduce the appropriate text formatting command input file to deduce the appropriate text formatting command
and prints it on standard output. and prints it on standard output.
.I Doctype .I Doctype
recognizes input for recognizes input for
.IR troff (1), .IM troff (1) ,
related preprocessors like related preprocessors like
.IR eqn (1), .IM eqn (1) ,
and the and the
.IR ms (7) .IM ms (7)
and and
.I mm .I mm
macro packages. macro packages.
@ -56,8 +56,8 @@ Typeset files named
.IR eqn (1), .IR eqn (1),
.IR tbl (1), .IR tbl (1),
.IR pic (1), .IR pic (1),
.IR grap (1), .IM grap (1) ,
.IR ms (7), .IM ms (7) ,
.IR man (7) .IM man (7)
.SH BUGS .SH BUGS
In true A.I. style, its best guesses are inspired rather than accurate. In true A.I. style, its best guesses are inspired rather than accurate.

10
man/man1/ed.1
View file

@ -96,7 +96,7 @@ beginning of a line.
supports the supports the
.I "regular expression" .I "regular expression"
notation described in notation described in
.IR regexp (7). .IM regexp (7) .
Regular expressions are used in addresses to specify Regular expressions are used in addresses to specify
lines and in one command lines and in one command
(see (see
@ -641,7 +641,7 @@ Dot is unchanged.
Send the remainder of the line after the Send the remainder of the line after the
.L ! .L !
to to
.IR rc (1) .IM rc (1)
to be interpreted as a command. to be interpreted as a command.
Dot is unchanged. Dot is unchanged.
.TP .TP
@ -679,9 +679,9 @@ and all characters after the last newline.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/ed.c .B \*9/src/cmd/ed.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR sam (1), .IM sam (1) ,
.IR sed (1), .IM sed (1) ,
.IR regexp (7) .IM regexp (7)
.SH DIAGNOSTICS .SH DIAGNOSTICS
.BI ? name .BI ? name
for inaccessible file; for inaccessible file;

8
man/man1/eqn.1
View file

@ -15,7 +15,7 @@ eqn \- typeset mathematics
.SH DESCRIPTION .SH DESCRIPTION
.I Eqn .I Eqn
is a is a
.IR troff (1) .IM troff (1)
preprocessor preprocessor
for typesetting mathematics for typesetting mathematics
on a typesetter. on a typesetter.
@ -34,7 +34,7 @@ named in the
option (default option (default
.BR -Tutf ; .BR -Tutf ;
see see
.IR troff (1)). .IM troff (1) ).
When run with other preprocessor filters, When run with other preprocessor filters,
.I eqn .I eqn
usually comes last. usually comes last.
@ -299,7 +299,7 @@ Mathematical words like
.LR cos , .LR cos ,
.L log .L log
are made Roman automatically. are made Roman automatically.
.IR Troff (1) .IM Troff (1)
four-character escapes like four-character escapes like
.L \e(lh .L \e(lh
(\(lh) can be used anywhere. (\(lh) can be used anywhere.
@ -319,7 +319,7 @@ font descriptions for PostScript
.B \*9/src/cmd/eqn .B \*9/src/cmd/eqn
.SH "SEE ALSO" .SH "SEE ALSO"
.IR troff (1), .IR troff (1),
.IR tbl (1) .IM tbl (1)
.br .br
J. F. Ossanna and B. W. Kernighan, J. F. Ossanna and B. W. Kernighan,
``Troff User's Manual''. ``Troff User's Manual''.

4
man/man1/freq.1
View file

@ -36,5 +36,5 @@ character, respectively.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/freq.c .B \*9/src/cmd/freq.c
.SH SEE ALSO .SH SEE ALSO
.IR utf (7), .IM utf (7) ,
.IR wc (1) .IM wc (1)

4
man/man1/git.1
View file

@ -55,7 +55,7 @@ current file tree.
.I Git .I Git
.I diff .I diff
runs Unix's runs Unix's
.IR diff (1) .IM diff (1)
to compare the files in the local tree with the corresponding to compare the files in the local tree with the corresponding
files in the revision history. files in the revision history.
The special revision The special revision
@ -76,7 +76,7 @@ directory containing Git local repository
list of files and wildcards to exclude from Git operations list of files and wildcards to exclude from Git operations
.SH SEE ALSO .SH SEE ALSO
Unix's Unix's
\fIgit\fR(1), .IR git (1),
.HR http://git-scm.com/doc .HR http://git-scm.com/doc
.PP .PP
.HR https://9fans.github.io/plan9port/ .HR https://9fans.github.io/plan9port/

4
man/man1/grap.1
View file

@ -9,7 +9,7 @@ grap \- pic preprocessor for drawing graphs
.SH DESCRIPTION .SH DESCRIPTION
.I Grap .I Grap
is a is a
.IR pic (1) .IM pic (1)
preprocessor for drawing graphs on a typesetter. preprocessor for drawing graphs on a typesetter.
Graphs are surrounded by the Graphs are surrounded by the
.I troff .I troff
@ -407,7 +407,7 @@ definitions of standard plotting characters, e.g., bullet
.B \*9/src/cmd/grap .B \*9/src/cmd/grap
.SH "SEE ALSO" .SH "SEE ALSO"
.IR pic (1), .IR pic (1),
.IR troff (1) .IM troff (1)
.br .br
J. L. Bentley and B. W. Kernighan, J. L. Bentley and B. W. Kernighan,
``GRAP\(emA Language for Typesetting Graphs'', ``GRAP\(emA Language for Typesetting Graphs'',

4
man/man1/graph.1
View file

@ -89,7 +89,7 @@ The next argument is
Next argument is one or more of the characters Next argument is one or more of the characters
.B bcgkmrwy, .B bcgkmrwy,
choosing pen colors by their initial letter, as in choosing pen colors by their initial letter, as in
.IR plot (7). .IM plot (7) .
Successive curves will cycle through the colors in the given order. Successive curves will cycle through the colors in the given order.
.TP .TP
.B -s .B -s
@ -145,7 +145,7 @@ is reversed.
.B \*9/src/cmd/graph .B \*9/src/cmd/graph
.SH "SEE ALSO" .SH "SEE ALSO"
.IR plot (1), .IR plot (1),
.IR grap (1) .IM grap (1)
.SH BUGS .SH BUGS
Segments that run out of bounds are dropped, not windowed. Segments that run out of bounds are dropped, not windowed.
Logarithmic axes may not be reversed. Logarithmic axes may not be reversed.

12
man/man1/grep.1
View file

@ -27,7 +27,7 @@ searches the input
for lines that match the for lines that match the
.IR pattern , .IR pattern ,
a regular expression as defined in a regular expression as defined in
.IR regexp (7) .IM regexp (7)
with the addition of a newline character as an alternative with the addition of a newline character as an alternative
(substitute for (substitute for
.BR | ) .BR | )
@ -114,11 +114,11 @@ If no files are listed, it searches all files matching
.br .br
.B \*9/bin/g .B \*9/bin/g
.SH SEE ALSO .SH SEE ALSO
.IR ed (1), .IM ed (1) ,
.IR awk (1), .IM awk (1) ,
.IR sed (1), .IM sed (1) ,
.IR sam (1), .IM sam (1) ,
.IR regexp (7) .IM regexp (7)
.SH DIAGNOSTICS .SH DIAGNOSTICS
Exit status is null if any lines are selected, Exit status is null if any lines are selected,
or non-null when no lines are selected or an error occurs. or non-null when no lines are selected or an error occurs.

2
man/man1/gview.1
View file

@ -144,7 +144,7 @@ awk 'BEGIN{for(x=.1;x<500;x+=.1)print x,sin(x)/x}' | gview
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/draw/gview.c .B \*9/src/cmd/draw/gview.c
.SH SEE ALSO .SH SEE ALSO
.IR awk (1) .IM awk (1)
.SH BUGS .SH BUGS
The user interface for the The user interface for the
.I slant .I slant

4
man/man1/gzip.1
View file

@ -150,8 +150,8 @@ Produce debugging output.
.br .br
.B \*9/src/cmd/bzip2 .B \*9/src/cmd/bzip2
.SH SEE ALSO .SH SEE ALSO
.IR tar (1), .IM tar (1) ,
.IR compress (1) .IM compress (1)
.SH BUGS .SH BUGS
.I Unzip .I Unzip
can only extract files which are uncompressed or compressed can only extract files which are uncompressed or compressed

8
man/man1/hist.1
View file

@ -41,7 +41,7 @@ option enables verbose debugging printout.
The The
.B -d .B -d
option causes option causes
.IR diff (1) .IM diff (1)
.B -c .B -c
to be run for each adjacent pair of dump files, while to be run for each adjacent pair of dump files, while
.B -b .B -b
@ -73,11 +73,11 @@ by convention, root of dump file system
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/hist.c .B \*9/src/cmd/hist.c
.SH SEE ALSO .SH SEE ALSO
.IR yesterday (1), .IM yesterday (1) ,
.IR vbackup (8) .IM vbackup (8)
.SH BUGS .SH BUGS
Should be called Should be called
.IR history , .IR history ,
but but
that name is taken by that name is taken by
.IR sh (1). .IM sh (1) .

4
man/man1/hoc.1
View file

@ -133,8 +133,8 @@ for(i=1; i<12; i++) print gcd(i,12)
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/hoc .B \*9/src/cmd/hoc
.SH "SEE ALSO" .SH "SEE ALSO"
.IR bc (1), .IM bc (1) ,
.IR dc (1) .IM dc (1)
.br .br
B. W. Kernighan and R. Pike, B. W. Kernighan and R. Pike,
.I .I

18
man/man1/htmlroff.1
View file

@ -21,7 +21,7 @@ htmlroff \- HTML formatting and typesetting
.SH DESCRIPTION .SH DESCRIPTION
.I Htmlroff .I Htmlroff
accepts accepts
.IR troff (1) .IM troff (1)
input in the named input in the named
.I files .I files
and formats it as HTML for viewing in a web browser. and formats it as HTML for viewing in a web browser.
@ -63,7 +63,7 @@ HTML entity sequences
and so on). and so on).
.I Htmlroff .I Htmlroff
invokes invokes
.IR tcs (1) .IM tcs (1)
for the conversion. for the conversion.
.TP .TP
.B -v .B -v
@ -73,7 +73,7 @@ Generate debugging output and warnings about suspicious input.
Most Most
.I troff .I troff
input files, especially those using the input files, especially those using the
.IR ms (7) .IM ms (7)
macros, can be used unaltered. macros, can be used unaltered.
In general, the macro file In general, the macro file
.B tmac.html .B tmac.html
@ -83,10 +83,10 @@ as in
.B -ms .B -ms
.BR -mhtml . .BR -mhtml .
.PP .PP
.IR Htmlroff (7) .IM Htmlroff (7)
describes the changes to the input language. describes the changes to the input language.
.PP .PP
.IR Mhtml (7) .IM Mhtml (7)
describes the new macros. describes the new macros.
.SH EXAMPLES .SH EXAMPLES
Format the Plan 9 web page: Format the Plan 9 web page:
@ -113,7 +113,7 @@ to Unicode characters like α.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/htmlroff .B \*9/src/cmd/htmlroff
.SH "SEE ALSO .SH "SEE ALSO
.IR tcs (1), .IM tcs (1) ,
.IR troff (1), .IM troff (1) ,
.IR htmlroff (7), .IM htmlroff (7) ,
.IR mhtml (7) .IM mhtml (7)

4
man/man1/idiff.1
View file

@ -50,7 +50,7 @@ and prompt again.
.PP .PP
.I Idiff .I Idiff
invokes invokes
.IR diff (1) .IM diff (1)
to compare the files. to compare the files.
The The
.B -b .B -b
@ -66,7 +66,7 @@ passed to
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/idiff.c .B \*9/src/cmd/idiff.c
.SH "SEE ALSO .SH "SEE ALSO
.IR diff (1) .IM diff (1)
.br .br
Kernighan and Pike, Kernighan and Pike,
.IR "The Unix Programming Environment" , .IR "The Unix Programming Environment" ,

14
man/man1/install.1
View file

@ -15,7 +15,7 @@ cd \*9; ./INSTALL
.SH DESCRIPTION .SH DESCRIPTION
To obtain the Plan 9 tree, use Git To obtain the Plan 9 tree, use Git
(see (see
.IR git (1)) .IM git (1) )
or download a tar file from or download a tar file from
.HR https://9fans.github.io/plan9port "" . .HR https://9fans.github.io/plan9port "" .
.PP .PP
@ -25,7 +25,7 @@ usual place is
In the root of the tree, run In the root of the tree, run
.BR ./INSTALL . .BR ./INSTALL .
This script builds the Plan 9 build program This script builds the Plan 9 build program
.IR mk (1) .IM mk (1)
if necessary, if necessary,
cleans all previously built object files and libraries out of the tree, cleans all previously built object files and libraries out of the tree,
rebuilds and installs everything, and then cleans up. rebuilds and installs everything, and then cleans up.
@ -109,7 +109,7 @@ can safely be repeated to rebuild the system from scratch.
.PP .PP
Once the system is built for the first time, Once the system is built for the first time,
it can be maintained and rebuilt using it can be maintained and rebuilt using
.IR mk (1). .IM mk (1) .
To rebuild individual commands or libraries, To rebuild individual commands or libraries,
run run
.B mk .B mk
@ -119,7 +119,7 @@ and
.B clean .B clean
in the appropriate source directory in the appropriate source directory
(see (see
.IR src (1)). .IM src (1) ).
.SH FILES .SH FILES
.TP .TP
.B \*9/lib/moveplan9.files .B \*9/lib/moveplan9.files
@ -132,7 +132,7 @@ the script that edits the files
.TP .TP
.B \*9/src/mkmk.sh .B \*9/src/mkmk.sh
the shell script used to build the shell script used to build
.IR mk (1) .IM mk (1)
.TP .TP
.B \*9/dist/manweb .B \*9/dist/manweb
the shell script that builds the HTML manual the shell script that builds the HTML manual
@ -148,5 +148,5 @@ logged output from the last run of
a summary of a summary of
.B install.log .B install.log
.SH SEE ALSO .SH SEE ALSO
.IR intro (1), .IM intro (1) ,
.IR git (1) .IM git (1)

4
man/man1/join.1
View file

@ -114,7 +114,7 @@ birthdays empty.
The layout of The layout of
.B /adm/users .B /adm/users
is given in is given in
.IR passwd (5); .IM passwd (5) ;
.B bdays .B bdays
contains sorted lines like contains sorted lines like
.LR "ken:Feb\ 4,\ 1953" . .LR "ken:Feb\ 4,\ 1953" .
@ -132,7 +132,7 @@ Print all pairs of users with identical userids.
.SH "SEE ALSO" .SH "SEE ALSO"
.IR sort (1), .IR sort (1),
.IR comm (1), .IR comm (1),
.IR awk (1) .IM awk (1)
.SH BUGS .SH BUGS
With default field separation, With default field separation,
the collating sequence is that of the collating sequence is that of

10
man/man1/jpg.1
View file

@ -122,7 +122,7 @@ Typing a
.BR q , .BR q ,
DEL, or control-D exits the program. DEL, or control-D exits the program.
For a more user-friendly interface, use For a more user-friendly interface, use
.IR page (1), .IM page (1) ,
which invokes these programs to convert the images to standard format, which invokes these programs to convert the images to standard format,
displays them, and offers scrolling, panning, and menu-driven navigation among the files. displays them, and offers scrolling, panning, and menu-driven navigation among the files.
.PP .PP
@ -147,7 +147,7 @@ any of the following options:
.TP .TP
.B -c .B -c
Convert the image to a Plan 9 representation, as defined by Convert the image to a Plan 9 representation, as defined by
.IR image (7), .IM image (7) ,
and write it to standard output. and write it to standard output.
.TP .TP
.B -9 .B -9
@ -156,7 +156,7 @@ Like
but produce an uncompressed image. but produce an uncompressed image.
This saves processing time, particularly when the output is This saves processing time, particularly when the output is
being piped to another program such as being piped to another program such as
.IR page (1), .IM page (1) ,
since it avoids compression and decompression. since it avoids compression and decompression.
.TP .TP
.B -t .B -t
@ -235,8 +235,8 @@ space in the image. The icon file is written to standard output.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/jpg .B \*9/src/cmd/jpg
.SH "SEE ALSO" .SH "SEE ALSO"
.IR page (1), .IM page (1) ,
.IR image (7). .IM image (7) .
.SH BUGS .SH BUGS
Writing an animated GIF using Writing an animated GIF using
.I togif .I togif

12
man/man1/kill.1
View file

@ -19,18 +19,18 @@ prints commands that will cause all processes with
.I name .I name
and owned by the current user to be terminated. and owned by the current user to be terminated.
Each command is commented with an output line from Each command is commented with an output line from
.IR ps (1) .IM ps (1)
describing the process that would be killed. describing the process that would be killed.
Use the Use the
.B send .B send
command of command of
.IR 9term (1), .IM 9term (1) ,
or pipe the output of or pipe the output of
.I kill .I kill
into into
.IR rc (1) .IM rc (1)
or or
.IR sh (1) .IM sh (1)
to execute the commands. to execute the commands.
.PP .PP
.I Kill .I Kill
@ -60,8 +60,8 @@ signal.
.SH SOURCE .SH SOURCE
.B \*9/bin .B \*9/bin
.SH "SEE ALSO" .SH "SEE ALSO"
.IR ps (1), .IM ps (1) ,
.IR notify (3) .IM notify (3)
.SH BUGS .SH BUGS
.I Stop .I Stop
and and

12
man/man1/label.1
View file

@ -14,12 +14,12 @@ label, awd \- set window label
sets the label of the current sets the label of the current
.I win .I win
(see (see
.IR acme (1)) .IM acme (1) )
or X terminal window or X terminal window
.RI ( e.g., .RI ( e.g.,
.IR 9term (1) .IM 9term (1)
or or
.IR xterm (1)) .IM xterm (1) )
by echoing a special control sequence to standard output. by echoing a special control sequence to standard output.
.PP .PP
.I Acme .I Acme
@ -38,7 +38,7 @@ sets the window name to the current directory with a
suffix, using the name of the current system by default. suffix, using the name of the current system by default.
.SH EXAMPLE .SH EXAMPLE
One can use the following One can use the following
.IR sh (1) .IM sh (1)
function to keep the label up-to-date in response to function to keep the label up-to-date in response to
.I cd .I cd
commands: commands:
@ -55,7 +55,7 @@ alias cd=_cd
cd . cd .
.EE .EE
.PP .PP
.IR Rc (1) .IM Rc (1)
installs a similar installs a similar
.B fn .B fn
.B cd .B cd
@ -77,4 +77,4 @@ fn cd {
.SH BUGS .SH BUGS
.I Awd .I Awd
is also documented in is also documented in
.IR acme (1). .IM acme (1) .

2
man/man1/lex.1
View file

@ -65,7 +65,7 @@ output
template template
.SH "SEE ALSO" .SH "SEE ALSO"
.IR yacc (1), .IR yacc (1),
.IR sed (1) .IM sed (1)
.br .br
M. E. Lesk and E. Schmidt, M. E. Lesk and E. Schmidt,
`LEX\(emLexical Analyzer Generator', `LEX\(emLexical Analyzer Generator',

2
man/man1/look.1
View file

@ -74,7 +74,7 @@ is assumed, with collating sequence
.B \*9/src/cmd/look.c .B \*9/src/cmd/look.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR sort (1), .IR sort (1),
.IR grep (1) .IM grep (1)
.SH DIAGNOSTICS .SH DIAGNOSTICS
The exit status is The exit status is
.RB `` "not found" '' .RB `` "not found" ''

12
man/man1/ls.1
View file

@ -29,7 +29,7 @@ is the same as
but sets the but sets the
.B -p .B -p
option and pipes the output through option and pipes the output through
.IR mc (1). .IM mc (1) .
.PP .PP
There are a number of options: There are a number of options:
.TP .TP
@ -42,7 +42,7 @@ List in long format, giving mode (see below), file system type
(e.g., for devices, the (e.g., for devices, the
.B # .B #
code letter that names it; see code letter that names it; see
.IR intro (3)), .IM intro (3) ),
the instance or subdevice number, owner, group, the instance or subdevice number, owner, group,
size in bytes, and time of last modification size in bytes, and time of last modification
for each file. for each file.
@ -60,7 +60,7 @@ Print only the final path element of each file name.
List the List the
.I qid .I qid
(see (see
.IR stat (3)) .IM stat (3) )
of each file; the printed fields are in the order of each file; the printed fields are in the order
path, version, and type. path, version, and type.
.TP .TP
@ -99,7 +99,7 @@ otherwise.
.TP .TP
.B -Q .B -Q
By default, printed file names are quoted if they contain characters special to By default, printed file names are quoted if they contain characters special to
.IR rc (1). .IM rc (1) .
The The
.B -Q .B -Q
flag disables this behavior. flag disables this behavior.
@ -168,5 +168,5 @@ if none of the above permissions is granted.
.br .br
.B \*9/bin/lc .B \*9/bin/lc
.SH SEE ALSO .SH SEE ALSO
.IR stat (3), .IM stat (3) ,
.IR mc (1) .IM mc (1)

12
man/man1/man.1
View file

@ -45,7 +45,7 @@ The options are:
.TP .TP
.B -h .B -h
Print the pages to HTML and send to a web browser with Print the pages to HTML and send to a web browser with
.IR web (1). .IM web (1) .
.TP .TP
.B -n .B -n
(Default) (Default)
@ -54,17 +54,17 @@ Print the pages on the standard output using
.TP .TP
.B -p .B -p
Run Run
.IR proof (1) .IM proof (1)
on the specified man pages. on the specified man pages.
.TP .TP
.B -P .B -P
Run Run
.IR page (1) .IM page (1)
on the specified man pages. on the specified man pages.
.TP .TP
.B -t .B -t
Run Run
.IR troff (1) .IM troff (1)
and send its output and send its output
to standard output. to standard output.
.TP .TP
@ -106,8 +106,8 @@ index for
.br .br
.B \*9/bin/lookman .B \*9/bin/lookman
.SH "SEE ALSO" .SH "SEE ALSO"
.IR page (1), .IM page (1) ,
.IR proof (1) .IM proof (1)
.SH BUGS .SH BUGS
The manual was intended to be typeset; some detail is sacrificed on text terminals. The manual was intended to be typeset; some detail is sacrificed on text terminals.
.PP .PP

4
man/man1/map.1
View file

@ -305,7 +305,7 @@ tracks appear as dot-dashed lines if the plotting filter supports them.)
The The
.I file .I file
contains contains
.IR plot (7)-style .IM plot (7) -style
data for data for
.L : .L :
or or
@ -640,7 +640,7 @@ Map driver program
.B \*9/src/cmd/map .B \*9/src/cmd/map
.SH "SEE ALSO" .SH "SEE ALSO"
.IR map (7), .IR map (7),
.IR plot (1) .IM plot (1)
.SH DIAGNOSTICS .SH DIAGNOSTICS
`Map seems to be empty'\(ema coarse survey found `Map seems to be empty'\(ema coarse survey found
zero extent within the zero extent within the

18
man/man1/mc.1
View file

@ -18,10 +18,10 @@ splits the input into as many columns as will fit in
.I N .I N
print positions. print positions.
If run in a If run in a
.IR 9term (1), .IM 9term (1) ,
.IR xterm (1), .IM xterm (1) ,
or or
.IR acme (1) .IM acme (1)
window, the default window, the default
.I N .I N
is the number of blanks that will fit across the window; is the number of blanks that will fit across the window;
@ -36,14 +36,14 @@ is printed separately.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/draw/mc.c .B \*9/src/cmd/draw/mc.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR 9term (1), .IM 9term (1) ,
.IR acme (1), .IM acme (1) ,
.IR acme (4), .IM acme (4) ,
.IR xterm (1), .IM xterm (1) ,
.IR pr (1), .IM pr (1) ,
.I lc .I lc
in in
.IR ls (1) .IM ls (1)
.SH BUGS .SH BUGS
On systems with high-DPI screens, On systems with high-DPI screens,
.I 9term .I 9term

24
man/man1/mk.1
View file

@ -29,7 +29,7 @@ contains a
.I rule .I rule
for each target that identifies the files and other for each target that identifies the files and other
targets upon which it depends and an targets upon which it depends and an
.IR sh (1) .IM sh (1)
script, a script, a
.IR recipe , .IR recipe ,
to update the target. to update the target.
@ -157,7 +157,7 @@ In the recipe of a meta-rule, the environment variable
contains the string matched by the contains the string matched by the
.BR % . .BR % .
For example, a meta-rule to compile a C program using For example, a meta-rule to compile a C program using
.IR 9c (1) .IM 9c (1)
might be: might be:
.IP .IP
.EX .EX
@ -207,7 +207,7 @@ References to variables are replaced by the variables' values.
Special characters may be quoted using single quotes Special characters may be quoted using single quotes
.BR \&'' .BR \&''
as in as in
.IR sh (1). .IM sh (1) .
.PP .PP
Assignments and rules are distinguished by Assignments and rules are distinguished by
the first unquoted occurrence of the first unquoted occurrence of
@ -246,7 +246,7 @@ A legal reference of the form
or or
.B ${name} .B ${name}
is expanded as in is expanded as in
.IR sh (1). .IM sh (1) .
A reference of the form A reference of the form
.BI ${name: A % B = C\fL%\fID\fL}\fR, .BI ${name: A % B = C\fL%\fID\fL}\fR,
where where
@ -315,9 +315,9 @@ or
.BR rcsh , .BR rcsh ,
.I mk .I mk
uses uses
.IR rc (1)'s .IM rc (1) 's
quoting rules; otherwise it uses quoting rules; otherwise it uses
.IR sh (1)'s. .IM sh (1) 's.
The The
.B MKSHELL .B MKSHELL
variable is consulted when the mkfile is read, not when it is executed, variable is consulted when the mkfile is read, not when it is executed,
@ -523,7 +523,7 @@ of the aggregate
Currently, the only aggregates supported are Currently, the only aggregates supported are
.I 9ar .I 9ar
(see (see
.IR 9c (1)) .IM 9c (1) )
archives. archives.
.SS Attributes .SS Attributes
The colon separating the target from the prerequisites The colon separating the target from the prerequisites
@ -567,12 +567,12 @@ In the rule,
.B % .B %
has no special meaning. has no special meaning.
The target is interpreted as a regular expression as defined in The target is interpreted as a regular expression as defined in
.IR regexp (7). .IM regexp (7) .
The prerequisites may contain references The prerequisites may contain references
to subexpressions in form to subexpressions in form
.BI \e n\f1, .BI \e n\f1,
as in the substitute command of as in the substitute command of
.IR sed (1). .IM sed (1) .
.TP .TP
.B U .B U
The targets are considered to have been updated The targets are considered to have been updated
@ -625,7 +625,7 @@ Regular expression meta-rules:
.EE .EE
.PP .PP
A correct way to deal with A correct way to deal with
.IR yacc (1) .IM yacc (1)
grammars. grammars.
The file The file
.B lex.c .B lex.c
@ -656,8 +656,8 @@ x.tab.h:Pcmp -s: y.tab.h
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/mk .B \*9/src/cmd/mk
.SH SEE ALSO .SH SEE ALSO
.IR sh (1), .IM sh (1) ,
.IR regexp (7) .IM regexp (7)
.PP .PP
A. Hume, A. Hume,
``Mk: a Successor to Make'' ``Mk: a Successor to Make''

9
man/man1/mk9660.1
View file

@ -71,7 +71,7 @@ the current directory).
The The
.I proto .I proto
file is formatted as described in file is formatted as described in
.IR proto (3). .IM proto (3) .
.PP .PP
The created CD image will be in ISO-9660 The created CD image will be in ISO-9660
format, but by default the file names will format, but by default the file names will
@ -161,7 +161,7 @@ flag causes
.B mk9660 .B mk9660
to replace colons in scanned file names with spaces; to replace colons in scanned file names with spaces;
this is the inverse of the map applied by Plan 9's this is the inverse of the map applied by Plan 9's
\fIdossrv\fR(4) .IR dossrv (4)
and is useful for writing Joliet CDs containing data and is useful for writing Joliet CDs containing data
from FAT file systems. from FAT file systems.
.PP .PP
@ -192,7 +192,8 @@ but creates and updates backup CD images in the style of
the the
.I dump .I dump
file system file system
(see Plan 9's \fIfs\fR(4)). (see Plan 9's
.IR fs (4)).
The dump is file-based rather than block-based: The dump is file-based rather than block-based:
if a file's contents have not changed since the last if a file's contents have not changed since the last
backup, only its directory entry will be rewritten. backup, only its directory entry will be rewritten.
@ -223,7 +224,7 @@ mk9660 -9cj -s /n/bootes -p srcproto cdimage
.SH SOURCE .SH SOURCE
\*9/src/cmd/9660 \*9/src/cmd/9660
.SH "SEE ALSO .SH "SEE ALSO
.IR proto (3) .IM proto (3)
.\" .SH "SEE ALSO" .\" .SH "SEE ALSO"
.\" .I 9660srv .\" .I 9660srv
.\" (in .\" (in

4
man/man1/mkdir.1
View file

@ -28,11 +28,11 @@ The
flag sets the permissions to be used when creating the directory. flag sets the permissions to be used when creating the directory.
The default is 0777. The default is 0777.
.SH "SEE ALSO" .SH "SEE ALSO"
.IR rm (1) .IM rm (1)
.br .br
.IR cd .IR cd
in in
.IR rc (1) .IM rc (1)
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/mkdir.c .B \*9/src/cmd/mkdir.c
.SH DIAGNOSTICS .SH DIAGNOSTICS

10
man/man1/mount.1
View file

@ -15,7 +15,7 @@ mounts a 9P server's files into the file system.
is typically is typically
either the name of a Unix domain socket either the name of a Unix domain socket
(see (see
.IR namespace (1)) .IM namespace (1) )
or the name or IP address of a machine or the name or IP address of a machine
serving 9P over TCP port 564. serving 9P over TCP port 564.
.PP .PP
@ -29,7 +29,7 @@ On Linux,
.I mount .I mount
uses the native 9P kernel module when present. uses the native 9P kernel module when present.
Otherwise it tries to use Otherwise it tries to use
.IR 9pfuse (4) .IM 9pfuse (4)
with the FUSE file system module. with the FUSE file system module.
Using the 9P kernel module requires root access. Using the 9P kernel module requires root access.
FUSE can often be used by regular users. FUSE can often be used by regular users.
@ -45,7 +45,7 @@ should be invoked as
.BR mount . .BR mount .
.SH EXAMPLES .SH EXAMPLES
Mount Mount
.IR acme (4) .IM acme (4)
onto onto
.B /mnt/acme : .B /mnt/acme :
.IP .IP
@ -64,6 +64,6 @@ cat /mnt/plumb/rules
.br .br
.B \*9/bin/unmount .B \*9/bin/unmount
.SH SEE ALSO .SH SEE ALSO
.IR intro (4), .IM intro (4) ,
.IR intro (9p), .IR intro (9p),
.IR 9pfuse (4) .IM 9pfuse (4)

6
man/man1/namespace.1
View file

@ -7,9 +7,9 @@ namespace \- print name space directory
.I Namespace .I Namespace
prints the directory representing the current name space. prints the directory representing the current name space.
See See
.IR intro (4). .IM intro (4) .
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/namespace.c .B \*9/src/cmd/namespace.c
.SH SEE ALSO .SH SEE ALSO
.IR getns (3), .IM getns (3) ,
.IR intro (4) .IM intro (4)

14
man/man1/ndb.1
View file

@ -24,9 +24,9 @@ ndbquery, ndbmkhash, ndbmkdb, ndbipquery, ndbmkhosts \- network database
The network database holds administrative information used by The network database holds administrative information used by
.I authdial .I authdial
(see (see
.IR authsrv (3)) .IM authsrv (3) )
and and
.IR secstored (1). .IM secstored (1) .
.PP .PP
.I Ndbquery .I Ndbquery
searches the database for an attribute of type searches the database for an attribute of type
@ -46,7 +46,7 @@ of all the matched entries is returned.
uses uses
.I ndbipinfo .I ndbipinfo
(see (see
.IR ndb (3)) .IM ndb (3) )
to search for the values of the attributes to search for the values of the attributes
.I rattr .I rattr
corresponding to the system corresponding to the system
@ -382,7 +382,7 @@ and by the ndb library routines.
.PP .PP
.I Ndbmkdb .I Ndbmkdb
is used in concert with is used in concert with
.IR awk (1) .IM awk (1)
scripts to convert scripts to convert
uucp systems files and IP host files uucp systems files and IP host files
into database files. into database files.
@ -395,7 +395,7 @@ it is necessary to run
.I ndbmkhash .I ndbmkhash
whenever the files are modified. whenever the files are modified.
It may be profitable to control this by a frequent It may be profitable to control this by a frequent
.IR cron (8) .IM cron (8)
job. job.
.PP .PP
.I Ndbmkhosts .I Ndbmkhosts
@ -439,5 +439,5 @@ hash files for
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/ndb .B \*9/src/cmd/ndb
.SH SEE ALSO .SH SEE ALSO
.IR ndb (3), .IM ndb (3) ,
.IR ndb (7) .IM ndb (7)

26
man/man1/netfiles.1
View file

@ -21,7 +21,7 @@ Netfiles, netfileget, netfileput, netfilestat \- network file access inside acme
.SH DESCRIPTION .SH DESCRIPTION
.B Netfiles .B Netfiles
presents remote file systems in presents remote file systems in
.IR acme (4) .IM acme (4)
windows. windows.
Each window is named Each window is named
.BI /n/ system / path .BI /n/ system / path
@ -35,7 +35,7 @@ reads names of windows to create from the
plumbing channel plumbing channel
.B netfileedit .B netfileedit
(see (see
.IR plumber (4) .IM plumber (4)
and the example section below). and the example section below).
In a In a
.IR netfiles -controlled .IR netfiles -controlled
@ -60,13 +60,13 @@ The three first check to see if
.I system .I system
is a service in the current name space is a service in the current name space
(see (see
.IR intro (4)). .IM intro (4) ).
If so, they use If so, they use
.IR 9p (1) .IM 9p (1)
to access it. to access it.
Otherwise, they assume that the system is a network name Otherwise, they assume that the system is a network name
and use and use
.IR ssh (1)'s .IM ssh (1) 's
.I sftp .I sftp
to access it. to access it.
.PP .PP
@ -100,7 +100,7 @@ or
.SH EXAMPLES .SH EXAMPLES
The following plumbing rule The following plumbing rule
(see (see
.IR plumb (7)) .IM plumb (7) )
passes passes
.B /n/ .B /n/
paths to paths to
@ -118,17 +118,17 @@ plumb client Netfiles
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/netfiles .B \*9/src/cmd/netfiles
.SH SEE ALSO .SH SEE ALSO
.IR 9p (1), .IM 9p (1) ,
.IR ssh (1), .IM ssh (1) ,
.IR ssh-agent (1), .IM ssh-agent (1) ,
.IR intro (4), .IM intro (4) ,
.IR acme (4), .IM acme (4) ,
.IR factotum (4), .IM factotum (4) ,
.HR http://v9fs.sf.net .HR http://v9fs.sf.net
.SH BUGS .SH BUGS
.I Netfiles .I Netfiles
depends on depends on
.IR sftpcache (1), .IM sftpcache (1) ,
which only works with OpenSSH versions 4.3 and earlier; which only works with OpenSSH versions 4.3 and earlier;
later versions do not print the later versions do not print the
.B sftp> .B sftp>

31
man/man1/page.1
View file

@ -25,9 +25,10 @@ of a
PostScript, PostScript,
PDF, PDF,
or or
.IR troff (1) .IM troff (1)
or or
Unix's \fItex\fR(1) Unix's
.IR tex (1)
device-independent output device-independent output
file. file.
.I Troff .I Troff
@ -40,7 +41,7 @@ graphics files
FAX FAX
page, page,
a Plan 9 a Plan 9
.IR image (7) .IM image (7)
file, an Inferno bitmap file, or other common format). file, an Inferno bitmap file, or other common format).
.I Page .I Page
displays these displays these
@ -107,7 +108,7 @@ it listens to the
.B image .B image
plumbing channel plumbing channel
(see (see
.IR plumber (4)) .IM plumber (4) )
for more images to display. for more images to display.
The The
.B -i .B -i
@ -128,7 +129,8 @@ The
option causes option causes
.I page .I page
to call to call
Unix's \fIabort\fR(3) Unix's
.IR abort (3)
rather than exit cleanly on errors, rather than exit cleanly on errors,
to facilitate debugging. to facilitate debugging.
.PP .PP
@ -192,7 +194,7 @@ reverses the order in which pages are displayed.
Typing a Typing a
.B w .B w
will write the currently viewed page to a new file as a compressed will write the currently viewed page to a new file as a compressed
.IR image (7) .IM image (7)
file. file.
When possible, the filename is of the form When possible, the filename is of the form
.IR basename . pagenum . bit . .IR basename . pagenum . bit .
@ -208,13 +210,14 @@ changing pages when panning off the top or bottom of the page.
.PP .PP
.I Page .I Page
calls calls
Unix's \fIgs\fR(1) Unix's
.IR gs (1)
to draw each page of PostScript to draw each page of PostScript
and and
PDF PDF
.IR files . .IR files .
It also calls a variety of conversion programs, such as those described in It also calls a variety of conversion programs, such as those described in
.IR jpg (1), .IM jpg (1) ,
to convert the various raster graphics formats to convert the various raster graphics formats
into Inferno bitmap files. into Inferno bitmap files.
Pages are converted ``on the fly,'' as needed. Pages are converted ``on the fly,'' as needed.
@ -232,11 +235,11 @@ Browse the Inferno bitmap library.
man -t page | page -w man -t page | page -w
Preview this manual in a new window. Preview this manual in a new window.
.SH "SEE ALSO .SH "SEE ALSO
.IR gs (1), .IM gs (1) ,
.IR jpg (1), .IM jpg (1) ,
.IR proof (1), .IM proof (1) ,
.IR tex (1), .IM tex (1) ,
.IR troff (1) .IM troff (1)
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/page .B \*9/src/cmd/page
.SH DIAGNOSTICS .SH DIAGNOSTICS
@ -274,7 +277,7 @@ There are too many keyboard commands and menu items.
Displaying a PostScript or PDF file depends both on having Displaying a PostScript or PDF file depends both on having
GhostScript GhostScript
(see (see
.IR gs (1)) .IM gs (1) )
installed and on the underlying operating system installed and on the underlying operating system
providing a file descriptor device tree at providing a file descriptor device tree at
.BR /dev/fd . .BR /dev/fd .

14
man/man1/paint.1
View file

@ -19,7 +19,7 @@ If the optional
argument is specified, then it is read and used as the canvas. argument is specified, then it is read and used as the canvas.
.I Paint .I Paint
only recognizes Plan 9 bitmap format (see only recognizes Plan 9 bitmap format (see
.IR image (6)). .IM image (6) ).
.PP .PP
A number of immediate keyboard commands are recognized: A number of immediate keyboard commands are recognized:
.TP .TP
@ -74,12 +74,12 @@ Quits the program.
.SH SOURCE .SH SOURCE
.B /sys/src/cmd/paint.c .B /sys/src/cmd/paint.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR resample (1), .IM resample (1) ,
.IR rotate (1), .IM rotate (1) ,
.IR crop (1), .IM crop (1) ,
.IR jpg (1), .IM jpg (1) ,
.IR page (1), .IM page (1) ,
.IR image (6) .IM image (6)
.SH HISTORY .SH HISTORY
.I Paint .I Paint
first appeared in 9front (October, 2011). first appeared in 9front (October, 2011).

2
man/man1/passwd.1
View file

@ -36,7 +36,7 @@ It is a substitute for a SecureNet box.
.br .br
.B \*9/src/cmd/auth/passwd.c .B \*9/src/cmd/auth/passwd.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR encrypt (3) .IM encrypt (3)
.PP .PP
Robert Morris and Ken Thompson, Robert Morris and Ken Thompson,
``UNIX Password Security,'' ``UNIX Password Security,''

6
man/man1/pem.1
View file

@ -20,7 +20,7 @@ Privacy Enhanced Mail program but now commonly used for
other applications, notably TLS. other applications, notably TLS.
PEM encodes data in base 64 PEM encodes data in base 64
(see (see
.IR encode (3)) .IM encode (3) )
between lines of the form: between lines of the form:
.IP .IP
.EX .EX
@ -33,7 +33,7 @@ where
may be any string describing the encoded data. may be any string describing the encoded data.
The most common use of PEM format on Plan 9 is for encoding The most common use of PEM format on Plan 9 is for encoding
X.509 certificates; see X.509 certificates; see
.IR rsa (1). .IM rsa (1) .
.PP .PP
.I Pemdecode .I Pemdecode
extracts the named extracts the named
@ -62,4 +62,4 @@ hello world
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/auth .B \*9/src/cmd/auth
.SH "SEE ALSO .SH "SEE ALSO
.IR rsa (1) .IM rsa (1)

8
man/man1/pic.1
View file

@ -31,7 +31,7 @@ pic, tpic, svgpic \- troff and tex preprocessors for drawing pictures
.SH DESCRIPTION .SH DESCRIPTION
.I Pic .I Pic
is a is a
.IR troff (1) .IM troff (1)
preprocessor for drawing figures on a typesetter. preprocessor for drawing figures on a typesetter.
.I Pic .I Pic
code is contained between code is contained between
@ -300,7 +300,7 @@ statement removes the definition of a macro.
.PP .PP
.I Tpic .I Tpic
is a is a
.IR tex (1) .IM tex (1)
preprocessor that accepts preprocessor that accepts
.IR pic .IR pic
language. language.
@ -345,8 +345,8 @@ A: ellipse
.B \*9/src/cmd/pic .B \*9/src/cmd/pic
.SH "SEE ALSO" .SH "SEE ALSO"
.IR grap (1), .IR grap (1),
.IR doctype (1), .IM doctype (1) ,
.IR troff (1) .IM troff (1)
.br .br
B. W. Kernighan, B. W. Kernighan,
``PIC\(ema Graphics Language for Typesetting'', ``PIC\(ema Graphics Language for Typesetting'',

8
man/man1/plot.1
View file

@ -14,7 +14,7 @@ from the
.I files .I files
or standard input, or standard input,
drawing the results in a newly created drawing the results in a newly created
.IR rio (1) .IM rio (1)
window. window.
Plot persists until a newline is typed in the window. Plot persists until a newline is typed in the window.
Various options may be interspersed with the Various options may be interspersed with the
@ -31,7 +31,7 @@ Erase the screen.
.TP .TP
.BI -c " col" .BI -c " col"
Set the foreground color (see Set the foreground color (see
.IR plot (7) .IM plot (7)
for color names). for color names).
.TP .TP
.BI -f " fill" .BI -f " fill"
@ -57,5 +57,5 @@ middle of the screen.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/plot .B \*9/src/cmd/plot
.SH "SEE ALSO" .SH "SEE ALSO"
.IR rio (1), .IM rio (1) ,
.IR plot (7) .IM plot (7)

6
man/man1/plumb.1
View file

@ -83,6 +83,6 @@ default rules file
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/plumb .B \*9/src/cmd/plumb
.SH "SEE ALSO" .SH "SEE ALSO"
.IR plumb (3), .IM plumb (3) ,
.IR plumber (4), .IM plumber (4) ,
.IR plumb (7) .IM plumb (7)

4
man/man1/pr.1
View file

@ -106,5 +106,5 @@ characters instead of the default 72.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/pr.c .B \*9/src/cmd/pr.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR cat (1), .IM cat (1) ,
.IR lp (1) .IM lp (1)

6
man/man1/proof.1
View file

@ -22,7 +22,7 @@ proof \- troff output interpreter
.SH DESCRIPTION .SH DESCRIPTION
.I Proof .I Proof
reads reads
.IR troff (1) .IM troff (1)
intermediate language from intermediate language from
.I file .I file
or standard input or standard input
@ -126,8 +126,8 @@ into screen fonts and character numbers
.B \*9/src/cmd/proof .B \*9/src/cmd/proof
.SH SEE ALSO .SH SEE ALSO
.IR lp (1), .IR lp (1),
.IR gs (1), .IM gs (1) ,
.IR page (1) .IM page (1)
.br .br
J. F. Ossanna and B. W. Kernighan, J. F. Ossanna and B. W. Kernighan,
``Troff User's Manual'' ``Troff User's Manual''

6
man/man1/ps.1
View file

@ -102,6 +102,6 @@ to print the arguments for the process. Newlines in arguments will be translate
.br .br
.B \*9/bin/psu .B \*9/bin/psu
.SH "SEE ALSO" .SH "SEE ALSO"
.IR acid (1), .IM acid (1) ,
.IR db (1), .IM db (1) ,
.IR kill (1) .IM kill (1)

10
man/man1/psfonts.1
View file

@ -16,9 +16,9 @@ psfonts, psdownload \- add necessary fonts to PostScript document for printing
] ]
.SH DESCRIPTION .SH DESCRIPTION
Plan 9's Plan 9's
.IR troff (1) .IM troff (1)
and and
.IR tr2post (1) .IM tr2post (1)
use non-standard PostScript fonts use non-standard PostScript fonts
(found in (found in
.BR \*9/postscript/font ). .BR \*9/postscript/font ).
@ -114,12 +114,12 @@ Continue running even after fatal errors occur.
.PD .PD
.SH EXAMPLE .SH EXAMPLE
See See
.IR tr2post (1) .IM tr2post (1)
for an example. for an example.
.SH SOURCE .SH SOURCE
.B \*9/bin/psfonts .B \*9/bin/psfonts
.br .br
.B \*9/src/cmd/postscript/download .B \*9/src/cmd/postscript/download
.SH SEE ALSO .SH SEE ALSO
.IR troff (1), .IM troff (1) ,
.IR tr2post (1) .IM tr2post (1)

4
man/man1/pwd.1
View file

@ -18,8 +18,8 @@ such as constructing shell prompts.
.SH SEE ALSO .SH SEE ALSO
.I cd .I cd
in in
.IR rc (1), .IM rc (1) ,
.IR getwd (3) .IM getwd (3)
.SH BUGS .SH BUGS
.I Pwd .I Pwd
is not provided. is not provided.

12
man/man1/rc.1
View file

@ -50,7 +50,7 @@ exits or is terminated, the
variable variable
.B $status .B $status
gets the process's wait message (see gets the process's wait message (see
.IR wait (3)); .IM wait (3) );
it will be the null string if the command was successful. it will be the null string if the command was successful.
.PP .PP
A long command line may be continued on subsequent lines by typing A long command line may be continued on subsequent lines by typing
@ -83,7 +83,7 @@ in a directory in
.B $path .B $path
is the program to be executed. is the program to be executed.
To be executable, the user must have execute permission (see To be executable, the user must have execute permission (see
.IR stat (3)) .IM stat (3) )
and the file must be either an executable binary and the file must be either an executable binary
for the current machine's CPU type, or a shell script. 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 Shell scripts begin with a line containing the full path name of a shell
@ -350,7 +350,7 @@ or
is a previously opened file descriptor and is a previously opened file descriptor and
.I fd0 .I fd0
becomes a new copy (in the sense of becomes a new copy (in the sense of
.IR dup (3)) .IM dup (3) )
of it. of it.
A file descriptor may be closed by writing A file descriptor may be closed by writing
.BI >[ fd0 =] .BI >[ fd0 =]
@ -543,7 +543,7 @@ function definition.
A function with a special name will be called when A function with a special name will be called when
.I rc .I rc
receives a corresponding note; see receives a corresponding note; see
.IR notify (3). .IM notify (3) .
The valid note names (and corresponding notes) are The valid note names (and corresponding notes) are
.B sighup .B sighup
.RB ( hangup ), .RB ( hangup ),
@ -662,7 +662,7 @@ is composed of the bitwise OR of the
.B rfork .B rfork
flags specified by the option letters flags specified by the option letters
(see (see
.IR fork (2)). .IM fork (2) ).
If no If no
.I flags .I flags
are given, they default to are given, they default to
@ -829,7 +829,7 @@ parsing the
.B $PATH .B $PATH
variable variable
(as in (as in
.IR sh (1)) .IM sh (1) )
or by or by
.BR "path=(.\ /bin)" . .BR "path=(.\ /bin)" .
The variables The variables

2
man/man1/readcons.1
View file

@ -27,4 +27,4 @@ is printed instead of an empty string.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/readcons.c .B \*9/src/cmd/readcons.c
.SH SEE ALSO .SH SEE ALSO
.IR readcons (3) .IM readcons (3)

8
man/man1/resample.1
View file

@ -40,19 +40,19 @@ and
.PP .PP
The input should be a Plan 9 image The input should be a Plan 9 image
as described in as described in
.IR image (7), .IM image (7) ,
and the output will be a compressed 24-bit and the output will be a compressed 24-bit
.B r8g8b8 .B r8g8b8
image. image.
To uncompress the image or change the pixel format, use To uncompress the image or change the pixel format, use
.I iconv .I iconv
(see (see
.IR crop (1)). .IM crop (1) ).
.PP .PP
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/resample.c .B \*9/src/cmd/resample.c
.SH "SEE ALSO .SH "SEE ALSO
.IR crop (1), .IM crop (1) ,
.IR image (7) .IM image (7)
.SH BUGS .SH BUGS
Faster algorithms exist, but this implementation produces correct pictures. Faster algorithms exist, but this implementation produces correct pictures.

16
man/man1/rio.1
View file

@ -68,15 +68,15 @@ specifies an alternative program to run when the
.I New .I New
menu item is selected. menu item is selected.
The default is to try The default is to try
.IR 9term (1) .IM 9term (1)
and then to fall back to and then to fall back to
.IR xterm (1). .IM xterm (1) .
The The
.B \-s .B \-s
option has no effect. It formerly set the scrolling mode for option has no effect. It formerly set the scrolling mode for
new windows and is recognized to avoid breaking scripts. new windows and is recognized to avoid breaking scripts.
See See
.IR 9term (1) .IM 9term (1)
for a description of scrolling behavior. for a description of scrolling behavior.
.PP .PP
The The
@ -137,11 +137,11 @@ Very small windows may not be created.
The new window is created running The new window is created running
.IR termprog , .IR termprog ,
by default by default
.IR 9term (1) .IM 9term (1)
or, if or, if
.I 9term .I 9term
is not available, is not available,
.IR xterm (1). .IM xterm (1) .
.TP .TP
.B Resize .B Resize
Change the size and location of a window. Change the size and location of a window.
@ -165,7 +165,7 @@ Deleting a window causes a
.L hangup .L hangup
note to be sent to all processes in the window's process group note to be sent to all processes in the window's process group
(see (see
.IR notify (3)). .IM notify (3) ).
.TP .TP
.B Hide .B Hide
Hide a window. Click in the window to be hidden (gunsight cursor); Hide a window. Click in the window to be hidden (gunsight cursor);
@ -241,8 +241,8 @@ starts a particular program.)
.PP .PP
There is a currently a compiled-in limit of 128 hidden windows. There is a currently a compiled-in limit of 128 hidden windows.
.SH "SEE ALSO" .SH "SEE ALSO"
.IR 9term (1), .IM 9term (1) ,
.IR xterm (1) .IM xterm (1)
.PP .PP
As mentioned above, As mentioned above,
.I rio .I rio

2
man/man1/rm.1
View file

@ -25,4 +25,4 @@ and the directory itself.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/rm.c .B \*9/src/cmd/rm.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR remove (3) .IM remove (3)

8
man/man1/rsa.1
View file

@ -85,7 +85,7 @@ Plan 9 represents DSA and RSA keys as attribute-value pair lists
prefixed with the string prefixed with the string
.BR key ; .BR key ;
this is the generic key format used by this is the generic key format used by
.IR factotum (4). .IM factotum (4) .
A full DSA private key has the following attributes: A full DSA private key has the following attributes:
.TP .TP
.B proto .B proto
@ -334,9 +334,9 @@ scp auth.keys unix:.ssh/authorized_keys
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/auth .B \*9/src/cmd/auth
.SH "SEE ALSO .SH "SEE ALSO
.IR factotum (4), .IM factotum (4) ,
.IR pem (1), .IM pem (1) ,
.IR ssh (1) .IM ssh (1)
.SH BUGS .SH BUGS
There are too many key formats. There are too many key formats.
.PP .PP

18
man/man1/sam.1
View file

@ -51,7 +51,7 @@ copies leading white space on the current line to the new line.
Do not `download' the terminal part of Do not `download' the terminal part of
.IR sam . .IR sam .
Editing will be done with the command language only, as in Editing will be done with the command language only, as in
.IR ed (1). .IM ed (1) .
.TP .TP
.BI -r " machine .BI -r " machine
Run the host part remotely Run the host part remotely
@ -69,7 +69,7 @@ for debugging.
.PD .PD
.SS Regular expressions .SS Regular expressions
Regular expressions are as in Regular expressions are as in
.IR regexp (7) .IM regexp (7)
with the addition of with the addition of
.BR \en .BR \en
to represent newlines. to represent newlines.
@ -698,7 +698,7 @@ There is usually a `current window',
marked with a dark border, to which typed text and editing marked with a dark border, to which typed text and editing
commands apply. commands apply.
Text may be typed and edited as in Text may be typed and edited as in
.IR rio (1); .IM rio (1) ;
also the escape key (ESC) selects (sets dot to) text typed also the escape key (ESC) selects (sets dot to) text typed
since the last mouse button hit. since the last mouse button hit.
.PP .PP
@ -798,7 +798,7 @@ the white-space-delimited block of text is sent as a plumb message
with a with a
.B click .B click
attribute defining where the selection lies (see attribute defining where the selection lies (see
.IR plumb (7)). .IM plumb (7) ).
.TP .TP
.B look .B look
Search forward for the next occurrence of the literal text in dot. Search forward for the next occurrence of the literal text in dot.
@ -909,11 +909,11 @@ source for the separate terminal part
.TP .TP
.B \*9/bin/E .B \*9/bin/E
.SH SEE ALSO .SH SEE ALSO
.IR ed (1), .IM ed (1) ,
.IR sed (1), .IM sed (1) ,
.IR grep (1), .IM grep (1) ,
.IR rio (1), .IM rio (1) ,
.IR regexp (7). .IM regexp (7) .
.PP .PP
Rob Pike, Rob Pike,
``The text editor sam''. ``The text editor sam''.

8
man/man1/scat.1
View file

@ -10,7 +10,7 @@ outside the solar system
and implements database-like manipulations and implements database-like manipulations
on sets of such objects. on sets of such objects.
It also provides an interface to It also provides an interface to
.IR astro (1) .IM astro (1)
to plot the locations of solar system objects. to plot the locations of solar system objects.
Finally, it displays images from the Finally, it displays images from the
Space Telescope Science Institute's Space Telescope Science Institute's
@ -119,7 +119,7 @@ The names
and and
.B comet .B comet
refer to the earth's penumbra at lunar distance and the comet installed in the current refer to the earth's penumbra at lunar distance and the comet installed in the current
.IR astro (1). .IM astro (1) .
The output is the planet's name, right ascension and declination, azimuth and altitude, and phase The output is the planet's name, right ascension and declination, azimuth and altitude, and phase
for the moon and sun, as shown by for the moon and sun, as shown by
.BR astro . .BR astro .
@ -182,7 +182,7 @@ collects all objects in the patches that cover the current set.
.TP .TP
.BI astro " option" .BI astro " option"
Run Run
.IR astro (1) .IM astro (1)
with the specified with the specified
.I options .I options
(to which will be appended (to which will be appended
@ -324,7 +324,7 @@ Draw a map of the Pleiades.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/scat .B \*9/src/cmd/scat
.SH SEE ALSO .SH SEE ALSO
.IR astro (1) .IM astro (1)
.br .br
.B \*9/sky/constelnames\ \ .B \*9/sky/constelnames\ \
the three-letter abbreviations of the constellation names. the three-letter abbreviations of the constellation names.

8
man/man1/secstore.1
View file

@ -97,7 +97,7 @@ Option
.B -n .B -n
says that the password should be read from NVRAM says that the password should be read from NVRAM
(see (see
.IR authsrv (3)) .IM authsrv (3) )
instead of from instead of from
.BR /dev/tty . .BR /dev/tty .
.PP .PP
@ -107,7 +107,7 @@ or the server specified by option
.BR -s . .BR -s .
.PP .PP
For example, to add a secret to the file read by For example, to add a secret to the file read by
.IR factotum (4), .IM factotum (4) ,
run run
.sp .sp
.EX .EX
@ -192,8 +192,8 @@ block chaining (CBC) mode.
.br .br
.B \*9/src/cmd/auth/secstore .B \*9/src/cmd/auth/secstore
.SH SEE ALSO .SH SEE ALSO
.IR factotum (4), .IM factotum (4) ,
.IR secstored (1) .IM secstored (1)
.SH BUGS .SH BUGS
There is deliberately no backup of files on the secstore, so There is deliberately no backup of files on the secstore, so
.B -r .B -r

4
man/man1/secstored.1
View file

@ -18,7 +18,7 @@ username
.PP .PP
.I Secstored .I Secstored
serves requests from serves requests from
.IR secstore (1). .IM secstore (1) .
The The
.B -R .B -R
option supplements the password check with a option supplements the password check with a
@ -61,4 +61,4 @@ for mapping local userid to RADIUS userid
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/auth/secstore .B \*9/src/cmd/auth/secstore
.SH SEE ALSO .SH SEE ALSO
.IR secstore (1) .IM secstore (1)

8
man/man1/sed.1
View file

@ -78,7 +78,7 @@ that
addresses the last line of input, or a context address, addresses the last line of input, or a context address,
.BI / regular-expression / \f1, .BI / regular-expression / \f1,
in the style of in the style of
.IR regexp (7), .IM regexp (7) ,
with the added convention that with the added convention that
.L \en .L \en
matches a matches a
@ -235,7 +235,7 @@ in the pattern space.
Any character may be used instead of Any character may be used instead of
.LR / . .LR / .
For a fuller description see For a fuller description see
.IR regexp (7). .IM regexp (7) .
.I Flags .I Flags
is zero or more of is zero or more of
.RS .RS
@ -374,8 +374,8 @@ formatted manuscript.
.IR grep (1), .IR grep (1),
.IR awk (1), .IR awk (1),
.IR lex (1), .IR lex (1),
.IR sam (1), .IM sam (1) ,
.IR regexp (7) .IM regexp (7)
.br .br
L. E. McMahon, L. E. McMahon,
`SED \(em A Non-interactive Text Editor', `SED \(em A Non-interactive Text Editor',

2
man/man1/seq.1
View file

@ -38,7 +38,7 @@ The options are
.TP "\w'\fL-f \fIformat\fLXX'u" .TP "\w'\fL-f \fIformat\fLXX'u"
.BI -f format .BI -f format
Use the Use the
.IR print (3)-style .IM print (3) -style
.I format .I format
.IR print .IR print
for printing each (floating point) number. for printing each (floating point) number.

12
man/man1/sftpcache.1
View file

@ -7,7 +7,7 @@ sftpcache \- cache sftp connections
.SH DESCRIPTION .SH DESCRIPTION
.I Sftpcache .I Sftpcache
multiplexes clients onto persistent multiplexes clients onto persistent
.IR sftp (1) .IM sftp (1)
connections. connections.
It runs It runs
.I sftp .I sftp
@ -16,7 +16,7 @@ and posts a socket named
.IB system .sftp .IB system .sftp
in the name space directory in the name space directory
(see (see
.IR intro (4)). .IM intro (4) ).
Clients can connect to the socket, one at a time, Clients can connect to the socket, one at a time,
to interact with the to interact with the
.I sftp .I sftp
@ -24,13 +24,13 @@ session.
.PP .PP
.I Sftpcache .I Sftpcache
is used by is used by
.IR netfiles (1). .IM netfiles (1) .
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/sftpcache.c .B \*9/src/cmd/sftpcache.c
.SH SEE ALSO .SH SEE ALSO
.IR ssh (1), .IM ssh (1) ,
.IR sftp (1), .IM sftp (1) ,
.IR netfiles (1) .IM netfiles (1)
.SH BUGS .SH BUGS
.I Sftpcache .I Sftpcache
only works with OpenSSH versions 4.3 and earlier; only works with OpenSSH versions 4.3 and earlier;

2
man/man1/sleep.1
View file

@ -28,4 +28,4 @@ while (){
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/sleep.c .B \*9/src/cmd/sleep.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR sleep (3) .IM sleep (3)

7
man/man1/snarfer.1
View file

@ -30,13 +30,14 @@ running
keeps the X11 snarf buffer in sync with the Carbon snarf buffer, keeps the X11 snarf buffer in sync with the Carbon snarf buffer,
working around a bug in the OS X X11 server. working around a bug in the OS X X11 server.
See See
.IR getsnarf (3) .IM getsnarf (3)
for more details. for more details.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/snarfer .B \*9/src/cmd/snarfer
.SH SEE ALSO .SH SEE ALSO
Unix's \fIxclipboard\fR(1), Unix's
.IR getsnarf (3) .IR xclipboard (1),
.IM getsnarf (3)
.SH BUGS .SH BUGS
Both Both
.I xclipboard .I xclipboard

8
man/man1/soelim.1
View file

@ -11,19 +11,19 @@ soelim \- preprocess so inclusion commands in troff input
.I Soelim .I Soelim
reads the specified files or the standard input and performs reads the specified files or the standard input and performs
the textual inclusion implied by the textual inclusion implied by
.IR troff (1) .IM troff (1)
directives of the form directives of the form
.TP .TP
.B "\&.so some_file .B "\&.so some_file
.PP .PP
when they appear at the beginning of input lines. This is useful when when they appear at the beginning of input lines. This is useful when
using programs such as using programs such as
.IR tbl (1) .IM tbl (1)
that do not normally do this, allowing that do not normally do this, allowing
placement of individual tables or other text objects in separate files placement of individual tables or other text objects in separate files
to be run as a part of a large document. to be run as a part of a large document.
.SH SOURCE .SH SOURCE
.B \*9/bin/soelim .B \*9/bin/soelim
.SH "SEE ALSO" .SH "SEE ALSO"
.IR deroff (1), .IM deroff (1) ,
.IR troff (1) .IM troff (1)

4
man/man1/sort.1
View file

@ -242,8 +242,8 @@ come out in their original order.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/sort.c .B \*9/src/cmd/sort.c
.SH SEE ALSO .SH SEE ALSO
.IR uniq (1), .IM uniq (1) ,
.IR look (1) .IM look (1)
.SH DIAGNOSTICS .SH DIAGNOSTICS
.I Sort .I Sort
comments and exits with non-null status for various trouble comments and exits with non-null status for various trouble

6
man/man1/spell.1
View file

@ -31,7 +31,7 @@ not sanctioned there\(emon the standard output.
.PP .PP
.I Spell .I Spell
ignores constructs of ignores constructs of
.IR troff (1) .IM troff (1)
and its standard preprocessors. and its standard preprocessors.
It understands these options: It understands these options:
.TP .TP
@ -82,10 +82,10 @@ the script
source for source for
.I sprog .I sprog
.SH SEE ALSO .SH SEE ALSO
.IR deroff (1) .IM deroff (1)
.SH BUGS .SH BUGS
The heuristics of The heuristics of
.IR deroff (1) .IM deroff (1)
used to excise formatting information are imperfect. used to excise formatting information are imperfect.
.PP .PP
The spelling list's coverage is uneven; The spelling list's coverage is uneven;

8
man/man1/split.1
View file

@ -41,7 +41,7 @@ File divisions occur at each line
that matches a regular that matches a regular
.IR expression ; .IR expression ;
see see
.IR regexp (7). .IM regexp (7) .
Multiple Multiple
.B -e .B -e
options may appear. options may appear.
@ -77,6 +77,6 @@ to lower case.
.B \*9/src/cmd/split.c .B \*9/src/cmd/split.c
.SH SEE ALSO .SH SEE ALSO
.IR sed (1), .IR sed (1),
.IR awk (1), .IM awk (1) ,
.IR grep (1), .IM grep (1) ,
.IR regexp (7) .IM regexp (7)

12
man/man1/src.1
View file

@ -19,11 +19,11 @@ examines the named
to find the corresponding source code, which is then sent to the editor using to find the corresponding source code, which is then sent to the editor using
.B B .B B
(see (see
.IR sam (1)). .IM sam (1) ).
If If
.I file .I file
is an is an
.IR rc (1) .IM rc (1)
script, the source is the file itself. script, the source is the file itself.
If If
.I file .I file
@ -35,7 +35,7 @@ and
will point the editor at the line that begins the definition. will point the editor at the line that begins the definition.
.I Src .I Src
uses uses
.IR db (1) .IM db (1)
to extract the symbol table information that identifies the source. to extract the symbol table information that identifies the source.
.PP .PP
.I Src .I Src
@ -78,6 +78,6 @@ src -s strcmp rc
.SH SOURCE .SH SOURCE
.B \*9/bin/src .B \*9/bin/src
.SH "SEE ALSO" .SH "SEE ALSO"
.IR db (1), .IM db (1) ,
.IR plumb (1), .IM plumb (1) ,
.IR sam (1). .IM sam (1) .

4
man/man1/ssam.1
View file

@ -63,8 +63,8 @@ Count frequency of words read from standard input.
.B \*9/bin/ssam .B \*9/bin/ssam
.SH SEE ALSO .SH SEE ALSO
.IR sed (1), .IR sed (1),
.IR sam (1), .IM sam (1) ,
.IR regexp (7) .IM regexp (7)
.PP .PP
Rob Pike, Rob Pike,
``The text editor sam''. ``The text editor sam''.

20
man/man1/ssh-agent.1
View file

@ -10,9 +10,9 @@ ssh-agent \- SSH authentication agent
.SH DESCRIPTION .SH DESCRIPTION
.I Ssh-agent .I Ssh-agent
presents presents
.IR factotum (4) .IM factotum (4)
using the interface that using the interface that
.IR ssh (1) .IM ssh (1)
requires. requires.
.PP .PP
Once Once
@ -33,7 +33,7 @@ via a Unix socket named
.B ssh-agent.socket .B ssh-agent.socket
in the name space directory in the name space directory
(see (see
.IR intro (4)). .IM intro (4) ).
Note that although the socket is posted in the name space Note that although the socket is posted in the name space
directory, it is not for 9P conversations. directory, it is not for 9P conversations.
.I Ssh .I Ssh
@ -81,10 +81,10 @@ Invoke this one with
.B 9 .B 9
.BR ssh-agent ; .BR ssh-agent ;
see see
.IR 9 (1). .IM 9 (1) .
.SH EXAMPLES .SH EXAMPLES
Assume Assume
.IR factotum (4) .IM factotum (4)
is already running and initialized with keys. is already running and initialized with keys.
.PP .PP
Start a new agent, copying the commands by hand: Start a new agent, copying the commands by hand:
@ -103,7 +103,7 @@ $
.EE .EE
.PP .PP
Start the agent from Start the agent from
.IR sh (1): .IM sh (1) :
.IP .IP
.EX .EX
$ eval `9 ssh-agent -e` $ eval `9 ssh-agent -e`
@ -111,7 +111,7 @@ $
.EE .EE
.PP .PP
Start the agent from Start the agent from
.IR rc (1): .IM rc (1) :
.IP .IP
.EX .EX
% eval `{9 ssh-agent} % eval `{9 ssh-agent}
@ -128,9 +128,9 @@ tux% ^D
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/auth/ssh-agent.c .B \*9/src/cmd/auth/ssh-agent.c
.SH SEE ALSO .SH SEE ALSO
.IR ssh (1), .IM ssh (1) ,
.IR rsa (1), .IM rsa (1) ,
.IR factotum (4) .IM factotum (4)
.SH BUGS .SH BUGS
A surprise rather than a bug: A surprise rather than a bug:
.I ssh-agent .I ssh-agent

2
man/man1/strings.1
View file

@ -25,4 +25,4 @@ line with the offset of the continuation line.
.SH SOURCE .SH SOURCE
.B \*9/src/cmd/strings.c .B \*9/src/cmd/strings.c
.SH SEE ALSO .SH SEE ALSO
.IR nm (1) .IM nm (1)

4
man/man1/sum.1
View file

@ -73,5 +73,5 @@ summed.
.br .br
.B \*9/src/cmd/sha1sum.c .B \*9/src/cmd/sha1sum.c
.SH "SEE ALSO" .SH "SEE ALSO"
.IR cmp (1), .IM cmp (1) ,
.IR wc (1) .IM wc (1)

8
man/man1/tar.1
View file

@ -112,14 +112,14 @@ archive entries.
.B z .B z
Operate on compressed tar archives. Operate on compressed tar archives.
The type of compression is inferred from the file name extension: The type of compression is inferred from the file name extension:
.IR gzip (1) .IM gzip (1)
for for
.B .tar.gz .B .tar.gz
and and
.BR .tgz ; .BR .tgz ;
.I bzip2 .I bzip2
(see (see
.IR gzip (1)) .IM gzip (1) )
for for
.BR .tar.bz , .BR .tar.bz ,
.BR .tbz , .BR .tbz ,
@ -153,8 +153,8 @@ can be used to copy hierarchies thus:
.SH SEE ALSO .SH SEE ALSO
.I 9ar .I 9ar
in in
.IR 9c (1), .IM 9c (1) ,
.IR bundle (1) .IM bundle (1)
.SH BUGS .SH BUGS
There is no way to ask for any but the last There is no way to ask for any but the last
occurrence of a file. occurrence of a file.

8
man/man1/tbl.1
View file

@ -11,7 +11,7 @@ tbl \- format tables for nroff or troff
is a preprocessor for formatting tables for is a preprocessor for formatting tables for
.I nroff .I nroff
or or
.IR troff (1). .IM troff (1) .
The input The input
.I files .I files
are copied to the standard output, are copied to the standard output,
@ -74,7 +74,7 @@ recognize
and and
.I y .I y
as as
.IR eqn (1) .IM eqn (1)
delimiters delimiters
.PD .PD
.RE .RE
@ -275,8 +275,8 @@ Bernardsville 2018 3.30
.B \*9/src/cmd/tbl .B \*9/src/cmd/tbl
.SH SEE ALSO .SH SEE ALSO
.IR troff (1), .IR troff (1),
.IR eqn (1), .IM eqn (1) ,
.IR doctype (1) .IM doctype (1)
.br .br
M. E. Lesk and L. L. Cherry, M. E. Lesk and L. L. Cherry,
``TBL\(ema Program to Format Tables'', ``TBL\(ema Program to Format Tables'',

Some files were not shown because too many files have changed in this diff Show more