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

@ -19,14 +19,14 @@ mhtml \- macros for formatting HTML
\&...
.SH DESCRIPTION
This package of
.IR htmlroff (1)
.IM htmlroff (1)
macro definitions provides convenient macros for formatting HTML.
It is usually used along with
.IR troff (1)
.IM troff (1)
macro packages such as
.IR man (7)
.IM man (7)
and
.IR ms (7).
.IM ms (7) .
.I Mhtml
replaces some macros defined in the other packages,
so it should be listed after them on the
@ -64,7 +64,7 @@ before invoking
Accumulate footnotes and print them at the end of the
document under a \fBNotes\fP heading.
These replace the macros in
.IR ms (7).
.IM ms (7) .
To emit the notes accumulated so far, invoke
.BR .NOTES .
.TP
@ -75,7 +75,7 @@ and
.B .PE
with a PNG image corresponding to the output of
running
.IR troff (1)
.IM troff (1)
on the input.
.TP
.B .TS\fR, \fP.TE
@ -100,6 +100,6 @@ percent of the current output width.
.SH FILES
.B \*9/tmac/tmac.html
.SH SEE ALSO
.IR htmlroff (1),
.IR htmlroff (7),
.IR ms (7)
.IM htmlroff (1) ,
.IM htmlroff (7) ,
.IM ms (7)