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/netfiles.1 | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

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

diff --git a/man/man1/netfiles.1 b/man/man1/netfiles.1
index 69f519b1..11ab979d 100644
--- a/man/man1/netfiles.1
+++ b/man/man1/netfiles.1
@@ -21,7 +21,7 @@ Netfiles, netfileget, netfileput, netfilestat \- network file access inside acme
 .SH DESCRIPTION
 .B Netfiles
 presents remote file systems in
-.IR acme (4)
+.IM acme (4)
 windows.
 Each window is named
 .BI /n/ system / path
@@ -35,7 +35,7 @@ reads names of windows to create from the
 plumbing channel
 .B netfileedit
 (see
-.IR plumber (4)
+.IM plumber (4)
 and the example section below).
 In a
 .IR netfiles -controlled
@@ -60,13 +60,13 @@ The three first check to see if
 .I system
 is a service in the current name space
 (see
-.IR intro (4)).
+.IM intro (4) ).
 If so, they use
-.IR 9p (1)
+.IM 9p (1)
 to access it.
 Otherwise, they assume that the system is a network name
 and use
-.IR ssh (1)'s
+.IM ssh (1) 's
 .I sftp
 to access it.
 .PP
@@ -100,7 +100,7 @@ or
 .SH EXAMPLES
 The following plumbing rule 
 (see
-.IR plumb (7))
+.IM plumb (7) )
 passes 
 .B /n/
 paths to 
@@ -118,17 +118,17 @@ plumb client Netfiles
 .SH SOURCE
 .B \*9/src/cmd/netfiles
 .SH SEE ALSO
-.IR 9p (1),
-.IR ssh (1),
-.IR ssh-agent (1),
-.IR intro (4),
-.IR acme (4),
-.IR factotum (4),
+.IM 9p (1) ,
+.IM ssh (1) ,
+.IM ssh-agent (1) ,
+.IM intro (4) ,
+.IM acme (4) ,
+.IM factotum (4) ,
 .HR http://v9fs.sf.net
 .SH BUGS
 .I Netfiles
 depends on
-.IR sftpcache (1),
+.IM sftpcache (1) ,
 which only works with OpenSSH versions 4.3 and earlier;
 later versions do not print the
 .B sftp>
-- 
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/netfiles.1 | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

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

diff --git a/man/man1/netfiles.1 b/man/man1/netfiles.1
index 11ab979d..97f72c6f 100644
--- a/man/man1/netfiles.1
+++ b/man/man1/netfiles.1
@@ -21,7 +21,7 @@ Netfiles, netfileget, netfileput, netfilestat \- network file access inside acme
 .SH DESCRIPTION
 .B Netfiles
 presents remote file systems in
-.IM acme (4)
+.MR acme (4)
 windows.
 Each window is named
 .BI /n/ system / path
@@ -35,7 +35,7 @@ reads names of windows to create from the
 plumbing channel
 .B netfileedit
 (see
-.IM plumber (4)
+.MR plumber (4)
 and the example section below).
 In a
 .IR netfiles -controlled
@@ -60,13 +60,13 @@ The three first check to see if
 .I system
 is a service in the current name space
 (see
-.IM intro (4) ).
+.MR intro (4) ).
 If so, they use
-.IM 9p (1)
+.MR 9p (1)
 to access it.
 Otherwise, they assume that the system is a network name
 and use
-.IM ssh (1) 's
+.MR ssh (1) 's
 .I sftp
 to access it.
 .PP
@@ -100,7 +100,7 @@ or
 .SH EXAMPLES
 The following plumbing rule 
 (see
-.IM plumb (7) )
+.MR plumb (7) )
 passes 
 .B /n/
 paths to 
@@ -118,17 +118,17 @@ plumb client Netfiles
 .SH SOURCE
 .B \*9/src/cmd/netfiles
 .SH SEE ALSO
-.IM 9p (1) ,
-.IM ssh (1) ,
-.IM ssh-agent (1) ,
-.IM intro (4) ,
-.IM acme (4) ,
-.IM factotum (4) ,
+.MR 9p (1) ,
+.MR ssh (1) ,
+.MR ssh-agent (1) ,
+.MR intro (4) ,
+.MR acme (4) ,
+.MR factotum (4) ,
 .HR http://v9fs.sf.net
 .SH BUGS
 .I Netfiles
 depends on
-.IM sftpcache (1) ,
+.MR sftpcache (1) ,
 which only works with OpenSSH versions 4.3 and earlier;
 later versions do not print the
 .B sftp>
-- 
cgit v1.2.3