diff options
author | Russ Cox <rsc@swtch.com> | 2020-08-15 20:07:38 -0400 |
---|---|---|
committer | Russ Cox <rsc@swtch.com> | 2020-08-15 20:09:40 -0400 |
commit | d32deab17bfffa5bffc5fab3e6577558e40888c5 (patch) | |
tree | 745b19fb64cfbd1fd9d0c6039fe35a1fd85169d3 /man/man4 | |
parent | 9843fc0d82c68c78059ccb167e8402def5a4ee1f (diff) | |
download | plan9port-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/man4')
-rw-r--r-- | man/man4/0intro.4 | 14 | ||||
-rw-r--r-- | man/man4/9import.4 | 16 | ||||
-rw-r--r-- | man/man4/9pserve.4 | 8 | ||||
-rw-r--r-- | man/man4/acme.4 | 10 | ||||
-rw-r--r-- | man/man4/factotum.4 | 30 | ||||
-rw-r--r-- | man/man4/fontsrv.4 | 12 | ||||
-rw-r--r-- | man/man4/fossil.4 | 34 | ||||
-rw-r--r-- | man/man4/import.4 | 6 | ||||
-rw-r--r-- | man/man4/plumber.4 | 18 | ||||
-rw-r--r-- | man/man4/ramfs.4 | 6 | ||||
-rw-r--r-- | man/man4/smugfs.4 | 6 | ||||
-rw-r--r-- | man/man4/srv.4 | 10 | ||||
-rw-r--r-- | man/man4/tapefs.4 | 8 | ||||
-rw-r--r-- | man/man4/vacfs.4 | 4 |
14 files changed, 91 insertions, 91 deletions
diff --git a/man/man4/0intro.4 b/man/man4/0intro.4 index 598a03fb..c80db208 100644 --- a/man/man4/0intro.4 +++ b/man/man4/0intro.4 @@ -15,7 +15,7 @@ In Plan 9, the kernel mount device \fImnt\fR(3) acts as a client to the 9P servers mounted in the current name space, translating system calls such as -.IM open (2) +.MR open (2) into 9P transactions such as .IR open (9p). The kernel also multiplexes the potentially many processes onto a single 9P conversation @@ -30,17 +30,17 @@ On Unix, 9P clients do not access servers via the traditional file system call interface. Only the Unix name space can be accessed that way. Instead, 9P clients use the -.IM 9pclient (3) +.MR 9pclient (3) library to connect and interact directly with particular 9P servers. The -.IM 9p (1) +.MR 9p (1) command-line client is useful for interactive use and in shell scripts. .PP To preserve the façade of a single 9P conversation with each server, 9P servers invoke -.IM 9pserve (4) , +.MR 9pserve (4) , typically via -.IM post9pservice (3) . +.MR post9pservice (3) . .I 9pserve announces a 9P service at a particular network address and multiplexes the clients that connect to @@ -58,7 +58,7 @@ Setting the .B $NAMESPACE environment variable overrides this default. The -.IM namespace (1) +.MR namespace (1) command prints the current name space directory. .PP Occasionally it is useful to be able to connect the input or output @@ -73,7 +73,7 @@ implementation of (see also .I fsopenfd in -.IM 9pclient (3) ) +.MR 9pclient (3) ) returns the read or write end of a pipe; a helper process transfers data between the other end of the pipe and the 9P server. diff --git a/man/man4/9import.4 b/man/man4/9import.4 index 5bcafe52..6ddff346 100644 --- a/man/man4/9import.4 +++ b/man/man4/9import.4 @@ -19,7 +19,7 @@ tool allows an arbitrary on a remote .I system, with the capability of running the Plan 9 -.IM exportfs (4) +.MR exportfs (4) service, to be imported into the local name space. Usually @@ -31,7 +31,7 @@ A process is started on the remote machine, with authority of the user of .IR 9import , to perform work for the local machine using the -.IM exportfs (4) +.MR exportfs (4) service. The default port used is TCP 17007. If @@ -55,11 +55,11 @@ Use .I keypattern to select a key to authenticate to the remote side (see -.IM auth (2) ). +.MR auth (2) ). .TP .B -p Push the -.IM aan (8) +.MR aan (8) filter onto the connection to protect against temporary network outages. .TP @@ -69,11 +69,11 @@ Post the connection's mountable file descriptor as .SH SOURCE .B \*9/src/cmd/9import.c .SH SEE ALSO -.IM srv (4) , -.IM aan (8) , -.IM listen1 (8) , +.MR srv (4) , +.MR aan (8) , +.MR listen1 (8) , .B cs in -.IM ndb (7) +.MR ndb (7) .SH BUGS Encryption is not implemented. diff --git a/man/man4/9pserve.4 b/man/man4/9pserve.4 index 7eaa975f..7f691b58 100644 --- a/man/man4/9pserve.4 +++ b/man/man4/9pserve.4 @@ -50,7 +50,7 @@ and clunks any outstanding fids belonging to the client. .PP .I 9pserve is typically not invoked directly; use -.IM post9pservice (3) +.MR post9pservice (3) instead. .PP The options are: @@ -73,7 +73,7 @@ rewrite all attach messages to use and .IR afid ; used to implement -.IM srv (4) 's +.MR srv (4) 's .B -a option .TP @@ -90,8 +90,8 @@ instead assume 9P2000 and a maximum message size of .IR msize .PD .SH "SEE ALSO -.IM intro (4) , +.MR intro (4) , .IR intro (9p), -.IM 9pfuse (4) +.MR 9pfuse (4) .SH SOURCE .B \*9/src/cmd/9pserve.c diff --git a/man/man4/acme.4 b/man/man4/acme.4 index 1ed287fb..a285b3b8 100644 --- a/man/man4/acme.4 +++ b/man/man4/acme.4 @@ -15,7 +15,7 @@ acme \- control files for text windows \&... ] .SH DESCRIPTION The text window system -.IM acme (1) +.MR acme (1) serves a variety of files for reading, writing, and controlling windows. Some of them are virtual versions of system files for dealing @@ -28,7 +28,7 @@ When a command is run under a directory holding these files is posted as the 9P service .B acme (using -.IM 9pserve (4) ). +.MR 9pserve (4) ). .PP Some of these files supply virtual versions of services available from the underlying environment, in particular the character terminal files in Plan 9's @@ -47,7 +47,7 @@ Other files are unique to is a subdirectory used by .B win (see -.IM acme (1) ) +.MR acme (1) ) as a mount point for the .I acme files associated with the window in which @@ -436,5 +436,5 @@ except that reads stop at the end address. .SH SOURCE .B \*9/src/cmd/acme .SH SEE ALSO -.IM rio (1) , -.IM acme (1) +.MR rio (1) , +.MR acme (1) diff --git a/man/man4/factotum.4 b/man/man4/factotum.4 index 453965df..02466fcf 100644 --- a/man/man4/factotum.4 +++ b/man/man4/factotum.4 @@ -127,7 +127,7 @@ RSA encryption and signatures, used by SSH and TLS. passwords in the clear. .TP .B vnc -.IM vnc (1) 's +.MR vnc (1) 's challenge/response. .TP .B wep @@ -186,7 +186,7 @@ cpu server. On starting, it will attempt to get a key from NVRAM using .B readnvram (see -.IM authsrv (3) ), +.MR authsrv (3) ), prompting for anything it needs. It will never subsequently prompt for a key that it doesn't have. @@ -245,7 +245,7 @@ specific to each supported protocol. .PP All keys can have additional attibutes that act either as comments or as selectors to distinguish them in the -.IM auth (3) +.MR auth (3) library calls. .PP The factotum owner can use any key stored by factotum. @@ -305,7 +305,7 @@ such as and .B auth_challenge (see -.IM auth (3) ) +.MR auth (3) ) to specify which key and protocol to use for an authentication. Like a key tuple, a key template is also a list of .IB attribute = value @@ -367,7 +367,7 @@ turned on by the option. .PP By default when factotum starts it looks for a -.IM secstore (1) +.MR secstore (1) account on $auth for the user and, if one exists, prompts for a secstore password in order to fetch the file @@ -385,7 +385,7 @@ sets a public/private keypair for ssh authentication, generated by .B ssh_genkey (see -.IM ssh (1) ). +.MR ssh (1) ). .PD .SS "Confirming key use .PP @@ -481,11 +481,11 @@ RPC's) until done if successful, reading back an .I AuthInfo structure (see -.IM authsrv (3) ). +.MR authsrv (3) ). .PP The RPC protocol is normally embodied by one of the routines in -.IM auth (3) . +.MR auth (3) . We describe it here should anyone want to extend the library. .PP @@ -545,7 +545,7 @@ necessary authentication has succeeded, an .B AuthInfo structure (see -.IM auth (3) ) +.MR auth (3) ) can be retrieved with an .B authinfo RPC @@ -703,7 +703,7 @@ and are intended to be proxied via .I auth_proxy (see -.IM auth (3) ). +.MR auth (3) ). .\" The protocols follow .\" .IR p9any (7) .\" and @@ -736,7 +736,7 @@ before being sent over the network. .PP .I Vnc is the challenge-response protocol used by -.IM vnc (1) ; +.MR vnc (1) ; valid roles are .B client and @@ -840,7 +840,7 @@ a string: a space-separated quoted user name and password that can be parsed with .I tokenize (see -.IM getfields (3) ). +.MR getfields (3) ). Conventionally, client keys have distinguishing attributes like .B service @@ -905,7 +905,7 @@ and .BR !dk specifying the private half of the key; see -.IM rsa (3) . +.MR rsa (3) . Conventionally, .I rsa keys also have @@ -972,7 +972,7 @@ attributes. If the key is to be used for signing, it must also have a .B !secret attribute; see -.IM dsa (3) . +.MR dsa (3) . Conventionally, .I dsa keys @@ -1019,4 +1019,4 @@ The response is a hexadecimal string of length 32. .SH SOURCE .B \*9/src/cmd/auth/factotum .SH SEE ALSO -.IM ssh-agent (1) +.MR ssh-agent (1) diff --git a/man/man4/fontsrv.4 b/man/man4/fontsrv.4 index a270b2f1..6cc0d0a7 100644 --- a/man/man4/fontsrv.4 +++ b/man/man4/fontsrv.4 @@ -20,7 +20,7 @@ fontsrv \- file system access to host fonts presents the host window system's fonts in the standard Plan 9 format (see -.IM font (7) ). +.MR font (7) ). It serves a virtual directory tree mounted at .I mtpt (if the @@ -72,14 +72,14 @@ representing 32-character Unicode ranges. .PP .I Openfont (see -.IM graphics (3) ) +.MR graphics (3) ) recognizes font paths beginning with .B /mnt/font and implements them by invoking .IR fontsrv ; it need not be running already. See -.IM font (7) +.MR font (7) for a full discussion of font name syntaxes. .SH EXAMPLES List the fonts on the system: @@ -96,7 +96,7 @@ or: .EE .LP Run -.IM acme (1) +.MR acme (1) using the operating system's Monaco as the fixed-width font: .IP .EX @@ -104,7 +104,7 @@ using the operating system's Monaco as the fixed-width font: .EE .LP Run -.IM sam (1) +.MR sam (1) using the same font: .IP .EX @@ -113,7 +113,7 @@ using the same font: .SH SOURCE .B \*9/src/cmd/fontsrv .SH SEE ALSO -.IM font (7) +.MR font (7) .SH BUGS .PP Due to OS X restrictions, diff --git a/man/man4/fossil.4 b/man/man4/fossil.4 index 6072a39a..fd6dd0a9 100644 --- a/man/man4/fossil.4 +++ b/man/man4/fossil.4 @@ -148,10 +148,10 @@ will be named The attach name used in .I mount (see -.IM bind (1) , -.IM bind (2) +.MR bind (1) , +.MR bind (2) and -.IM attach (5) ) +.MR attach (5) ) selects a file system to be served and optionally a subtree, in the format @@ -163,7 +163,7 @@ An empty attach name selects normally requires all users except .L none to provide authentication tickets on each -.IM attach (5) . +.MR attach (5) . To keep just anyone from connecting, .L none is only allowed to attach after another user @@ -179,7 +179,7 @@ flag to or .B srv (see -.IM fossilcons (8) ). +.MR fossilcons (8) ). .PP The groups called .B noworld @@ -207,7 +207,7 @@ readable by the world but writable only to the developers. starts a new instance of the fossil file server. It is configured mainly through console commands, documented in -.IM fossilcons (8) . +.MR fossilcons (8) . .PP The options are: .TF "-c\fI cmd @@ -239,7 +239,7 @@ and which starts a file server console on .BI /srv/ cons \fR. See -.IM fossilcons (8) +.MR fossilcons (8) for more information. .TP .BI -f " file @@ -269,7 +269,7 @@ for inconsistencies. is deprecated in favor of the console .B check command (see -.IM fossilcons (8) ). +.MR fossilcons (8) ). .I Flchk prints .I fossil @@ -375,7 +375,7 @@ system stored on Venti at The score should have been generated by .I fossil rather than by -.IM vac (1) , +.MR vac (1) , so that the appropriate snapshot metadata is present. .PD .PP @@ -450,7 +450,7 @@ See the discussion of the and .B uname commands in -.IM fossilcons (8) +.MR fossilcons (8) for more about the user table. .ne 3 .PP @@ -488,13 +488,13 @@ command to prepare the script. .SH SOURCE .B \*9/src/cmd/fossil .SH SEE ALSO -.IM yesterday (1) , -.IM fs (3) , -.IM fs (4) , -.IM srv (4) , -.IM fossilcons (8) , -.IM loadfossil (8) , -.IM venti (8) +.MR yesterday (1) , +.MR fs (3) , +.MR fs (4) , +.MR srv (4) , +.MR fossilcons (8) , +.MR loadfossil (8) , +.MR venti (8) .SH BUGS It is possible that the disk format (but not the Venti format) will change in the future, to make the disk a full cache diff --git a/man/man4/import.4 b/man/man4/import.4 index 7d67a449..434a23bd 100644 --- a/man/man4/import.4 +++ b/man/man4/import.4 @@ -48,7 +48,7 @@ the path have different meanings on the two systems.) connects to .I system using -.IM ssh (1) . +.MR ssh (1) . It invokes .I import on the remote system to carry out the remote @@ -109,5 +109,5 @@ sam & .SH SOURCE .B \*9/src/cmd/import.c .SH SEE ALSO -.IM 9pserve (4) , -.IM intro (4) +.MR 9pserve (4) , +.MR intro (4) diff --git a/man/man4/plumber.4 b/man/man4/plumber.4 index a86f032a..c309a39c 100644 --- a/man/man4/plumber.4 +++ b/man/man4/plumber.4 @@ -14,17 +14,17 @@ plumber \- file system for interprocess messaging The .I plumber is a user-level file server that receives, examines, rewrites, and dispatches -.IM plumb (7) +.MR plumb (7) messages between programs. Its behavior is programmed by a .I plumbing file (default .BR $HOME/lib/plumbing ) in the format of -.IM plumb (7) . +.MR plumb (7) . .PP Its services are posted via -.IM 9pserve (4) +.MR 9pserve (4) as .BR plumb , and consist of two @@ -39,14 +39,14 @@ for dispatching messages to applications. Programs use .B fswrite (see -.IM 9pclient (3) ) +.MR 9pclient (3) ) to deliver messages to the .B send file, and .I fsread to receive them from the corresponding port. For example, -.IM sam (1) 's +.MR sam (1) 's .B plumb menu item or the .B B @@ -115,13 +115,13 @@ statements .TP .B plumb mount name for -.IM plumber (4) . +.MR plumber (4) . .SH SOURCE .B \*9/src/cmd/plumb .SH "SEE ALSO" -.IM plumb (1) , -.IM plumb (3) , -.IM plumb (7) +.MR plumb (1) , +.MR plumb (3) , +.MR plumb (7) .\" .SH BUGS .\" .IR Plumber 's .\" file name space is fixed, so it is difficult to plumb diff --git a/man/man4/ramfs.4 b/man/man4/ramfs.4 index 20e72b38..79451981 100644 --- a/man/man4/ramfs.4 +++ b/man/man4/ramfs.4 @@ -21,7 +21,7 @@ By default posts its service as .B ramfs using -.IM 9pserve (4) . +.MR 9pserve (4) . .PP The .B -S @@ -46,5 +46,5 @@ It can also be used to provide high-performance temporary files. .SH SOURCE .B \*9/src/cmd/ramfs.c .SH "SEE ALSO" -.IM 9p (3) , -.IM 9pserve (4) +.MR 9p (3) , +.MR 9pserve (4) diff --git a/man/man4/smugfs.4 b/man/man4/smugfs.4 index fdea4e47..be3404b1 100644 --- a/man/man4/smugfs.4 +++ b/man/man4/smugfs.4 @@ -24,7 +24,7 @@ is a user-level file system that provides access to images stored on the SmugMug photo sharing service. It logs in after obtaining a password from -.IM factotum (4) +.MR factotum (4) using .B server=smugmug.com and @@ -32,7 +32,7 @@ and (if any) as key criteria (see -.IM auth (3) ). +.MR auth (3) ). Then .I smugfs serves a virtual directory tree mounted at @@ -265,7 +265,7 @@ SmugMug, If multiple categories or albums have the same name, only one will be accessible via the file system interface. Renaming the accessible one via Unix's -.IM mv (1) +.MR mv (1) will resolve the problem. .PP Boolean values appear as diff --git a/man/man4/srv.4 b/man/man4/srv.4 index 469b2b4c..ae6a7634 100644 --- a/man/man4/srv.4 +++ b/man/man4/srv.4 @@ -22,7 +22,7 @@ srv, 9fs \- start network file service dials the given address and initializes the connection to serve the 9P protocol. It then posts the resulting connection in the current name space (see -.IM intro (4) ) +.MR intro (4) ) as .I srvname (default @@ -70,7 +70,7 @@ available as service .IR sources . .I 9fs is an -.IM rc (1) +.MR rc (1) script; examine it to see what local conventions apply. .SH EXAMPLES List the root directory on @@ -98,6 +98,6 @@ sudo mount -t 9p -o trans=unix,uname=$USER,dfltuid=`id -u`,dfltgid=`id -g` .br .B \*9/bin/9fs .SH "SEE ALSO -.IM dial (3) , -.IM intro (4) , -.IM netfiles (1) +.MR dial (3) , +.MR intro (4) , +.MR netfiles (1) diff --git a/man/man4/tapefs.4 b/man/man4/tapefs.4 index b8843173..669cc819 100644 --- a/man/man4/tapefs.4 +++ b/man/man4/tapefs.4 @@ -91,7 +91,7 @@ Tenth Edition research Unix systems (4KB block size). .PP .I Zipfs interprets zip archives (see -.IM gzip (1) ). +.MR gzip (1) ). .SH SOURCE .PP These commands are constructed in a highly stereotyped @@ -103,7 +103,7 @@ in .BR \*9/src/cmd/tapefs , which in turn derive substantially from -.IM ramfs (4) . +.MR ramfs (4) . .SH "SEE ALSO -.IM intro (7) , -.IM ramfs (4) . +.MR intro (7) , +.MR ramfs (4) . diff --git a/man/man4/vacfs.4 b/man/man4/vacfs.4 index 0c92ff60..f3287e35 100644 --- a/man/man4/vacfs.4 +++ b/man/man4/vacfs.4 @@ -26,7 +26,7 @@ vacfs \- a Venti-based file system .SH DESCRIPTION .I Vacfs interprets the file system created by -.IM vac (1) +.MR vac (1) so that it can be mounted into a Plan 9 file hierarchy. The data for the file system is stored on a Venti server with a root fingerprint specified in @@ -81,6 +81,6 @@ The amount of memory, in bytes, allocated to the block cache. The default is 16M .SH SOURCE .B \*9/src/cmd/vac .SH "SEE ALSO" -.IM vac (1) , +.MR vac (1) , Plan 9's .IR venti (8) |