aboutsummaryrefslogtreecommitdiff
path: root/man/man7
diff options
context:
space:
mode:
authorRuss Cox <rsc@swtch.com>2020-08-15 20:07:38 -0400
committerRuss Cox <rsc@swtch.com>2020-08-15 20:09:40 -0400
commitd32deab17bfffa5bffc5fab3e6577558e40888c5 (patch)
tree745b19fb64cfbd1fd9d0c6039fe35a1fd85169d3 /man/man7
parent9843fc0d82c68c78059ccb167e8402def5a4ee1f (diff)
downloadplan9port-d32deab17bfffa5bffc5fab3e6577558e40888c5.tar.gz
plan9port-d32deab17bfffa5bffc5fab3e6577558e40888c5.tar.bz2
plan9port-d32deab17bfffa5bffc5fab3e6577558e40888c5.zip
tmac: rename IM (italic manual) to MR (manual reference)
Suggested by G. Brandon Robinson.
Diffstat (limited to 'man/man7')
-rw-r--r--man/man7/color.714
-rw-r--r--man/man7/face.78
-rw-r--r--man/man7/font.722
-rw-r--r--man/man7/htmlroff.76
-rw-r--r--man/man7/image.732
-rw-r--r--man/man7/keyboard.728
-rw-r--r--man/man7/man.76
-rw-r--r--man/man7/map.72
-rw-r--r--man/man7/mhtml.718
-rw-r--r--man/man7/mpictures.74
-rw-r--r--man/man7/ms.720
-rw-r--r--man/man7/ndb.76
-rw-r--r--man/man7/plot.72
-rw-r--r--man/man7/plumb.718
-rw-r--r--man/man7/regexp.76
-rw-r--r--man/man7/thumbprint.74
-rw-r--r--man/man7/utf.78
-rw-r--r--man/man7/venti.728
18 files changed, 116 insertions, 116 deletions
diff --git a/man/man7/color.7 b/man/man7/color.7
index 7e9a39b7..917c2521 100644
--- a/man/man7/color.7
+++ b/man/man7/color.7
@@ -121,11 +121,11 @@ which is scaled so 0 represents fully transparent and 255 represents opaque colo
The alpha is
.I premultiplied
into the other channels, as described in the paper by Porter and Duff cited in
-.IM draw (3) .
+.MR draw (3) .
The function
.B setalpha
(see
-.IM allocimage (3) )
+.MR allocimage (3) )
aids the initialization of color values with non-trivial alpha.
.PP
The packing of pixels into bytes and words is odd.
@@ -138,13 +138,13 @@ the byte ordering is blue, green, red.
.PP
To maintain a constant external representation,
the
-.IM draw (3)
+.MR draw (3)
interface
as well as the
various graphics libraries represent colors
by 32-bit numbers, as described in
-.IM color (3) .
+.MR color (3) .
.SH "SEE ALSO"
-.IM color (3) ,
-.IM graphics (3) ,
-.IM draw (3)
+.MR color (3) ,
+.MR graphics (3) ,
+.MR draw (3)
diff --git a/man/man7/face.7 b/man/man7/face.7
index a69aac98..8cd37825 100644
--- a/man/man7/face.7
+++ b/man/man7/face.7
@@ -25,7 +25,7 @@ per color)).
The large files serve no special purpose; they are stored
as images
(see
-.IM image (7) ).
+.MR image (7) ).
The small files are the `icons' displayed by
.B faces
and
@@ -110,6 +110,6 @@ which then appears as a domain name in the
.B .dict
files.
.SH "SEE ALSO"
-.IM mail (1) ,
-.IM tweak (1) ,
-.IM image (7)
+.MR mail (1) ,
+.MR tweak (1) ,
+.MR image (7)
diff --git a/man/man7/font.7 b/man/man7/font.7
index a11ca53c..c9ebb919 100644
--- a/man/man7/font.7
+++ b/man/man7/font.7
@@ -5,7 +5,7 @@ font, subfont \- external format for fonts and subfonts
.B #include <draw.h>
.SH DESCRIPTION
Fonts and subfonts are described in
-.IM cachechars (3) .
+.MR cachechars (3) .
.PP
External bitmap fonts are described by a plain text file that can be read using
.IR openfont .
@@ -21,7 +21,7 @@ with an optional starting position within the subfont,
and the file name names an external file suitable for
.I readsubfont
(see
-.IM graphics (3) ).
+.MR graphics (3) ).
The minimum number of a covered range is mapped to the specified starting position
(default zero) of the
corresponding subfont.
@@ -36,11 +36,11 @@ that can be read and written using
and
.I writesubfont
(see
-.IM subfont (3) ).
+.MR subfont (3) ).
The format for subfont files is: an image containing character glyphs,
followed by a subfont header, followed by character information.
The image has the format for external image files described in
-.IM image (7) .
+.MR image (7) .
The subfont header has 3
decimal strings:
.BR n ,
@@ -72,7 +72,7 @@ are irrelevant.
.PP
Note that the convention of using the character with value zero (NUL) to represent
characters of zero width (see
-.IM draw (3) )
+.MR draw (3) )
means that fonts should have, as their zeroth character,
one with non-zero width.
.SS "Font Names
@@ -121,7 +121,7 @@ The command
.B .
lists the available fonts.
See
-.IM fontsrv (4)
+.MR fontsrv (4)
for more.
.PP
If the font name has the form
@@ -136,7 +136,7 @@ The Plan 9 bitmap fonts were designed for screens with pixel density around 100
When used on screens with pixel density above 200 DPI,
the bitmap fonts are automatically pixel doubled.
Similarly, fonts loaded from
-.IM fontsrv (4)
+.MR fontsrv (4)
are automatically doubled in size by varying the effective
.I size
path element.
@@ -184,7 +184,7 @@ a system-installed vector font on high-density displays:
.B \*9/font/*
font directories
.SH "SEE ALSO"
-.IM graphics (3) ,
-.IM draw (3) ,
-.IM cachechars (3) ,
-.IM subfont (3)
+.MR graphics (3) ,
+.MR draw (3) ,
+.MR cachechars (3) ,
+.MR subfont (3)
diff --git a/man/man7/htmlroff.7 b/man/man7/htmlroff.7
index 56874b1b..34f2cc5b 100644
--- a/man/man7/htmlroff.7
+++ b/man/man7/htmlroff.7
@@ -2,7 +2,7 @@
.SH NAME
htmlroff \- HTML formatting and typesetting
.SH DESCRIPTION
-.IM Htmlroff (1)
+.MR Htmlroff (1)
accepts
.I troff
input with a few extensions and changes.
@@ -200,7 +200,7 @@ inside
.B <sub>
tags.
This heuristic handles simple equations formatted by
-.IM eqn (1) .
+.MR eqn (1) .
.SS Conditional input
.PP
To make it easier to write input files that can be formatted by both
@@ -315,7 +315,7 @@ For example,
redefines the
.B PS
macro that marks the beginning of a
-.IM pic (1)
+.MR pic (1)
picture:
.IP
.EX
diff --git a/man/man7/image.7 b/man/man7/image.7
index b412742f..bfb299bd 100644
--- a/man/man7/image.7
+++ b/man/man7/image.7
@@ -5,9 +5,9 @@ image \- external format for images
.B #include <draw.h>
.SH DESCRIPTION
Images are described in
-.IM graphics (3) ,
+.MR graphics (3) ,
and the definition of pixel values is in
-.IM color (7) .
+.MR color (7) .
Fonts and images are stored in external files
in machine-independent formats.
.PP
@@ -21,7 +21,7 @@ and
and
.B writememimage
(see
-.IM memdraw (3) ).
+.MR memdraw (3) ).
An uncompressed image file starts with 5
strings:
.BR chan ,
@@ -37,7 +37,7 @@ value is a textual string describing the pixel format
(see
.B strtochan
in
-.IM graphics (3)
+.MR graphics (3)
and the discussion of channel descriptors below),
and the rectangle coordinates are decimal strings.
The rest of the file contains the
@@ -73,7 +73,7 @@ The
and
.B unloadimage
functions described in
-.IM allocimage (3)
+.MR allocimage (3)
also deal with rows in this format, stored in user memory.
.PP
The channel format string is a sequence of two-character channel descriptions,
@@ -110,7 +110,7 @@ In particular
.B 'r8g8b8'
pixels have byte ordering blue, green, and red within the file.
See
-.IM color (7)
+.MR color (7)
for more details of the pixel format.
.PP
A venerable yet deprecated format replaces the channel string
@@ -179,7 +179,7 @@ as used by
(see Plan 9's
.IR faces (1)
and
-.IM face (7) )
+.MR face (7) )
and 16\(mu16
cursors, can be stored textually, suitable for inclusion in C source.
Each line of text represents one scan line as a
@@ -188,18 +188,18 @@ bytes, shorts, or words in C format.
For cursors, each line defines a pair of bytes.
(It takes two images to define a cursor; each must be stored separately
to be processed by programs such as
-.IM tweak (1) .)
+.MR tweak (1) .)
Face files of one bit per pixel are stored as a sequence of shorts,
those of larger pixel sizes as a sequence of longs.
Software that reads these files must deduce the image size from
the input; there is no header.
These formats reflect history rather than design.
.SH "SEE ALSO"
-.IM jpg (1) ,
-.IM tweak (1) ,
-.IM graphics (3) ,
-.IM draw (3) ,
-.IM allocimage (3) ,
-.IM color (7) ,
-.IM face (7) ,
-.IM font (7)
+.MR jpg (1) ,
+.MR tweak (1) ,
+.MR graphics (3) ,
+.MR draw (3) ,
+.MR allocimage (3) ,
+.MR color (7) ,
+.MR face (7) ,
+.MR font (7)
diff --git a/man/man7/keyboard.7 b/man/man7/keyboard.7
index 56c0d3ae..69094a22 100644
--- a/man/man7/keyboard.7
+++ b/man/man7/keyboard.7
@@ -49,15 +49,15 @@ in particular, control-J is a line feed and control-M a carriage return.
.PP
The down arrow,
used by
-.IM 9term (1) ,
-.IM acme (1) ,
+.MR 9term (1) ,
+.MR acme (1) ,
and
-.IM sam (1) ,
+.MR sam (1) ,
causes windows to scroll forward.
The up arrow scrolls backward.
.PP
Characters in Plan 9 are runes (see
-.IM utf (7) ).
+.MR utf (7) ).
Any rune can be typed using a compose key followed by several
other keys.
The compose key is also generally near the lower right of the main key area:
@@ -92,11 +92,11 @@ the compose key followed by a two- or three-character sequence.
The full list is too long to repeat here, but is contained in the file
.L \*9/lib/keyboard
in a format suitable for
-.IM grep (1)
+.MR grep (1)
or
-.IM look (1) .
+.MR look (1) .
To add a sequence, edit that file and then rebuild
-.IM devdraw (1) .
+.MR devdraw (1) .
.PP
There are several rules guiding the design of the sequences, as
illustrated by the following examples.
@@ -235,10 +235,10 @@ to run them automatically at startup.
sorted table of characters and keyboard sequences
.PD
.SH "SEE ALSO"
-.IM intro (1) ,
-.IM ascii (1) ,
-.IM tcs (1) ,
-.IM 9term (1) ,
-.IM acme (1) ,
-.IM sam (1) ,
-.IM utf (7)
+.MR intro (1) ,
+.MR ascii (1) ,
+.MR tcs (1) ,
+.MR 9term (1) ,
+.MR acme (1) ,
+.MR sam (1) ,
+.MR utf (7)
diff --git a/man/man7/man.7 b/man/man7/man.7
index 98fae1c3..f82a1bc7 100644
--- a/man/man7/man.7
+++ b/man/man7/man.7
@@ -82,9 +82,9 @@ font- or size-setting macros.
The
.B -man
macros admit equations and tables in the style of
-.IM eqn (1)
+.MR eqn (1)
and
-.IM tbl (1) ,
+.MR tbl (1) ,
but do not support arguments on
.B .EQ
and
@@ -113,7 +113,7 @@ The root directory of the Plan 9 installation.
.B \*9/tmac/tmac.antimes
.SH SEE ALSO
.IR troff (1),
-.IM man (1)
+.MR man (1)
.SH REQUESTS
.ta \w'.TH n c x 'u +\w'Cause 'u +\w'Argument\ 'u
.di xx
diff --git a/man/man7/map.7 b/man/man7/map.7
index 72925e41..ced8db49 100644
--- a/man/man7/map.7
+++ b/man/man7/map.7
@@ -80,7 +80,7 @@ in the map file.
Both the map file and the index file are ordered by
patch latitude and longitude.
.SH "SEE ALSO"
-.IM map (7)
+.MR map (7)
.br
The data comes from the World Data Bank I and II and
U.S. Government sources: the Census Bureau, Geological
diff --git a/man/man7/mhtml.7 b/man/man7/mhtml.7
index 95439641..f561fb43 100644
--- a/man/man7/mhtml.7
+++ b/man/man7/mhtml.7
@@ -19,14 +19,14 @@ mhtml \- macros for formatting HTML
\&...
.SH DESCRIPTION
This package of
-.IM htmlroff (1)
+.MR htmlroff (1)
macro definitions provides convenient macros for formatting HTML.
It is usually used along with
-.IM troff (1)
+.MR troff (1)
macro packages such as
-.IM man (7)
+.MR man (7)
and
-.IM ms (7) .
+.MR ms (7) .
.I Mhtml
replaces some macros defined in the other packages,
so it should be listed after them on the
@@ -64,7 +64,7 @@ before invoking
Accumulate footnotes and print them at the end of the
document under a \fBNotes\fP heading.
These replace the macros in
-.IM ms (7) .
+.MR ms (7) .
To emit the notes accumulated so far, invoke
.BR .NOTES .
.TP
@@ -75,7 +75,7 @@ and
.B .PE
with a PNG image corresponding to the output of
running
-.IM troff (1)
+.MR troff (1)
on the input.
.TP
.B .TS\fR, \fP.TE
@@ -100,6 +100,6 @@ percent of the current output width.
.SH FILES
.B \*9/tmac/tmac.html
.SH SEE ALSO
-.IM htmlroff (1) ,
-.IM htmlroff (7) ,
-.IM ms (7)
+.MR htmlroff (1) ,
+.MR htmlroff (7) ,
+.MR ms (7)
diff --git a/man/man7/mpictures.7 b/man/man7/mpictures.7
index c6eaf555..5da1d547 100644
--- a/man/man7/mpictures.7
+++ b/man/man7/mpictures.7
@@ -10,7 +10,7 @@ mpictures \- picture inclusion macros
.SH DESCRIPTION
.I Mpictures
macros insert PostScript pictures into
-.IM troff (1)
+.MR troff (1)
documents.
The macros are:
.TP
@@ -129,7 +129,7 @@ comment is present, the picture is
assumed to fill an 8.5\(mu11-inch page.
Nothing prevents the picture from being placed off the page.
.SH SEE ALSO
-.IM troff (1)
+.MR troff (1)
.SH DIAGNOSTICS
A picture file that can't be read by the PostScript
postprocessor is replaced by white space.
diff --git a/man/man7/ms.7 b/man/man7/ms.7
index 7d50c89a..5886a7e1 100644
--- a/man/man7/ms.7
+++ b/man/man7/ms.7
@@ -18,7 +18,7 @@ ms \- macros for formatting manuscripts
This package of
.I nroff
and
-.IM troff (1)
+.MR troff (1)
macro definitions provides a canned formatting
facility for tech%nical papers in various formats.
.PP
@@ -38,11 +38,11 @@ impunity after the first
.LR .na .
.PP
Output of the
-.IM eqn (1) ,
-.IM tbl (1) ,
-.IM pic (1)
+.MR eqn (1) ,
+.MR tbl (1) ,
+.MR pic (1)
and
-.IM grap (1)
+.MR grap (1)
preprocessors
for equations, tables, pictures, and graphs is acceptable as input.
.SH FILES
@@ -57,8 +57,8 @@ Tenth Edition, Volume 2.
.br
.IR eqn (1),
.IR troff (1),
-.IM tbl (1) ,
-.IM pic (1)
+.MR tbl (1) ,
+.MR pic (1)
.SH REQUESTS
.ta \w'..ND \fIdate\fR 'u +\w'Initial 'u +\w'Cause 'u
.br
@@ -153,7 +153,7 @@ Implies
produced by
.I neqn
or
-.IM eqn (1) .
+.MR eqn (1) .
.ti0
\fL\&.EQ\fP \fIx y\fR - yes Display equation.
Equation number is
@@ -234,7 +234,7 @@ is subsection level (default 1).
\fL\&.P2\fP - yes End program display.
.ti0
\fL\&.PE\fP - yes End picture; see
-.IM pic (1) .
+.MR pic (1) .
.ti0
\fL\&.PF\fP - yes End picture; restore vertical
position.
@@ -280,7 +280,7 @@ font automatically bold.
Default is 5 10 15 ...
.ti0
\fL\&.TE\fP - yes End table; see
-.IM tbl (1) .
+.MR tbl (1) .
.ti0
\fL\&.TH\fP - yes End heading section of table.
.ti0
diff --git a/man/man7/ndb.7 b/man/man7/ndb.7
index 9ab448fe..bb59d8aa 100644
--- a/man/man7/ndb.7
+++ b/man/man7/ndb.7
@@ -59,7 +59,7 @@ Within tuples, pairs on the same line bind tighter than
pairs on different lines.
.PP
Programs search the database directly using the routines in
-.IM ndb (3) .
+.MR ndb (3) .
.\" or indirectly using
.\" .B ndb/cs
.\" and
@@ -292,8 +292,8 @@ tcp=9fs port=564
first database file searched
.SH "SEE ALSO"
.\" .IR dial (2),
-.IM ndb (1) ,
-.IM ndb (3)
+.MR ndb (1) ,
+.MR ndb (3)
.\" .IR dhcpd (8),
.\" .IR ipconfig (8),
.\" .IR con (1)
diff --git a/man/man7/plot.7 b/man/man7/plot.7
index 31cb41a0..87308b3f 100644
--- a/man/man7/plot.7
+++ b/man/man7/plot.7
@@ -340,4 +340,4 @@ Restore previous environment.
.PD
.SH "SEE ALSO"
.IR plot (1),
-.IM graph (1)
+.MR graph (1)
diff --git a/man/man7/plumb.7 b/man/man7/plumb.7
index 446b4340..37b2385b 100644
--- a/man/man7/plumb.7
+++ b/man/man7/plumb.7
@@ -6,7 +6,7 @@ plumb \- format of plumb messages and rules
.SH DESCRIPTION
.SS "Message format
The messages formed by the
-.IM plumb (3)
+.MR plumb (3)
library are formatted for transmission between
processes into textual form, using newlines to separate
the fields.
@@ -61,7 +61,7 @@ A missing field is represented by an empty line.
The
.B plumber
(see
-.IM plumb (1) )
+.MR plumb (1) )
receives messages on its
.B send
port (applications
@@ -271,7 +271,7 @@ rule should be specified in a rule set.
.RE
.PP
The arguments to all rules may contain quoted strings, exactly as in
-.IM rc (1) .
+.MR rc (1) .
They may also contain simple string variables, identified by a leading dollar sign
.BR $ .
Variables may be set, between rule sets, by assignment statements in the style of
@@ -341,7 +341,7 @@ field of the message.
.B $plan9
The root directory of the Plan 9 tree
(see
-.IM get9root (3) ).
+.MR get9root (3) ).
.RE
.SH EXAMPLE
The following is a modest, representative file of plumbing rules.
@@ -403,7 +403,7 @@ default rules file.
.TP
.B plumb
service name for
-.IM plumber (4) .
+.MR plumber (4) .
.TP
.B \*9/plumb
directory for
@@ -416,7 +416,7 @@ public macro definitions.
.B \*9/plumb/basic
basic rule set.
.SH "SEE ALSO"
-.IM plumb (1) ,
-.IM plumb (3) ,
-.IM plumber (4) ,
-.IM regexp (7)
+.MR plumb (1) ,
+.MR plumb (3) ,
+.MR plumber (4) ,
+.MR regexp (7)
diff --git a/man/man7/regexp.7 b/man/man7/regexp.7
index dbc5a9a1..73fd4dde 100644
--- a/man/man7/regexp.7
+++ b/man/man7/regexp.7
@@ -4,9 +4,9 @@ regexp \- Plan 9 regular expression notation
.SH DESCRIPTION
This manual page describes the regular expression
syntax used by the Plan 9 regular expression library
-.IM regexp (3) .
+.MR regexp (3) .
It is the form used by
-.IM egrep (1)
+.MR egrep (1)
before
.I egrep
got complicated.
@@ -130,4 +130,4 @@ A match to any part of a regular expression
extends as far as possible without preventing
a match to the remainder of the regular expression.
.SH "SEE ALSO"
-.IM regexp (3)
+.MR regexp (3)
diff --git a/man/man7/thumbprint.7 b/man/man7/thumbprint.7
index 4d90f437..5a4b933b 100644
--- a/man/man7/thumbprint.7
+++ b/man/man7/thumbprint.7
@@ -9,7 +9,7 @@ for example by calling
and
.B okThumbprint
(see
-.IM pushtls (3) ),
+.MR pushtls (3) ),
check the remote side's public key by comparing against
thumbprints from a trusted list.
The list is maintained by people who set local policies
@@ -38,4 +38,4 @@ For example, a web server might have thumbprint
x509 sha1=8fe472d31b360a8303cd29f92bd734813cbd923c cn=*.cs.bell-labs.com
.EE
.SH "SEE ALSO"
-.IM pushtls (3)
+.MR pushtls (3)
diff --git a/man/man7/utf.7 b/man/man7/utf.7
index 0a963c8c..5ad61764 100644
--- a/man/man7/utf.7
+++ b/man/man7/utf.7
@@ -57,7 +57,7 @@ in order to work properly with non-\c
.SM ASCII
input.
See
-.IM rune (3) .
+.MR rune (3) .
.PP
Letting numbers be binary,
a rune x is converted to a multibyte
@@ -85,7 +85,7 @@ In the inverse mapping,
any sequence except those described above
is incorrect and is converted to rune hexadecimal 0080.
.SH "SEE ALSO"
-.IM ascii (1) ,
-.IM tcs (1) ,
-.IM rune (3) ,
+.MR ascii (1) ,
+.MR tcs (1) ,
+.MR rune (3) ,
.IR "The Unicode Standard" .
diff --git a/man/man7/venti.7 b/man/man7/venti.7
index 960920fc..800c85f3 100644
--- a/man/man7/venti.7
+++ b/man/man7/venti.7
@@ -14,19 +14,19 @@ of clients.
This manual page documents the basic concepts of
block storage using Venti as well as the Venti network protocol.
.PP
-.IM Venti (1)
+.MR Venti (1)
documents some simple clients.
-.IM Vac (1) ,
-.IM vacfs (4) ,
+.MR Vac (1) ,
+.MR vacfs (4) ,
and
-.IM vbackup (8)
+.MR vbackup (8)
are more complex clients.
.PP
-.IM Venti (3)
+.MR Venti (3)
describes a C library interface for accessing
Venti servers and manipulating Venti data structures.
.PP
-.IM Venti (8)
+.MR Venti (8)
describes the programs used to run a Venti server.
.PP
.SS "Scores
@@ -40,11 +40,11 @@ Scores may have an optional
prefix, typically used to
describe the format of the data.
For example,
-.IM vac (1)
+.MR vac (1)
uses a
.B vac:
prefix, while
-.IM vbackup (8)
+.MR vbackup (8)
uses prefixes corresponding to the file system
types:
.BR ext2: ,
@@ -93,7 +93,7 @@ Keeping this parallel representation is a minor annoyance
but makes it possible for general programs like
.I venti/copy
(see
-.IM venti (1) )
+.MR venti (1) )
to traverse the block tree without knowing the specific details
of any particular program's data.
.SS "Block Types
@@ -202,7 +202,7 @@ Text strings are represented similarly,
using a two-byte count with
the text itself stored as a UTF-encoded sequence
of Unicode characters (see
-.IM utf (7) ).
+.MR utf (7) ).
Text strings are not
.SM NUL\c
-terminated:
@@ -395,7 +395,7 @@ Use
and
.I vtfromdisktype
(see
-.IM venti (3) )
+.MR venti (3) )
to convert a block type enumeration value
.RB ( VtDataType ,
etc.)
@@ -457,9 +457,9 @@ in the
packet may be either 2 or 4 bytes;
the total packet length distinguishes the two cases.
.SH SEE ALSO
-.IM venti (1) ,
-.IM venti (3) ,
-.IM venti (8)
+.MR venti (1) ,
+.MR venti (3) ,
+.MR venti (8)
.br
Sean Quinlan and Sean Dorward,
``Venti: a new approach to archival storage'',