diff options
| author | Dmitri Vereshchagin <dmitri.vereshchagin@gmail.com> | 2024-01-31 20:47:13 +0300 |
|---|---|---|
| committer | Dan Cross <crossd@gmail.com> | 2025-07-27 09:58:50 -0400 |
| commit | 10564b11755ff2d48d0f5073c46571e806fa6fb4 (patch) | |
| tree | 229252742051d83558fff2352642d0f57ba66615 /man/man4 | |
| parent | 00446db7d8fdb3ea56fa104643b34823960f7be2 (diff) | |
| download | plan9port-10564b11755ff2d48d0f5073c46571e806fa6fb4.tar.gz plan9port-10564b11755ff2d48d0f5073c46571e806fa6fb4.zip | |
tmac/tmac.an: define .MR in a groff compatible way
groff 1.23.0 added .MR to its -man macro package. The NEWS file states
that the inclusion of the macro "was prompted by its introduction to
Plan 9 from User Space's troff in August 2020." From d32deab it seems
that the name for Plan 9 from User Space's implementation was suggested
by groff maintainer G. Brandon Robinson.
Not sure if the intention was to make these definitions compatible, but
it would be nice if they were.
Currently, Plan 9 from User Space's .MR expects its second argument to
be parenthesized. groff's .MR does not. This results in extra
parentheses appearing in manual references when viewing Plan 9 from User
Space's manual pages on a system using groff.
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 c80db208..2f3f8c2b 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 -.MR 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 -.MR 9pclient (3) +.MR 9pclient 3 library to connect and interact directly with particular 9P servers. The -.MR 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 -.MR 9pserve (4) , +.MR 9pserve 4 , typically via -.MR 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 -.MR 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 -.MR 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 6ddff346..e7aef6be 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 -.MR 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 -.MR 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 -.MR auth (2) ). +.MR auth 2 ). .TP .B -p Push the -.MR 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 -.MR srv (4) , -.MR aan (8) , -.MR listen1 (8) , +.MR srv 4 , +.MR aan 8 , +.MR listen1 8 , .B cs in -.MR ndb (7) +.MR ndb 7 .SH BUGS Encryption is not implemented. diff --git a/man/man4/9pserve.4 b/man/man4/9pserve.4 index 7f691b58..20ca5631 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 -.MR 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 -.MR 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 -.MR intro (4) , +.MR intro 4 , .IR intro (9p), -.MR 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 9916f470..acae4f21 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 -.MR 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 -.MR 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 -.MR acme (1) ) +.MR acme 1 ) as a mount point for the .I acme files associated with the window in which @@ -441,5 +441,5 @@ except that reads stop at the end address. .SH SOURCE .B \*9/src/cmd/acme .SH SEE ALSO -.MR rio (1) , -.MR acme (1) +.MR rio 1 , +.MR acme 1 diff --git a/man/man4/factotum.4 b/man/man4/factotum.4 index 02466fcf..282efd8d 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR authsrv (3) ). +.MR authsrv 3 ). .PP The RPC protocol is normally embodied by one of the routines in -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR ssh-agent (1) +.MR ssh-agent 1 diff --git a/man/man4/fontsrv.4 b/man/man4/fontsrv.4 index 6cc0d0a7..fd37acd5 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 fd6dd0a9..67eedb20 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 -.MR bind (1) , -.MR bind (2) +.MR bind 1 , +.MR bind 2 and -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR 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 -.MR yesterday (1) , -.MR fs (3) , -.MR fs (4) , -.MR srv (4) , -.MR fossilcons (8) , -.MR loadfossil (8) , -.MR 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 434a23bd..73d24094 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 -.MR 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 -.MR 9pserve (4) , -.MR intro (4) +.MR 9pserve 4 , +.MR intro 4 diff --git a/man/man4/plumber.4 b/man/man4/plumber.4 index c309a39c..04799f96 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 -.MR 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 -.MR plumb (7) . +.MR plumb 7 . .PP Its services are posted via -.MR 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 -.MR 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, -.MR 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 -.MR plumber (4) . +.MR plumber 4 . .SH SOURCE .B \*9/src/cmd/plumb .SH "SEE ALSO" -.MR plumb (1) , -.MR plumb (3) , -.MR 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 79451981..827133ab 100644 --- a/man/man4/ramfs.4 +++ b/man/man4/ramfs.4 @@ -21,7 +21,7 @@ By default posts its service as .B ramfs using -.MR 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" -.MR 9p (3) , -.MR 9pserve (4) +.MR 9p 3 , +.MR 9pserve 4 diff --git a/man/man4/smugfs.4 b/man/man4/smugfs.4 index be3404b1..98d6198e 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 -.MR factotum (4) +.MR factotum 4 using .B server=smugmug.com and @@ -32,7 +32,7 @@ and (if any) as key criteria (see -.MR 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 -.MR 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 ae6a7634..74d78a2a 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 -.MR intro (4) ) +.MR intro 4 ) as .I srvname (default @@ -70,7 +70,7 @@ available as service .IR sources . .I 9fs is an -.MR 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 -.MR dial (3) , -.MR intro (4) , -.MR netfiles (1) +.MR dial 3 , +.MR intro 4 , +.MR netfiles 1 diff --git a/man/man4/tapefs.4 b/man/man4/tapefs.4 index 669cc819..2bcf6bc9 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 -.MR 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 -.MR ramfs (4) . +.MR ramfs 4 . .SH "SEE ALSO -.MR intro (7) , -.MR ramfs (4) . +.MR intro 7 , +.MR ramfs 4 . diff --git a/man/man4/vacfs.4 b/man/man4/vacfs.4 index f3287e35..eb37be50 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 -.MR 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" -.MR vac (1) , +.MR vac 1 , Plan 9's .IR venti (8) |
