Import my usual \dash macro into all these man pages, and use it for

[sgt/utils] / xcopy / xcopy.but

diff --git a/xcopy/xcopy.but b/xcopy/xcopy.but
index 912ae72..e02bfcb 100644 (file)
--- a/xcopy/xcopy.but
+++ b/xcopy/xcopy.but
@@ -1,10 +1,12 @@
 \cfg{man-identity}{xcopy}{1}{2004-08-02}{Simon Tatham}{Simon Tatham}
 
+\define{dash} \u2013{-}
+
 \title Man page for \cw{xcopy}
 
 \U NAME
 
-\cw{xcopy} - read and write text to/from an X selection from the
+\cw{xcopy} \dash read and write text to/from an X selection from the
 command line
 
 \U SYNOPSIS
@@ -119,12 +121,40 @@ debugging X applications or X selection issues.
 contents corresponding to some particular user-specified target
 type. The target type can be anything listed by \cq{xcopy -r -t}.
 
-\U BUGS
+\dt \cw{-v}
+
+\dd Causes \cw{xcopy}, in read mode only, to produce a verbose
+commentary on the progress of reading the X selection. Can be useful
+for debugging interactions with other programs.
+
+\dt \cw{-F}
+
+\dd Causes \cw{xcopy} not to fork, when in write mode. Instead the
+original \cw{xcopy} process will continue to run until the selection
+is taken away from it. Probably only useful when debugging
+\cw{xcopy} itself, although it's just possible that it might turn
+out to be useful for some other special purpose (e.g. having the
+process waiting for it know when the selection owner has changed).
+
+\dt \cw{-d} \e{size}
 
-Occasionally \cw{xcopy -r} completely fails to notice selection data
-owned by another process. I have not yet reproduced this reliably;
-if anyone can, some work with \cw{xmon}(1) would be much
-appreciated...
+\dd Alters the maximum size of data transferred in one lump by
+\cw{xcopy}. (Probably most useful for diagnostic purposes.)
+
+\dt \cw{-I}
+
+\dd Inhibits \cw{xcopy}, in write mode, from using the \cw{INCR}
+mechanism for transferring large amounts of selection data a piece at
+a time and waiting for the recipient to acknowledge each chunk before
+sending the next. (Just in case a client doesn't support it.)
+
+\dt \cw{-B}
+
+\dd Inhibits \cw{xcopy}, in write mode, from storing its data in the
+persistent \q{cut buffers} on the root window as well as using the
+peer-to-peer selection mechanism.
+
+\U BUGS
 
 Automatic conversion between compound text and UTF-8 is not
 currently supported. There are Xlib functions to do it, although