From d32deab17bfffa5bffc5fab3e6577558e40888c5 Mon Sep 17 00:00:00 2001
From: Russ Cox <rsc@swtch.com>
Date: Sat, 15 Aug 2020 20:07:38 -0400
Subject: tmac: rename IM (italic manual) to MR (manual reference)

Suggested by G. Brandon Robinson.
---
 man/man1/0intro.1 | 148 +++++++++++++++++++++++++++---------------------------
 1 file changed, 74 insertions(+), 74 deletions(-)

(limited to 'man/man1/0intro.1')

diff --git a/man/man1/0intro.1 b/man/man1/0intro.1
index 5c45aefe..780be91d 100644
--- a/man/man1/0intro.1
+++ b/man/man1/0intro.1
@@ -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) .
-- 
cgit v1.2.3