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/man1/acmeevent.1 | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

(limited to 'man/man1/acmeevent.1')

diff --git a/man/man1/acmeevent.1 b/man/man1/acmeevent.1
index d5ff0830..52e6d60b 100644
--- a/man/man1/acmeevent.1
+++ b/man/man1/acmeevent.1
@@ -61,7 +61,7 @@ acmeevent, acme.rc \- shell script support for acme clients
 and
 .I acme.rc
 make it easy to write simple
-.IR acme (1)
+.IM acme (1)
 client programs as shell scripts.
 .PP
 .I Acme
@@ -69,14 +69,14 @@ clients read the
 .B event
 files 
 (see
-.IR acme (4))
+.IM acme (4) )
 for the windows they control, reacting to the events.
 The events are presented in a format that is easy to read with C programs
 but hard to read with shell scripts.
 .PP
 .I Acmeevent
 reads an
-.IR acme (4)
+.IM acme (4)
 event stream from standard input, printing a shell-friendly
 version of the events, one per line, on standard output.
 Each output line from
@@ -165,7 +165,7 @@ above);
 below).
 .I Flag
 remains from the
-.IR acme (4)
+.IM acme (4)
 event format.
 Because
 .IR eq0 ,
@@ -174,7 +174,7 @@ and
 .I chordarg
 are explicit in each event
 (unlike in
-.IR acme (4)
+.IM acme (4)
 events),
 .I flag
 can usually be ignored.
@@ -221,7 +221,7 @@ window.
 .PP
 .I Acme.rc
 is a library of
-.IR rc (1)
+.IM rc (1)
 shell functions useful for writing acme clients.
 .PP
 .I Newwindow
@@ -259,14 +259,14 @@ The most commonly-used command is
 .BR clean ,
 which marks the window as clean.
 See
-.IR acme (4)
+.IM acme (4)
 for a full list of commands.
 .PP
 .I Windump
 sets the window's dump directory
 and dump command
 (see
-.IR acme (4)).
+.IM acme (4) ).
 If either argument is omitted or is
 .BR - ,
 that argument is not set.
@@ -381,9 +381,9 @@ for the full implementation.
 .br
 .B \*9/lib/acme.rc
 .SH SEE ALSO
-.IR acme (1),
-.IR acme (4),
-.IR rc (1)
+.IM acme (1) ,
+.IM acme (4) ,
+.IM rc (1)
 .SH BUGS
 There is more that could be done to ease the writing
 of complicated clients.
-- 
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/man1/acmeevent.1 | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

(limited to 'man/man1/acmeevent.1')

diff --git a/man/man1/acmeevent.1 b/man/man1/acmeevent.1
index 52e6d60b..24fde4f5 100644
--- a/man/man1/acmeevent.1
+++ b/man/man1/acmeevent.1
@@ -61,7 +61,7 @@ acmeevent, acme.rc \- shell script support for acme clients
 and
 .I acme.rc
 make it easy to write simple
-.IM acme (1)
+.MR acme (1)
 client programs as shell scripts.
 .PP
 .I Acme
@@ -69,14 +69,14 @@ clients read the
 .B event
 files 
 (see
-.IM acme (4) )
+.MR acme (4) )
 for the windows they control, reacting to the events.
 The events are presented in a format that is easy to read with C programs
 but hard to read with shell scripts.
 .PP
 .I Acmeevent
 reads an
-.IM acme (4)
+.MR acme (4)
 event stream from standard input, printing a shell-friendly
 version of the events, one per line, on standard output.
 Each output line from
@@ -165,7 +165,7 @@ above);
 below).
 .I Flag
 remains from the
-.IM acme (4)
+.MR acme (4)
 event format.
 Because
 .IR eq0 ,
@@ -174,7 +174,7 @@ and
 .I chordarg
 are explicit in each event
 (unlike in
-.IM acme (4)
+.MR acme (4)
 events),
 .I flag
 can usually be ignored.
@@ -221,7 +221,7 @@ window.
 .PP
 .I Acme.rc
 is a library of
-.IM rc (1)
+.MR rc (1)
 shell functions useful for writing acme clients.
 .PP
 .I Newwindow
@@ -259,14 +259,14 @@ The most commonly-used command is
 .BR clean ,
 which marks the window as clean.
 See
-.IM acme (4)
+.MR acme (4)
 for a full list of commands.
 .PP
 .I Windump
 sets the window's dump directory
 and dump command
 (see
-.IM acme (4) ).
+.MR acme (4) ).
 If either argument is omitted or is
 .BR - ,
 that argument is not set.
@@ -381,9 +381,9 @@ for the full implementation.
 .br
 .B \*9/lib/acme.rc
 .SH SEE ALSO
-.IM acme (1) ,
-.IM acme (4) ,
-.IM rc (1)
+.MR acme (1) ,
+.MR acme (4) ,
+.MR rc (1)
 .SH BUGS
 There is more that could be done to ease the writing
 of complicated clients.
-- 
cgit v1.2.3