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

14
man/man1/9.1
View file

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

2
man/man1/9c.1
View file

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

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

18
man/man1/9term.1
View file

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

14
man/man1/acid.1
View file

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

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

22
man/man1/acmeevent.1
View file

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

12
man/man1/ascii.1
View file

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

2
man/man1/astro.1
View file

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

6
man/man1/awk.1
View file

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

6
man/man1/bc.1
View file

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

10
man/man1/bundle.1
View file

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

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.
.PP
To have your calendar mailed to you every day, use
.IR cron (8).
.IM cron (8) .
.SH FILES
.TF $HOME/lib/calendar
.TP

8
man/man1/cat.1
View file

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

2
man/man1/cleanname.1
View file

@ -29,4 +29,4 @@ before processing.
.SH SOURCE
.B \*9/src/cmd/cleanname.c
.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
.I nroff
for .2C in
.IR ms (7)
.IM ms (7)
or
.IR man (7)
.IM man (7)
and for
.IR tbl (1).
.IM tbl (1) .
.I Col
is a pure filter.
It normally emits only full line feeds;
@ -47,7 +47,7 @@ paginate the output.
.SH SOURCE
.B \*9/src/cmd/col.c
.SH SEE ALSO
.IR pr (1)
.IM pr (1)
.SH BUGS
.I Col
can't back up more than 128 lines or

6
man/man1/colors.1
View file

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

4
man/man1/comm.1
View file

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

8
man/man1/core.1
View file

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

12
man/man1/crop.1
View file

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

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
.B $timezone
environment variable; see
.IR ctime (3).
.IM ctime (3) .
.PP
If the optional argument
.I seconds

10
man/man1/db.1
View file

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

4
man/man1/dc.1
View file

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

2
man/man1/dd.1
View file

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

16
man/man1/deroff.1
View file

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

8
man/man1/devdraw.1
View file

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

4
man/man1/dial.1
View file

@ -12,7 +12,7 @@ dial \- connect to a remote service
connects to the network address
.I addr
(see
.IR dial (3))
.IM dial (3) )
and then copies data from the connection to standard output,
and from standard input to the connection.
.PP
@ -27,4 +27,4 @@ to exit only in response to end of file on the network connection.
.SH SOURCE
.B \*9/src/cmd/dial.c
.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
.PP
Patterns are regular expressions (see
.IR regexp (7)),
.IM regexp (7) ),
with an implicit leading
.L ^
and trailing
@ -154,7 +154,7 @@ searches for dictionaries in the directory named by
.PP
.I Adict
is a dictionary browser for
.IR acme (1).
.IM acme (1) .
When run with no arguments, it creates a new
.I acme
window named
@ -193,7 +193,7 @@ window.
dictionaries
.PD
.SH "SEE ALSO"
.IR regexp (7)
.IM regexp (7)
.SH SOURCE
.B \*9/src/cmd/dict
.br

8
man/man1/diff.1
View file

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

14
man/man1/doctype.1
View file

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

10
man/man1/ed.1
View file

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

8
man/man1/eqn.1
View file

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

4
man/man1/freq.1
View file

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

12
man/man1/git.1
View file

@ -1,5 +1,5 @@
.TH GIT 1
.SH NAME
.SH NAME
git, hg, cvs, codereview \- introduction to using plan9port Git repository
.SH SYNOPSIS
.B git
@ -17,7 +17,7 @@ git, hg, cvs, codereview \- introduction to using plan9port Git repository
.I path ...
]
.PP
.B gitk
.B gitk
.PP
.B web
.B https://9fans.github.io/plan9port
@ -37,13 +37,13 @@ which it will create.
After
.B git
.BR clone ,
the other commands listed
the other commands listed
should be run within the
.B plan9
directory tree.
.PP
Git downloads the entire revision history
of Plan 9 from User Space
of Plan 9 from User Space
in addition to the current tree.
.PP
.I Git
@ -55,7 +55,7 @@ current file tree.
.I Git
.I diff
runs Unix's
.IR diff (1)
.IM diff (1)
to compare the files in the local tree with the corresponding
files in the revision history.
The special revision
@ -76,7 +76,7 @@ directory containing Git local repository
list of files and wildcards to exclude from Git operations
.SH SEE ALSO
Unix's
\fIgit\fR(1),
.IR git (1),
.HR http://git-scm.com/doc
.PP
.HR https://9fans.github.io/plan9port/

4
man/man1/grap.1
View file

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

4
man/man1/graph.1
View file

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

