10564b1175
groff 1.23.0 added .MR to its -man macro package. The NEWS file states
that the inclusion of the macro "was prompted by its introduction to
Plan 9 from User Space's troff in August 2020." From d32deab it seems
that the name for Plan 9 from User Space's implementation was suggested
by groff maintainer G. Brandon Robinson.
Not sure if the intention was to make these definitions compatible, but
it would be nice if they were.
Currently, Plan 9 from User Space's .MR expects its second argument to
be parenthesized. groff's .MR does not. This results in extra
parentheses appearing in manual references when viewing Plan 9 from User
Space's manual pages on a system using groff.
50 lines
1.0 KiB
Groff
50 lines
1.0 KiB
Groff
.TH SNARFER 1
|
|
.SH NAME
|
|
snarfer \- manage the snarf buffer
|
|
.SH SYNOPSIS
|
|
.B snarfer
|
|
[
|
|
.B -v
|
|
]
|
|
.SH DESCRIPTION
|
|
.I Snarfer
|
|
watches the snarf buffer for changes.
|
|
Each time a program changes the snarf buffer contents,
|
|
.I snarfer
|
|
copies the new contents and then takes over control
|
|
of the buffer.
|
|
Because the snarf buffer contents are managed by
|
|
.I snarfer
|
|
instead of by individual programs, the contents remain
|
|
available even after the program that wrote them exits.
|
|
.PP
|
|
The
|
|
.B -v
|
|
option, intended for debugging, causes
|
|
.I snarfer
|
|
to print the new snarf buffer contents each time it changes.
|
|
.PP
|
|
On Mac OS X,
|
|
running
|
|
.I snarfer
|
|
keeps the X11 snarf buffer in sync with the Carbon snarf buffer,
|
|
working around a bug in the OS X X11 server.
|
|
See
|
|
.MR getsnarf 3
|
|
for more details.
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/snarfer
|
|
.SH SEE ALSO
|
|
Unix's
|
|
.IR xclipboard (1),
|
|
.MR getsnarf 3
|
|
.SH BUGS
|
|
Both
|
|
.I xclipboard
|
|
and
|
|
.I snarfer
|
|
want sole control of the snarf buffer.
|
|
Running both at the same time will
|
|
pass the snarf buffer back and forth between them
|
|
in an infinite loop.
|