man-pages/man1/xcutsel.1.html
2021-03-31 01:06:50 +01:00

152 lines
4.6 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of XCUTSEL</TITLE>
</HEAD><BODY>
<H1>XCUTSEL</H1>
Section: User Commands (1)<BR>Updated: xclipboard 1.1.3<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
xcutsel - interchange between cut buffer and selection
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>xcutsel</B> [ <I>-toolkitoption</I> ...] [-selection <I>selection</I>] [-cutbuffer <I>number</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
The <I>xcutsel</I> 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.
<P>
By default, <I>xcutsel</I> 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.
<P>
An <I>xcutsel</I> window has the following buttons:
<DL COMPACT>
<DT id="1"><I> quit</I>
<DD>
When this button is pressed, <I>xcutsel</I> exits. Any selections held by
<I>xcutsel</I> are automatically released.
<DT id="2"><I> copy PRIMARY to 0</I>
<DD>
When this button is pressed, <I>xcutsel</I> copies the current selection into
the cut buffer.
<DT id="3"><I> copy 0 to PRIMARY</I>
<DD>
When this button is pressed, <I>xcutsel</I> converts the current contents of
the cut buffer into the selection.
</DL>
<P>
The button labels reflect the selection and cutbuffer selected by
command line options or through the resource database.
<P>
When the ``copy 0 to PRIMARY'' button is activated, the button will
remain inverted as long as <I>xcutsel</I> 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.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<I>Xcutsel</I>
accepts all of the standard X Toolkit command line options as well as the
following:
<DL COMPACT>
<DT id="4"><B>-selection </B><I>name</I>
<DD>
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.
<DT id="5"><B>-cutbuffer </B><I>number</I>
<DD>
This option specifies the cut buffer to use. The default is cut buffer 0.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>X DEFAULTS</H2>
This program accepts all of the standard X Toolkit resource names and classes
as well as:
<DL COMPACT>
<DT id="6"><B>selection (</B>class<B> Selection)</B>
<DD>
This resource specifies the name of the selection to use. The default is
PRIMARY.
<DT id="7"><B>cutBuffer (</B>class<B> CutBuffer)</B>
<DD>
This resource specifies the number of the cut buffer to use. The default is 0.
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>WIDGET NAMES</H2>
The following instance names may be used when user configuration of the
labels in them is desired:
<DL COMPACT>
<DT id="8"><B>sel-cut (</B>class<B> Command)</B>
<DD>
This is the ``copy SELECTION to BUFFER'' button.
<DT id="9"><B>cut-sel (</B>class<B> Command)</B>
<DD>
This is the ``copy BUFFER to SELECTION'' button.
<DT id="10"><B>quit (</B>class<B> Command)</B>
<DD>
This is the ``quit'' button.
</DL>
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?7+X">X</A>(7), <A HREF="/cgi-bin/man/man2html?1+xclipboard">xclipboard</A>(1), <A HREF="/cgi-bin/man/man2html?1+xterm">xterm</A>(1), text widget documentation, individual client
documentation for how to make a selection.
<A NAME="lbAI">&nbsp;</A>
<H2>BUGS</H2>
There is no way to change the name of the selection or the number of the
cut buffer while the program is running.
<A NAME="lbAJ">&nbsp;</A>
<H2>AUTHOR</H2>
Ralph R. Swick, DEC/MIT Project Athena
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="11"><A HREF="#lbAB">NAME</A><DD>
<DT id="12"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="13"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="14"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="15"><A HREF="#lbAF">X DEFAULTS</A><DD>
<DT id="16"><A HREF="#lbAG">WIDGET NAMES</A><DD>
<DT id="17"><A HREF="#lbAH">SEE ALSO</A><DD>
<DT id="18"><A HREF="#lbAI">BUGS</A><DD>
<DT id="19"><A HREF="#lbAJ">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:30 GMT, March 31, 2021
</BODY>
</HTML>