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/man8 | |
| parent | 00446db7d8fdb3ea56fa104643b34823960f7be2 (diff) | |
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/man8')
| -rw-r--r-- | man/man8/fossilcons.8 | 18 | ||||
| -rw-r--r-- | man/man8/getflags.8 | 10 | ||||
| -rw-r--r-- | man/man8/listen1.8 | 2 | ||||
| -rw-r--r-- | man/man8/mkfs.8 | 8 | ||||
| -rw-r--r-- | man/man8/vbackup.8 | 12 | ||||
| -rw-r--r-- | man/man8/venti-backup.8 | 4 | ||||
| -rw-r--r-- | man/man8/venti-fmt.8 | 12 | ||||
| -rw-r--r-- | man/man8/venti.8 | 20 |
8 files changed, 43 insertions, 43 deletions
diff --git a/man/man8/fossilcons.8 b/man/man8/fossilcons.8 index 8ad9d4be..93a355ea 100644 --- a/man/man8/fossilcons.8 +++ b/man/man8/fossilcons.8 @@ -340,7 +340,7 @@ con /srv/fscons .SH DESCRIPTION These are configuration and maintenance commands executed at the console of a -.MR fossil (4) +.MR fossil 4 file server. The commands are split into three groups above: file server configuration, @@ -372,11 +372,11 @@ a file in any file system served by .I 9p executes a 9P transaction; the arguments are in the same format used by -.MR 9pcon (8) . +.MR 9pcon 8 . .PP .I Bind behaves similarly to -.MR bind (1) . +.MR bind 1 . It is useful when fossil is started without devices it needs configured into its namespace. @@ -389,7 +389,7 @@ standard error. .PP .I Echo behaves identically to -.MR echo (1) , +.MR echo 1 , writing to the console. .PP .I Listen @@ -492,7 +492,7 @@ the string used to represent this user in the 9P protocol .TP .I leader the group's leader (see Plan 9's -.MR stat (5) +.MR stat 5 for a description of the special privileges held by a group leader) .TP .I members @@ -821,7 +821,7 @@ removing a non-empty directory. A subsequent .I flchk (see -.MR fossil (4) ) +.MR fossil 4 ) will identify the abandoned storage so it can be reclaimed with .I bfree commands. @@ -1013,7 +1013,7 @@ takes a temporary snapshot of the current file system, recording it in .BI /snapshot/ yyyy / mmdd / hhmm \fR, as described in -.MR fossil (4) . +.MR fossil 4 . The .B -a flag causes @@ -1021,7 +1021,7 @@ flag causes to take an archival snapshot, recording it in .BI /archive/ yyyy / mmdd \fR, also described in -.MR fossil (4) . +.MR fossil 4 . By default the snapshot is taken of .BR /active , the root of the active file system. @@ -1132,7 +1132,7 @@ writes dirty blocks in memory to the disk. .PP .I Vac prints the Venti score for a -.MR vac (1) +.MR vac 1 archive containing the tree rooted at .IR dir , diff --git a/man/man8/getflags.8 b/man/man8/getflags.8 index 776a17aa..eb13abb3 100644 --- a/man/man8/getflags.8 +++ b/man/man8/getflags.8 @@ -16,7 +16,7 @@ not take arguments, or a letter followed by the space-separated names of its arguments. .I Getflags prints an -.MR rc (1) +.MR rc 1 script on standard output which initializes the environment variable .BI $flag x @@ -51,15 +51,15 @@ and .BR $0 , the program name (see -.MR rc (1) ). +.MR rc 1 ). If run under -.MR sh (1) , +.MR sh 1 , which does not set .BR $0 , the program name must be given explicitly on the command line. .SH EXAMPLE Parse the arguments for Plan 9's -.MR leak (1) : +.MR leak 1 : .IP .EX flagfmt='b,s,f binary,r res,x width' @@ -74,4 +74,4 @@ if(! ifs=() eval `{getflags $*} || ~ $#* 0){ .br .B \*9/src/cmd/usage.c .SH SEE ALSO -.MR arg (3) +.MR arg 3 diff --git a/man/man8/listen1.8 b/man/man8/listen1.8 index 98f560f3..46de1b14 100644 --- a/man/man8/listen1.8 +++ b/man/man8/listen1.8 @@ -34,4 +34,4 @@ flag causes verbose logging on standard output. .SH SOURCE .B \*9/src/cmd/listen1.c .SH "SEE ALSO" -.MR dial (3) +.MR dial 3 diff --git a/man/man8/mkfs.8 b/man/man8/mkfs.8 index 073e55b2..954ad259 100644 --- a/man/man8/mkfs.8 +++ b/man/man8/mkfs.8 @@ -34,7 +34,7 @@ copies files from the file tree to a .B kfs file system (see -.MR kfs (4) ). +.MR kfs 4 ). The kfs service is mounted on .I root (default @@ -47,7 +47,7 @@ The .I proto files are read (see -.MR proto (2) +.MR proto 2 for their format) and any files specified in them that are out of date are copied to .BR /n/kfs . @@ -183,5 +183,5 @@ disk/mkext -u -d /n/newfs < arch .br .B \*9/src/cmd/disk/mkext.c .SH "SEE ALSO" -.MR prep (8) , -.MR tar (1) +.MR prep 8 , +.MR tar 1 diff --git a/man/man8/vbackup.8 b/man/man8/vbackup.8 index fa201f40..5e89df98 100644 --- a/man/man8/vbackup.8 +++ b/man/man8/vbackup.8 @@ -70,7 +70,7 @@ back up Unix file systems to Venti .SH DESCRIPTION These programs back up and restore standard Unix file system images stored in -.MR venti (8) . +.MR venti 8 . Images stored in .I venti are named by @@ -102,7 +102,7 @@ The argument .I disk should be a disk or disk partition device that would be appropriate to pass to -.MR mount (8) . +.MR mount 8 . .PP The optional argument .I score @@ -135,7 +135,7 @@ The default is the name returned by .I sysname (see -.MR getuser (3) ). +.MR getuser 3 ). The default .I mtpt is the place where @@ -149,7 +149,7 @@ command. The default is the name returned by .I sysname (see -.MR getuser (3) ). +.MR getuser 3 ). .TP .B -n No-op mode: do not write any blocks to the server @@ -207,7 +207,7 @@ to zero unused blocks instead. .PP .I Vftp presents an -.MR ftp (1) -like +.MR ftp 1 -like interface to a physical or backed-up disk image. It is used mainly for debugging. Type @@ -228,7 +228,7 @@ must be run by the user Because .I address is passed to the host OS kernel rather than interpreted by -.MR dial (3) , +.MR dial 3 , it must be only an IP address, not a full dial address. .PP .I Vnfs diff --git a/man/man8/venti-backup.8 b/man/man8/venti-backup.8 index 131514c6..3dfb1fb4 100644 --- a/man/man8/venti-backup.8 +++ b/man/man8/venti-backup.8 @@ -104,8 +104,8 @@ for a version that does this. .SH SOURCE .B \*9/src/cmd/venti/srv .SH SEE ALSO -.MR venti (7) , -.MR venti (8) +.MR venti 7 , +.MR venti 8 .SH BUGS .I Wrarena can't read a pipe or network connection containing an arena; diff --git a/man/man8/venti-fmt.8 b/man/man8/venti-fmt.8 index 39906862..35e4d77b 100644 --- a/man/man8/venti-fmt.8 +++ b/man/man8/venti-fmt.8 @@ -99,9 +99,9 @@ syncindex \- prepare and maintain a venti server These commands aid in the setup, maintenance, and debugging of venti servers. See -.MR venti (7) +.MR venti 7 for an overview of the venti system and -.MR venti (8) +.MR venti 8 for an overview of the data structures used by the venti server. .PP Note that the units for the various sizes in the following @@ -195,7 +195,7 @@ formats the given .I file as a Bloom filter (see -.MR venti (7) ). +.MR venti 7 ). The options are: .TF "\fL-s\fI size" .PD @@ -264,7 +264,7 @@ overflow. The total size of the index should be about 2% to 10% of the total size of the arenas, but the exact percentage depends both on the index block size and the compressed size of blocks stored. See the discussion in -.MR venti (8) +.MR venti 8 for more. .PP .I Fmtindex @@ -401,8 +401,8 @@ Increase the verbosity of output. .SH SOURCE .B \*9/src/cmd/venti/srv .SH SEE ALSO -.MR venti (7) , -.MR venti (8) +.MR venti 7 , +.MR venti 8 .SH BUGS .I Buildindex should allow an individual index section to be rebuilt. diff --git a/man/man8/venti.8 b/man/man8/venti.8 index 6a6d53e0..b3e06d84 100644 --- a/man/man8/venti.8 +++ b/man/man8/venti.8 @@ -40,7 +40,7 @@ venti \- archival storage server .I Venti is a SHA1-addressed archival storage server. See -.MR venti (7) +.MR venti 7 for a full introduction to the system. This page documents the structure and operation of the server. .PP @@ -138,7 +138,7 @@ less than 10 are not very useful; greater than 24 are probably a waste of memory. .I Fmtbloom (see -.MR venti-fmt (8) ) +.MR venti-fmt 8 ) can be given either .I nhash or @@ -220,7 +220,7 @@ The venti server announces two network services, one .BR venti , 17034) serving the venti protocol as described in -.MR venti (7) , +.MR venti 7 , and one serving HTTP (conventionally TCP port .BR http , @@ -333,7 +333,7 @@ with or .I fmtisect (see -.MR venti-fmt (8) ). +.MR venti-fmt 8 ). In particular, only the configuration needs to be changed if a component is moved to a different file. .PP @@ -506,11 +506,11 @@ Start the server and check the storage statistics: .SH SOURCE .B \*9/src/cmd/venti/srv .SH "SEE ALSO" -.MR venti (1) , -.MR venti (3) , -.MR venti (7) , -.MR venti-backup (8) -.MR venti-fmt (8) +.MR venti 1 , +.MR venti 3 , +.MR venti 7 , +.MR venti-backup 8 +.MR venti-fmt 8 .br Sean Quinlan and Sean Dorward, ``Venti: a new approach to archival storage'', @@ -523,7 +523,7 @@ Venti should not require the user to decide how to partition its memory usage. .PP Users of shells other than -.MR rc (1) +.MR rc 1 will not be able to use the program names shown. One solution is to define .B "V=$PLAN9/bin/venti" |