Give xcopy an option to talk to the GNOME/KDE-style clipboard as

[sgt/utils] / xcopy / xcopy.but

diff --git a/xcopy/xcopy.but b/xcopy/xcopy.but
index ba5bcac..6e485f8 100644 (file)
--- a/xcopy/xcopy.but
+++ b/xcopy/xcopy.but
@@ -1,19 +1,18 @@
 \cfg{man-identity}{xcopy}{1}{2004-08-02}{Simon Tatham}{Simon Tatham}
-\cfg{man-mindepth}{1}
 
-\C{xcopy-manpage} Man page for \cw{xcopy}
+\title Man page for \cw{xcopy}
 
-\H{xcopy-manpage-name} NAME
+\U NAME
 
 \cw{xcopy} - read and write text to/from an X selection from the
 command line
 
-\H{xcopy-manpage-synopsis} SYNOPSIS
+\U SYNOPSIS
 
 \c xcopy [ -r ] [ -u | -c ] [ -C ]
 \e bbbbb   bb     bb   bb     bb
 
-\H{xcopy-manpage-description} DESCRIPTION
+\U DESCRIPTION
 
 \cw{xcopy} is a command-line utility for manipulating the X selection.
 
@@ -42,7 +41,7 @@ of handling it in the form of plain text, UTF-8, or compound
 (multiple-character-set) text. Use the \cw{-u}, \cw{-c} and \cw{-C}
 options to control this aspect of its behaviour.
 
-\H{xcopy-manpage-options} OPTIONS
+\U OPTIONS
 
 By default (if \cw{-r} is not supplied), \cw{xcopy} operates in
 write mode.
@@ -91,7 +90,17 @@ window, you might well want to paste a string full of escape
 sequences and control characters, in which case you may need to use
 \cw{-C} to disable conversion to compound text.
 
-\H{xcopy-manpage-bugs} BUGS
+\dt \cw{-b}
+
+\dd Causes \cw{xcopy} to read or write the clipboard instead of the
+selection. (Modern GNOME and KDE-style programs can often interact
+with both. The \e{selection} is the traditional X-style storage
+location which you typically copy things into just by selecting them
+with the mouse, and paste with the middle mouse button. The
+\e{clipboard} is a more Windows-like location which you access using
+explicit Cut, Copy and Paste commands in your application.)
+
+\U BUGS
 
 Occasionally \cw{xcopy -r} completely fails to notice selection data
 owned by another process. I have not yet reproduced this reliably;
@@ -102,3 +111,10 @@ Automatic conversion between compound text and UTF-8 is not
 currently supported. There are Xlib functions to do it, although
 they don't appear to work very well (missing out many characters
 which they could have converted).
+
+\U LICENCE
+
+\cw{xcopy} is free software, distributed under the MIT licence. Type
+\cw{xcopy --licence} to see the full licence text.
+
+\versionid $Id$