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