Import my usual \dash macro into all these man pages, and use it for
[sgt/utils] / xcopy / xcopy.but
index 8d79e48..e02bfcb 100644 (file)
@@ -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,7 +121,13 @@ 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}.
 
-\dt \cw{-T}
+\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
@@ -128,6 +136,24 @@ is taken away from it. Probably only useful when debugging
 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}
+
+\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