xwinclip.man (2765B)
1 .TH xwinclip 1 @xorgversion@ 2 .SH NAME 3 xwinclip - An X11 and Windows clipboard integration tool 4 5 .SH SYNOPSIS 6 .B xwinclip [OPTION]... 7 8 .SH DESCRIPTION 9 \fIxwinclip\fP is a tool for copying and pasting text between the Windows and X11 clipboard systems. 10 11 \fIxwinclip\fP watches for updates to either clipboard and copies data between them when either one is updated. 12 13 \fIxwinclip\fP monitors the X PRIMARY and CLIBPOARD selections for changes in ownership, and makes 14 the contents of the most recent one to change available to paste from the Windows clipboard. 15 16 It also monitors the contents of the Windows clipboard for changes, taking ownership of the PRIMARY and 17 CLIPBOARD selections, and making the contents of the Windows clipboard available in them. 18 19 .B Note well: 20 The \fIXWin(1)\fP X server has internal clipboard integration that is enabled by default. 21 Do \fINOT\fP run \fIxwinclip\fP unless \fIXWin(1)\fP has been started with the -noclipboard option. 22 23 .SH OPTIONS 24 \fIxwinclip\fP accepts the following optional command line switches: 25 26 .TP 8 27 .B \-display [display] 28 Specifies the X server display to connect to. 29 .TP 8 30 .B \-noprimary 31 Do not monitor the PRIMARY selection. 32 33 .SH "SEE ALSO" 34 XWin(1) 35 36 .SH BUGS 37 Only text clipboard contents are supported. 38 39 The INCR (Incremental transfer) clipboard protocol for clipboard contents larger than the maximum size of an X 40 request (approximately 256K) is only supported for X -> Windows clipboard transfers. 41 42 Some X clients, notably ones written in Tcl/Tk, do not re-assert ownership of the PRIMARY selection or update 43 its timestamp when its contents change, which currently prevents \fIxwinclip\fP from correctly noticing that 44 the PRIMARY selection's contents have changed. 45 46 Windows clipboard rendering is synchronous in the WM_RENDER*FORMAT message (that is, we must have placed the 47 contents onto the clipboard by the time we return from processing this message), but we must wait for the X 48 client which owns the selection to convert the selection to our requested format. This is currently achieved 49 using a fixed timeout. After requesting conversion of the selection, if no events are received from the X 50 client which owns the selection for one second, the conversion is assumed to have failed. 51 52 The XWin(1) server should indicate somehow (by placing an atom on the root window?) that it is running with its 53 internal clipboard integration enabled, and xwinclip should notice this and exit with an appropriate error. 54 55 Probably many other bugs. 56 57 .SH "CONFORMING TO" 58 ICCCM (Inter-Client Communication Conventions Manual) 2.0 59 60 .SH AUTHORS 61 Contributors to xwinclip include Benjamin Riefenstahl, Roland Cassard, Brian Genisio, Colin Harrison, 62 Harold L Hunt II, Matsuzaki Kensuke, Jon Turney, Chris Twiner and Jeremy Wilkins.