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

20
man/man3/allocimage.3
View file

@ -135,7 +135,7 @@ The
field will have been set to the identifying number used by
.B /dev/draw
(see
.IR draw (3)),
.IM draw (3) ),
and the
.I cache
field will be zero.
@ -148,7 +148,7 @@ The
field will be set to the number of bits per pixel specified
by the channel descriptor
(see
.IR image (7)).
.IM image (7) ).
.I Allocimage
returns 0 if the server has run out of image memory.
.PP
@ -191,7 +191,7 @@ These routines permit unrelated applications sharing a display to share an image
for example they provide the mechanism behind
.B getwindow
(see
.IR graphics (3)).
.IM graphics (3) ).
.PP
The RGB values in a color are
.I premultiplied
@ -214,7 +214,7 @@ values between image and user space or external files.
There is a fixed format for the exchange and storage of
image data
(see
.IR image (7)).
.IM image (7) ).
.PP
.I Unloadimage
reads a rectangle of pixels from image
@ -271,7 +271,7 @@ but for
bytes of compressed image
.I data
(see
.IR image (7)).
.IM image (7) ).
On each call to
.IR cloadimage,
the
@ -289,7 +289,7 @@ return the number of bytes copied.
.PP
.I Readimage
creates an image from data contained in an external file (see
.IR image (7)
.IM image (7)
for the file format);
.I fd
is a file descriptor obtained by opening such a file for reading.
@ -333,10 +333,10 @@ To allocate a single-pixel replicated image that may be used to paint a region r
.SH SOURCE
.B \*9/src/libdraw
.SH "SEE ALSO"
.IR graphics (3),
.IR draw (3),
.IR draw (3),
.IR image (7)
.IM graphics (3) ,
.IM draw (3) ,
.IM draw (3) ,
.IM image (7)
.SH DIAGNOSTICS
These functions return pointer 0 or integer \-1 on failure, usually due to insufficient
memory.