\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
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
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
they don't appear to work very well (missing out many characters
which they could have converted).
-The selection timestamps output by \cw{xcopy} in write mode are
-always zero, which is not ideal.
-
\U LICENCE
\cw{xcopy} is free software, distributed under the MIT licence. Type