plan9port/man/man3/drawfcall.3
Russ Cox 977b25a76a 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.
2020-08-13 23:43:43 -04:00

53 lines
1 KiB
Groff

.TH DRAWFCALL 3
.SH NAME
convM2W, convW2M, drawfcallfmt, readwsysmsg, sizeW2M \- window system protocol
.SH SYNOPSIS
.nf
.PP
.ft L
#include <u.h>
#include <libc.h>
#include <draw.h>
#include <mouse.h>
#include <cursor.h>
#include <drawfcall.h>
.ft P
.ta \w'\fLuint 'u
.PP
.B
uint convM2W(uchar *ap, uint nap, Wsysmsg *w)
.PP
.B
uint convW2M(Wsysmsg *w, uchar *ap, uint nap)
.PP
.B
int drawfcallfmt(Fmt*)
.PP
.B
int readwsysmsg(int fd, uchar *buf, uint nbuf)
.PP
.B
uint sizeW2M(Wsysmsg *w)
.SH DESCRIPTION
These routines are analogues of the routines described in
.IM fcall (3) .
They manipulate graphics device protocol messages
rather than 9P protocol messages.
The graphics device protocol is used for internal
communication between the
.IM devdraw (1)
graphics server
and the
.IM draw (3)
library.
A
.B Wsysmsg
is the C structure corresponding to a protocol message.
.PP
The protocol is intentionally undocumented and may change.
.SH SOURCE
.B \*9/src/libdraw/drawfcall.c
.SH SEE ALSO
.IM devdraw (1) ,
.IM draw (3) ,
.IM graphics (3)