o5r/plan9port
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

tmac: introduce real manual reference macro instead of overloading IR

Browse source 
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
Download patch file Download diff file Expand all files Collapse all files

28
man/man3/subfont.3
View file

@ -53,13 +53,13 @@ Font* mkfont(Subfont *f, Rune min)
.SH DESCRIPTION
Subfonts are the components of fonts that hold the character images.
A font comprises an array of subfonts; see
.IR cachechars (3).
.IM cachechars (3) .
A new
.B Subfont
is allocated and initialized with
.IR allocsubfont .
See
.IR cachechars (3)
.IM cachechars (3)
for the meaning of
.IR n ,
.IR height ,
@ -81,7 +81,7 @@ The appropriate fields of the returned
structure are set to
the passed arguments, and the image is registered as a subfont
with the graphics device
.IR draw (3).
.IM draw (3) .
.I Allocsubfont
returns 0 on failure.
.PP
@ -97,7 +97,7 @@ on
if
.B f->info
was not allocated by
.IR malloc (3)
.IM malloc (3)
it should be zeroed before calling
.IR subffree .
.PP
@ -150,7 +150,7 @@ Although it is principally a routine internal to the library,
may be substituted by the application to provide a less file-oriented subfont naming scheme.
.PP
The format of a subfont file is described in
.IR font (7).
.IM font (7) .
Briefly, it contains a image with all the characters in it,
followed by a subfont header, followed by character information.
.I Readsubfont
@ -181,13 +181,13 @@ the part of a subfont file that comes after the image. It should be preceded by
a call to
.IR writeimage
(see
.IR allocimage (3)).
.IM allocimage (3) ).
.PP
.I Stringsubfont
is analogous to
.B string
(see
.IR draw (3))
.IM draw (3) )
for subfonts. Rather than use the underlying font caching primitives,
it calls
.B draw
@ -224,12 +224,12 @@ bitmap font file tree
.SH SOURCE
.B \*9/src/libdraw
.SH SEE ALSO
.IR graphics (3),
.IR allocimage (3),
.IR draw (3),
.IR cachechars (3),
.IR image (7),
.IR font (7)
.IM graphics (3) ,
.IM allocimage (3) ,
.IM draw (3) ,
.IM cachechars (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) ).