mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-12 11:10:07 +00:00
977b25a76a
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.
39 lines
728 B
Groff
39 lines
728 B
Groff
.TH GETSNARF 3
|
|
.SH NAME
|
|
getsnarf, putsnarf \- window system snarf (cut and paste) buffer
|
|
.SH SYNOPSIS
|
|
.B #include <draw.h>
|
|
.PP
|
|
.B
|
|
char *getsnarf(void)
|
|
.PP
|
|
.B
|
|
void putsnarf(char *text)
|
|
.SH DESCRIPTION
|
|
.I Getsnarf
|
|
and
|
|
.I putsnarf
|
|
access the window system's snarf (cut and paste) buffer.
|
|
.PP
|
|
.I Getsnarf
|
|
returns a copy of the current buffer;
|
|
the returned pointer should be freed with
|
|
.I free
|
|
(see
|
|
.IM malloc (3) )
|
|
when no longer needed.
|
|
.PP
|
|
.I Putsnarf
|
|
sets the buffer to the text string
|
|
.IR text .
|
|
.PP
|
|
Callers should assume that the snarf buffer is UTF.
|
|
If the window system does not keep the buffer in UTF,
|
|
.I getsnarf
|
|
and
|
|
.I putsnarf
|
|
will convert as necessary.
|
|
.SH SOURCE
|
|
.B \*9/src/libdraw/snarf.c
|
|
.SH SEE ALSO
|
|
.IM snarfer (1)
|