commit - f2865ef6ab291b7c23254068d3f6554985bbf6aa
commit + 9c81b470c7469d0fff504fcdb247eb35e08f0066
blob - 1745634970f464095fa29a8a7ffa1d25193a9e74
blob + 6c236e76c4c3c5a8ac8ae28927980442a540ca09
--- man/man3/getsnarf.3
+++ man/man3/getsnarf.3
@@ -35,3 +35,17 @@ and
 will convert as necessary.
 .SH SOURCE
 .B \*9/src/libdraw/x11-itrans.c
+.SH SEE ALSO
+.IR snarfer (1)
+.SH BUGS
+On OS X, there are two snarf buffers: the Carbon snarf buffer
+used by native OS X applications, and the X11 snarf buffer,
+used by X11 applications.
+Whenever new text is written to the Carbon snarf buffer, the OS X X11
+implementation automatically copies that text to the X11 snarf buffer.
+The reverse is not done automatically, arguably a bug in the X11 server.
+To work around this,
+.I putsnarf
+writes to both the Carbon snarf buffer and the X11 snarf buffer.
+To work around this bug in remote or non-Plan 9 X11 clients, run
+.IR snarfer (1).