12
man/man1/grep.1
View file

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

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
.B \*9/src/cmd/draw/gview.c
.SH SEE ALSO
.IR awk (1)
.IM awk (1)
.SH BUGS
The user interface for the
.I slant

4
man/man1/gzip.1
View file

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

8
man/man1/hist.1
View file

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

4
man/man1/hoc.1
View file

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

18
man/man1/htmlroff.1
View file

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

4
man/man1/idiff.1
View file

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

14
man/man1/install.1
View file

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

4
man/man1/join.1
View file

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

10
man/man1/jpg.1
View file

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

12
man/man1/kill.1
View file

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

12
man/man1/label.1
View file

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

2
man/man1/lex.1
View file

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

2
man/man1/look.1
View file

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

12
man/man1/ls.1
View file

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

12
man/man1/man.1
View file

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

4
man/man1/map.1
View file

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

18
man/man1/mc.1
View file

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

24
man/man1/mk.1
View file

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

27
man/man1/mk9660.1
View file

@ -71,11 +71,11 @@ the current directory).
The
.I proto
file is formatted as described in
.IR proto (3).
.IM proto (3) .
.PP
The created CD image will be in ISO-9660
format, but by default the file names will
be stored in UTF-8 with no imposed length
be stored in UTF-8 with no imposed length
or character restrictions.
The
.B -c
@ -84,7 +84,7 @@ flag causes
to use only file names in ``8.3'' form
that use digits, letters, and underscore.
File names that do not conform are changed
to
to
.BI D nnnnnn
(for directories)
or
@ -122,7 +122,7 @@ and
.B \e
are allowed in Plan 9 file names but not in Joliet file names;
non-conforming file names are translated
and a
and a
.B _CONFORM.MAP
file written
as in the case of the
@ -133,7 +133,7 @@ If the
.B -r
flag is given, Rock Ridge extensions are written in the
format of the system use sharing protocol;
this format provides Posix-style file metadata and is
this format provides Posix-style file metadata and is
common on Unix platforms.
.PP
The options
@ -155,13 +155,13 @@ if unspecified, the base name of
.I proto
is used.
.PP
The
The
.B -:
flag causes
flag causes
.B mk9660
to replace colons in scanned file names with spaces;
this is the inverse of the map applied by Plan 9's
\fIdossrv\fR(4)
.IR dossrv (4)
and is useful for writing Joliet CDs containing data
from FAT file systems.
.PP
@ -189,10 +189,11 @@ on standard error.
is similar in specification to
.I mk9660
but creates and updates backup CD images in the style of
the
the
.I dump
file system
(see Plan 9's \fIfs\fR(4)).
(see Plan 9's
.IR fs (4)).
The dump is file-based rather than block-based:
if a file's contents have not changed since the last
backup, only its directory entry will be rewritten.
@ -202,7 +203,7 @@ The
option specifies a time (in seconds since January 1, 1970)
to be used for naming the dump directory.
.PP
The
The
.B -m
option specifies a maximum size for the image;
if a backup would cause the image to grow larger than
@ -212,7 +213,7 @@ it will not be written, and
will exit with a non-empty status.
.SH EXAMPLE
.PP
Create an image of the Plan 9 source tree,
Create an image of the Plan 9 source tree,
including a conformant ISO-9660 directory tree,
Plan 9 extensions in the system use fields, and
a Joliet directory tree.
@ -223,7 +224,7 @@ mk9660 -9cj -s /n/bootes -p srcproto cdimage
.SH SOURCE
\*9/src/cmd/9660
.SH "SEE ALSO
.IR proto (3)
.IM proto (3)
.\" .SH "SEE ALSO"
.\" .I 9660srv
.\" (in

4
man/man1/mkdir.1
View file

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

10
man/man1/mount.1
View file

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

6
man/man1/namespace.1
View file

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

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

26
man/man1/netfiles.1
View file

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

97
man/man1/page.1
View file

@ -1,7 +1,7 @@
.TH PAGE 1
.SH NAME
page \- view
FAX,
page \- view
FAX,
image, graphic, PostScript, PDF, and
typesetter output
files
@ -24,23 +24,24 @@ It can be used to display the individual pages
of a
PostScript,
PDF,
or
.IR troff (1)
or
Unix's \fItex\fR(1)
or
.IM troff (1)
or
Unix's
.IR tex (1)
device-independent output
file.
.I Troff
or
or
.I tex
output is simply converted to PostScript in order to be viewed.
It can also be used to view any number of
graphics files
(such as a
(such as a
FAX
page,
page,
a Plan 9
.IR image (7)
.IM image (7)
file, an Inferno bitmap file, or other common format).
.I Page
displays these
@ -53,26 +54,26 @@ By default,
.I page
runs in the window in which it is started
and leaves the window unchanged.
The
The
.B -R
option causes
.I page
option causes
.I page
to grow the window if necessary
to display the page being viewed.
The
.B -w
option causes
.I page
option causes
.I page
to create a new window for itself.
The newly created window will grow as under the
.B -R
option.
If being used to display
If being used to display
multipage documents,
only one file may be specified on the command line.
.PP
The
.B -p
The
.B -p
option sets the resolution for PostScript and PDF
files, in pixels per inch.
The default is 100 ppi.
@ -85,13 +86,13 @@ When viewing a document,
will try to guess the true bounding box, usually rounding up from
the file's bounding box to
8½×11 or A4 size.
The
The
.B -b
option causes it to respect the bounding box given in the file.
As a more general problem,
some PostScript files claim to conform to Adobe's
Document Structuring Conventions but do not.
The
The
.B -P
option enables a slightly slower and slightly more
skeptical version of the PostScript processing code.
@ -101,34 +102,35 @@ that can only be viewed with the
option, and there are PostScript documents that
can only be viewed without it.
.PP
When viewing images with
When viewing images with
.IR page ,
it listens to the
it listens to the
.B image
plumbing channel
(see
.IR plumber (4))
(see
.IM plumber (4) )
for more images to display.
The
The
.B -i
option causes
option causes
.I page
to not load any graphics files nor to read
to not load any graphics files nor to read
from standard input but rather to listen
for ones to load from the plumbing channel.
.PP
The
The
.B -v
option turns on extra debugging output, and
the
.B -V
option turns on even more debugging output.
The
The
.B -a
option causes
option causes
.I page
to call
Unix's \fIabort\fR(3)
Unix's
.IR abort (3)
rather than exit cleanly on errors,
to facilitate debugging.
.PP
@ -145,7 +147,7 @@ The button 2 menu operations are:
Restores the image to the original. All modifications are lost.
.TP
.B Zoom
Prompts the user to sweep a rectangle on the image which is
Prompts the user to sweep a rectangle on the image which is
expanded proportionally to the rectangle.
.TP
.B Fit window
@ -164,7 +166,7 @@ Displays the next page.
Displays the previous page.
.TP
.B Zerox
Displays the current image in a new page window.
Displays the current image in a new page window.
Useful for selecting important pages from large documents.
.TP
.B Reverse
@ -189,14 +191,14 @@ toggles whether images are displayed upside-down.
Typing a
.B r
reverses the order in which pages are displayed.
Typing a
Typing a
.B w
will write the currently viewed page to a new file as a compressed
.IR image (7)
.IM image (7)
file.
When possible, the filename is of the form
.IR basename . pagenum . bit .
Typing a
Typing a
.B d
removes an image from the working set.
.PP
@ -208,13 +210,14 @@ changing pages when panning off the top or bottom of the page.
.PP
.I Page
calls
Unix's \fIgs\fR(1)
Unix's
.IR gs (1)
to draw each page of PostScript
and
PDF
.IR files .
It also calls a variety of conversion programs, such as those described in
.IR jpg (1),
.IM jpg (1) ,
to convert the various raster graphics formats
into Inferno bitmap files.
Pages are converted ``on the fly,'' as needed.
@ -232,11 +235,11 @@ Browse the Inferno bitmap library.
man -t page | page -w
Preview this manual in a new window.
.SH "SEE ALSO
.IR gs (1),
.IR jpg (1),
.IR proof (1),
.IR tex (1),
.IR troff (1)
.IM gs (1) ,
.IM jpg (1) ,
.IM proof (1) ,
.IM tex (1) ,
.IM troff (1)
.SH SOURCE
.B \*9/src/cmd/page
.SH DIAGNOSTICS
@ -254,19 +257,19 @@ When viewing multipage PostScript files that do not contain
.RB `` %%Page ''
comments, the button 3 menu only contains
``this page'' and ``next page'':
correctly determining
correctly determining
page boundaries in Postscript code is not computable
in the general case.
.PP
If
.I page
has trouble viewing a Postscript file,
it might not be exactly conforming: try viewing it with the
it might not be exactly conforming: try viewing it with the
.B -P
option.
.PP
The interface to the plumber is unsatisfactory. In particular,
document references cannot be sent
document references cannot be sent
via plumbing messages.
.PP
There are too many keyboard commands and menu items.
@ -274,7 +277,7 @@ There are too many keyboard commands and menu items.
Displaying a PostScript or PDF file depends both on having
GhostScript
(see
.IR gs (1))
.IM gs (1) )
installed and on the underlying operating system
providing a file descriptor device tree at
.BR /dev/fd .

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.
.I Paint
only recognizes Plan 9 bitmap format (see
.IR image (6)).
.IM image (6) ).
.PP
A number of immediate keyboard commands are recognized:
.TP
@ -74,12 +74,12 @@ Quits the program.
.SH SOURCE
.B /sys/src/cmd/paint.c
.SH "SEE ALSO"
.IR resample (1),
.IR rotate (1),
.IR crop (1),
.IR jpg (1),
.IR page (1),
.IR image (6)
.IM resample (1) ,
.IM rotate (1) ,
.IM crop (1) ,
.IM jpg (1) ,
.IM page (1) ,
.IM image (6)
.SH HISTORY
.I Paint
first appeared in 9front (October, 2011).

