aboutsummaryrefslogtreecommitdiff
path: root/man/man8
diff options
context:
space:
mode:
authorDmitri Vereshchagin <dmitri.vereshchagin@gmail.com>2024-01-31 20:47:13 +0300
committerDan Cross <crossd@gmail.com>2025-07-27 09:58:50 -0400
commit10564b11755ff2d48d0f5073c46571e806fa6fb4 (patch)
tree229252742051d83558fff2352642d0f57ba66615 /man/man8
parent00446db7d8fdb3ea56fa104643b34823960f7be2 (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.818
-rw-r--r--man/man8/getflags.810
-rw-r--r--man/man8/listen1.82
-rw-r--r--man/man8/mkfs.88
-rw-r--r--man/man8/vbackup.812
-rw-r--r--man/man8/venti-backup.84
-rw-r--r--man/man8/venti-fmt.812
-rw-r--r--man/man8/venti.820
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"