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.
This commit is contained in:
Russ Cox 2020-08-13 23:41:59 -04:00
parent a1c4307800
commit 977b25a76a
297 changed files with 1790 additions and 1774 deletions

View file

@ -95,7 +95,7 @@ CFsys* nsamount(char *name, char *aname);
.SH DESCRIPTION
.PP
This library, in concert with
.IR factotum (4),
.IM factotum (4) ,
is used to authenticate users.
It provides the primary interface to
.IR factotum .
@ -168,7 +168,7 @@ It provides the primary interface to
The following routines use the
.B AuthInfo
structure returned after a successful authentication by
.IR factotum (4).
.IM factotum (4) .
.PP
.ne 8
.EX
@ -212,11 +212,11 @@ file, as opened by
An
.B sprint
(see
.IR print (3))
.IM print (3) )
of
.I fmt
and the variable arg list yields a key template (see
.IR factotum (4))
.IM factotum (4) )
specifying the key to use.
The template must specify at least the protocol (
.BI proto= xxx )
@ -258,7 +258,7 @@ arranges a connection to
either by opening
.B /mnt/factotum/rpc
or by using
.IR 9pclient (3)
.IM 9pclient (3)
to connect to a
.B factotum
service posted in the current name space.
@ -266,7 +266,7 @@ The returned connection
is freed using
.IR auth_freerpc .
Individual commands can be sent to
.IR factotum (4)
.IM factotum (4)
by invoking
.IR auth_rpc .
.PP
@ -418,7 +418,7 @@ and
but execute the protocol on a
.B CFid*
(see
.IR 9pclient (3))
.IM 9pclient (3) )
instead of a file descriptor.
.PP
.I Fsamount
@ -429,15 +429,15 @@ are like
and
.I nsmount
(see
.IR 9pclient (3))
.IM 9pclient (3) )
but use
.I factotum
to authenticate to the file servers.
.SH SOURCE
.B \*9/src/libauth
.SH SEE ALSO
.IR factotum (4),
.IR authsrv (3)
.IM factotum (4) ,
.IM authsrv (3)
.SH DIAGNOSTICS
These routines set
.IR errstr .