2
man/man1/passwd.1
View file

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

6
man/man1/pem.1
View file

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

8
man/man1/pic.1
View file

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

8
man/man1/plot.1
View file

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

6
man/man1/plumb.1
View file

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

4
man/man1/pr.1
View file

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

6
man/man1/proof.1
View file

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

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
.B \*9/bin/psu
.SH "SEE ALSO"
.IR acid (1),
.IR db (1),
.IR kill (1)
.IM acid (1) ,
.IM db (1) ,
.IM kill (1)

10
man/man1/psfonts.1
View file

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

4
man/man1/pwd.1
View file

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

12
man/man1/rc.1
View file

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

2
man/man1/readcons.1
View file

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

8
man/man1/resample.1
View file

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

16
man/man1/rio.1
View file

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

2
man/man1/rm.1
View file

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

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
.BR key ;
this is the generic key format used by
.IR factotum (4).
.IM factotum (4) .
A full DSA private key has the following attributes:
.TP
.B proto
@ -334,9 +334,9 @@ scp auth.keys unix:.ssh/authorized_keys
.SH SOURCE
.B \*9/src/cmd/auth
.SH "SEE ALSO
.IR factotum (4),
.IR pem (1),
.IR ssh (1)
.IM factotum (4) ,
.IM pem (1) ,
.IM ssh (1)
.SH BUGS
There are too many key formats.
.PP

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

