From 977b25a76ae8263e53fb4eb1abfc395769f23e3d Mon Sep 17 00:00:00 2001
From: Russ Cox <rsc@swtch.com>
Date: Thu, 13 Aug 2020 23:41:59 -0400
Subject: tmac: introduce real manual reference macro instead of overloading IR

The overloading of IR emits magic \X'...' sequences that turn into HTML manual links.
But not all such IR invocations should be manual links;
those had to be written to avoid the IR macro before.
Worse, the \X'...' ending the IR causes troff to emit only a single space after a period.

Defining a new IM macro for manual references fixes both problems.

Fixes #441.
---
 man/man8/venti-fmt.8 | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

(limited to 'man/man8/venti-fmt.8')

diff --git a/man/man8/venti-fmt.8 b/man/man8/venti-fmt.8
index 7c44754f..19679ca0 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
-.IR venti (7)
+.IM venti (7)
 for an overview of the venti system and
-.IR venti (8)
+.IM 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
-.IR venti (7)).
+.IM 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
-.IR venti (8)
+.IM 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
-.IR venti (7),
-.IR venti (8)
+.IM venti (7) ,
+.IM venti (8)
 .SH BUGS
 .I Buildindex
 should allow an individual index section to be rebuilt.
-- 
cgit v1.2.3


From d32deab17bfffa5bffc5fab3e6577558e40888c5 Mon Sep 17 00:00:00 2001
From: Russ Cox <rsc@swtch.com>
Date: Sat, 15 Aug 2020 20:07:38 -0400
Subject: tmac: rename IM (italic manual) to MR (manual reference)

Suggested by G. Brandon Robinson.
---
 man/man8/venti-fmt.8 | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

(limited to 'man/man8/venti-fmt.8')

diff --git a/man/man8/venti-fmt.8 b/man/man8/venti-fmt.8
index 19679ca0..39906862 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
-.IM venti (7)
+.MR venti (7)
 for an overview of the venti system and
-.IM 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
-.IM 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
-.IM 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
-.IM venti (7) ,
-.IM venti (8)
+.MR venti (7) ,
+.MR venti (8)
 .SH BUGS
 .I Buildindex
 should allow an individual index section to be rebuilt.
-- 
cgit v1.2.3