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/man3/venti.3 | 50 +++++++++++++++++++++++++-------------------------
 1 file changed, 25 insertions(+), 25 deletions(-)

(limited to 'man/man3/venti.3')

diff --git a/man/man3/venti.3 b/man/man3/venti.3
index 632d5998..368b70eb 100644
--- a/man/man3/venti.3
+++ b/man/man3/venti.3
@@ -15,61 +15,61 @@ This manual page describes general utility functions.
 .PP
 Other manual pages describe the library functions in detail.
 .PP
-.IR Venti-cache (3)
+.IM Venti-cache (3)
 describes a simple in-memory block cache to help clients.
 .PP
-.IR Venti-conn (3)
+.IM Venti-conn (3)
 describes routines for manipulating network connections
 between Venti clients and servers.
-.IR Venti-client (3)
+.IM Venti-client (3)
 and
-.IR venti-server (3)
+.IM venti-server (3)
 describe routines for writing clients
 and servers on top of these.
 .PP
-.IR Venti-fcall (3)
+.IM Venti-fcall (3)
 describes the C representation of Venti protocol messages
 and data structures.
 It also describes routines that convert between the C representation
 and the network and disk representations.
 .PP
-.IR Venti-file (3)
+.IM Venti-file (3)
 describes routines for writing clients that manipulate
 Venti file trees
 (see
-.IR venti (7)).
+.IM venti (7) ).
 .PP
-.IR Venti-log (3)
+.IM Venti-log (3)
 describes routines to access in-memory log buffers
 as well as the logging that is done automatically by
 the library.
 .PP
-.IR Venti-mem (3)
+.IM Venti-mem (3)
 describes wrappers around the canonical
-.IR malloc (3)
+.IM malloc (3)
 routines that abort on error.
 .PP
-.IR Venti-packet (3)
+.IM Venti-packet (3)
 describes routines for 
 manipulating zero-copy chains of
 data buffers.
 .PP
-.IR Venti-zero (3)
+.IM Venti-zero (3)
 describes routines to zero truncate and zero extend blocks
 (see
-.IR venti (7)).
+.IM venti (7) ).
 .SH SOURCE
 .B \*9/src/libventi
 .SH SEE ALSO
-.IR venti (1),
-.IR venti-cache (3),
-.IR venti-client (3),
-.IR venti-fcall (3),
-.IR venti-file (3)
-.IR venti-log (3),
-.IR venti-mem (3),
-.IR venti-packet (3),
-.IR venti-server (3),
-.IR venti-zero (3),
-.IR venti (7),
-.IR venti (8)
+.IM venti (1) ,
+.IM venti-cache (3) ,
+.IM venti-client (3) ,
+.IM venti-fcall (3) ,
+.IM venti-file (3)
+.IM venti-log (3) ,
+.IM venti-mem (3) ,
+.IM venti-packet (3) ,
+.IM venti-server (3) ,
+.IM venti-zero (3) ,
+.IM venti (7) ,
+.IM venti (8)
-- 
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/man3/venti.3 | 50 +++++++++++++++++++++++++-------------------------
 1 file changed, 25 insertions(+), 25 deletions(-)

(limited to 'man/man3/venti.3')

diff --git a/man/man3/venti.3 b/man/man3/venti.3
index 368b70eb..f5222fad 100644
--- a/man/man3/venti.3
+++ b/man/man3/venti.3
@@ -15,61 +15,61 @@ This manual page describes general utility functions.
 .PP
 Other manual pages describe the library functions in detail.
 .PP
-.IM Venti-cache (3)
+.MR Venti-cache (3)
 describes a simple in-memory block cache to help clients.
 .PP
-.IM Venti-conn (3)
+.MR Venti-conn (3)
 describes routines for manipulating network connections
 between Venti clients and servers.
-.IM Venti-client (3)
+.MR Venti-client (3)
 and
-.IM venti-server (3)
+.MR venti-server (3)
 describe routines for writing clients
 and servers on top of these.
 .PP
-.IM Venti-fcall (3)
+.MR Venti-fcall (3)
 describes the C representation of Venti protocol messages
 and data structures.
 It also describes routines that convert between the C representation
 and the network and disk representations.
 .PP
-.IM Venti-file (3)
+.MR Venti-file (3)
 describes routines for writing clients that manipulate
 Venti file trees
 (see
-.IM venti (7) ).
+.MR venti (7) ).
 .PP
-.IM Venti-log (3)
+.MR Venti-log (3)
 describes routines to access in-memory log buffers
 as well as the logging that is done automatically by
 the library.
 .PP
-.IM Venti-mem (3)
+.MR Venti-mem (3)
 describes wrappers around the canonical
-.IM malloc (3)
+.MR malloc (3)
 routines that abort on error.
 .PP
-.IM Venti-packet (3)
+.MR Venti-packet (3)
 describes routines for 
 manipulating zero-copy chains of
 data buffers.
 .PP
-.IM Venti-zero (3)
+.MR Venti-zero (3)
 describes routines to zero truncate and zero extend blocks
 (see
-.IM venti (7) ).
+.MR venti (7) ).
 .SH SOURCE
 .B \*9/src/libventi
 .SH SEE ALSO
-.IM venti (1) ,
-.IM venti-cache (3) ,
-.IM venti-client (3) ,
-.IM venti-fcall (3) ,
-.IM venti-file (3)
-.IM venti-log (3) ,
-.IM venti-mem (3) ,
-.IM venti-packet (3) ,
-.IM venti-server (3) ,
-.IM venti-zero (3) ,
-.IM venti (7) ,
-.IM venti (8)
+.MR venti (1) ,
+.MR venti-cache (3) ,
+.MR venti-client (3) ,
+.MR venti-fcall (3) ,
+.MR venti-file (3)
+.MR venti-log (3) ,
+.MR venti-mem (3) ,
+.MR venti-packet (3) ,
+.MR venti-server (3) ,
+.MR venti-zero (3) ,
+.MR venti (7) ,
+.MR venti (8)
-- 
cgit v1.2.3