8
man/man1/scat.1
View file

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

8
man/man1/secstore.1
View file

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

4
man/man1/secstored.1
View file

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

8
man/man1/sed.1
View file

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

2
man/man1/seq.1
View file

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

12
man/man1/sftpcache.1
View file

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

2
man/man1/sleep.1
View file

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

13
man/man1/snarfer.1
View file

@ -13,30 +13,31 @@ Each time a program changes the snarf buffer contents,
.I snarfer
copies the new contents and then takes over control
of the buffer.
Because the snarf buffer contents are managed by
Because the snarf buffer contents are managed by
.I snarfer
instead of by individual programs, the contents remain
available even after the program that wrote them exits.
.PP
The
The
.B -v
option, intended for debugging, causes
.I snarfer
to print the new snarf buffer contents each time it changes.
.PP
On Mac OS X,
On Mac OS X,
running
.I snarfer
keeps the X11 snarf buffer in sync with the Carbon snarf buffer,
working around a bug in the OS X X11 server.
See
.IR getsnarf (3)
.IM getsnarf (3)
for more details.
.SH SOURCE
.B \*9/src/cmd/snarfer
.SH SEE ALSO
Unix's \fIxclipboard\fR(1),
.IR getsnarf (3)
Unix's
.IR xclipboard (1),
.IM getsnarf (3)
.SH BUGS
Both
.I xclipboard

8
man/man1/soelim.1
View file

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

4
man/man1/sort.1
View file

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

6
man/man1/spell.1
View file

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

8
man/man1/split.1
View file

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

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
.B B
(see
.IR sam (1)).
.IM sam (1) ).
If
.I file
is an
.IR rc (1)
.IM rc (1)
script, the source is the file itself.
If
.I file
@ -35,7 +35,7 @@ and
will point the editor at the line that begins the definition.
.I Src
uses
.IR db (1)
.IM db (1)
to extract the symbol table information that identifies the source.
.PP
.I Src
@ -78,6 +78,6 @@ src -s strcmp rc
.SH SOURCE
.B \*9/bin/src
.SH "SEE ALSO"
.IR db (1),
.IR plumb (1),
.IR sam (1).
.IM db (1) ,
.IM plumb (1) ,
.IM sam (1) .

4
man/man1/ssam.1
View file

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

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

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

2
man/man1/strings.1
View file

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

4
man/man1/sum.1
View file

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

8
man/man1/tar.1
View file

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

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

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