diff options
Diffstat (limited to 'man/xcutsel.man')
-rw-r--r-- | man/xcutsel.man | 106 |
1 files changed, 106 insertions, 0 deletions
diff --git a/man/xcutsel.man b/man/xcutsel.man new file mode 100644 index 0000000..c122872 --- /dev/null +++ b/man/xcutsel.man @@ -0,0 +1,106 @@ +.\" Copyright 1994, 1998 The Open Group +.\" +.\" Permission to use, copy, modify, distribute, and sell this software and its +.\" documentation for any purpose is hereby granted without fee, provided that +.\" the above copyright notice appear in all copies and that both that +.\" copyright notice and this permission notice appear in supporting +.\" documentation. +.\" +.\" The above copyright notice and this permission notice shall be included +.\" in all copies or substantial portions of the Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR +.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +.\" OTHER DEALINGS IN THE SOFTWARE. +.\" +.\" Except as contained in this notice, the name of The Open Group shall +.\" not be used in advertising or otherwise to promote the sale, use or +.\" other dealings in this Software without prior written authorization +.\" from The Open Group. +.\" +.\" +.TH XCUTSEL 1 __xorgversion__ +.SH NAME +xcutsel - interchange between cut buffer and selection +.SH SYNOPSIS +\fBxcutsel\fP [ \fI-toolkitoption\fP ...] [-selection \fIselection\fP] [-cutbuffer \fInumber\fP] +.SH DESCRIPTION +The \fIxcutsel\fP program is used to copy the current selection into a +cut buffer and to make a selection that contains the current contents of +the cut buffer. It acts as a bridge between applications that don't support +selections and those that do. +.PP +By default, \fIxcutsel\fP will use the selection named PRIMARY and the cut +buffer CUT_BUFFER0. Either or both of these can be overridden by command +line arguments or by resources. +.PP +An \fIxcutsel\fP window has the following buttons: +.TP 8 +.I " quit" +When this button is pressed, \fIxcutsel\fP exits. Any selections held by +\fIxcutsel\fP are automatically released. +.TP 8 +.I " copy PRIMARY to 0" +When this button is pressed, \fIxcutsel\fP copies the current selection into +the cut buffer. +.TP 8 +.I " copy 0 to PRIMARY" +When this button is pressed, \fIxcutsel\fP converts the current contents of +the cut buffer into the selection. +.PP +The button labels reflect the selection and cutbuffer selected by +command line options or through the resource database. +.PP +When the ``copy 0 to PRIMARY'' button is activated, the button will +remain inverted as long as \fIxcutsel\fP remains the owner of the +selection. This serves to remind you which client owns the current +selection. Note that the value of the selection remains constant; +if the cutbuffer is changed, you must again activate the copy button +to retrieve the new value when desired. +.SH OPTIONS +.I Xcutsel +accepts all of the standard X Toolkit command line options as well as the +following: +.TP 8 +.B \-selection \fIname\fP +This option specifies the name of the selection to use. The default is +PRIMARY. The only supported abbreviations for this option are ``-select'', +``-sel'' and ``-s'', as the standard toolkit option ``-selectionTimeout'' has a +similar name. +.TP 8 +.B \-cutbuffer \fInumber\fP +This option specifies the cut buffer to use. The default is cut buffer 0. +.SH X DEFAULTS +This program accepts all of the standard X Toolkit resource names and classes +as well as: +.TP 8 +.B "selection (\fPclass\fB Selection)" +This resource specifies the name of the selection to use. The default is +PRIMARY. +.TP 8 +.B "cutBuffer (\fPclass\fB CutBuffer)" +This resource specifies the number of the cut buffer to use. The default is 0. +.SH WIDGET NAMES +The following instance names may be used when user configuration of the +labels in them is desired: +.TP 8 +.B "sel-cut (\fPclass\fB Command)" +This is the ``copy SELECTION to BUFFER'' button. +.TP 8 +.B "cut-sel (\fPclass\fB Command)" +This is the ``copy BUFFER to SELECTION'' button. +.TP 8 +.B "quit (\fPclass\fB Command)" +This is the ``quit'' button. +.SH "SEE ALSO" +X(__miscmansuffix__), xclipboard(__appmansuffix__), xterm(__appmansuffix__), text widget documentation, individual client +documentation for how to make a selection. +.SH BUGS +There is no way to change the name of the selection or the number of the +cut buffer while the program is running. +.SH AUTHOR +Ralph R. Swick, DEC/MIT Project Athena |