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/cachechars.3 | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

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

diff --git a/man/man3/cachechars.3 b/man/man3/cachechars.3
index f2d82f19..95b172e9 100644
--- a/man/man3/cachechars.3
+++ b/man/man3/cachechars.3
@@ -30,7 +30,7 @@ A
 may contain too many characters to hold in memory
 simultaneously.
 The graphics library and draw device (see
-.IR draw (3))
+.IM draw (3) )
 cooperate to solve this problem by maintaining a cache of recently used
 character images.
 The details of this cooperation need not be known by most programs:
@@ -127,7 +127,7 @@ A
 .B Font
 consists of an overall height and ascent
 and a collection of subfonts together with the ranges of runes (see
-.IR utf (7))
+.IM utf (7) )
 they represent.
 Fonts are described by the following structures.
 .IP
@@ -181,7 +181,7 @@ The
 and
 .LR ascent
 fields of Font are described in
-.IR graphics (3).
+.IM graphics (3) .
 .L Sub
 contains
 .L nsub
@@ -302,12 +302,12 @@ for replacement when the cache is full.
 .SH SOURCE
 .B \*9/src/libdraw
 .SH SEE ALSO
-.IR graphics (3),
-.IR allocimage (3),
-.IR draw (3),
-.IR subfont (3),
-.IR image (7),
-.IR font (7)
+.IM graphics (3) ,
+.IM allocimage (3) ,
+.IM draw (3) ,
+.IM subfont (3) ,
+.IM image (7) ,
+.IM font (7)
 .SH DIAGNOSTICS
 All of the functions use the graphics error function (see
-.IR graphics (3)).
+.IM graphics (3) ).
-- 
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/cachechars.3 | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

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

diff --git a/man/man3/cachechars.3 b/man/man3/cachechars.3
index 95b172e9..1b2cc5b0 100644
--- a/man/man3/cachechars.3
+++ b/man/man3/cachechars.3
@@ -30,7 +30,7 @@ A
 may contain too many characters to hold in memory
 simultaneously.
 The graphics library and draw device (see
-.IM draw (3) )
+.MR draw (3) )
 cooperate to solve this problem by maintaining a cache of recently used
 character images.
 The details of this cooperation need not be known by most programs:
@@ -127,7 +127,7 @@ A
 .B Font
 consists of an overall height and ascent
 and a collection of subfonts together with the ranges of runes (see
-.IM utf (7) )
+.MR utf (7) )
 they represent.
 Fonts are described by the following structures.
 .IP
@@ -181,7 +181,7 @@ The
 and
 .LR ascent
 fields of Font are described in
-.IM graphics (3) .
+.MR graphics (3) .
 .L Sub
 contains
 .L nsub
@@ -302,12 +302,12 @@ for replacement when the cache is full.
 .SH SOURCE
 .B \*9/src/libdraw
 .SH SEE ALSO
-.IM graphics (3) ,
-.IM allocimage (3) ,
-.IM draw (3) ,
-.IM subfont (3) ,
-.IM image (7) ,
-.IM font (7)
+.MR graphics (3) ,
+.MR allocimage (3) ,
+.MR draw (3) ,
+.MR subfont (3) ,
+.MR image (7) ,
+.MR font (7)
 .SH DIAGNOSTICS
 All of the functions use the graphics error function (see
-.IM graphics (3) ).
+.MR graphics (3) ).
-- 
cgit v1.2.3