xcutsel(1X)                                           xcutsel(1X)



NAME
     xcutsel - manipulates the cut buffers

SYNOPSIS
     xcutsel [toolkit-option]...  [-selection selection]
     [-cutbuffer number]

DESCRIPTION
     xcutsel copies the current selection into a cut buffer and
     makes a selection that contains the current contents of the
     cut buffer.  It acts as a bridge between applications that
     do not support selections and those that do.

     By default, xcutsel uses the selection named PRIMARY and the
     cut buffer named CUT_BUFFER0.  Either or both of these can
     be overridden by command-line options or by resources.

   Options
     The xcutsel command accepts all the standard X Toolkit
     command-line options, as described in X(1X), as well as
     these options:

     -cutbuffer number
             Specifies which cut buffer to use.  The default is
             CUT_BUFFER0.

     -selection name
             Specifies the name of the selection to use.  The de-
             fault is PRIMARY.  The only supported abbreviations
             for this option are -select, -sel, and -s, because
             the standard X Toolkit option -selectionTimeout has
             a similar name.

   The xcutsel window
     An xcutsel window has these buttons:

     quit    Causes xcutsel to exit.  Any selections held by
             xcutsel are automatically released.

     copy PRIMARY to 0
             Copies the current selection into the cut buffer.

     copy 0 to PRIMARY
             Converts the current contents of the cut buffer into
             the selection.

     The button labels reflect the selection and cut buffer
     selected by command-line options or through the resource da-
     tabase.

     When the ``copy 0 to PRIMARY'' button is activated, the but-
     ton remains inverted as long as xcutsel remains the owner of



November, 1990                                                  1

xcutsel(1X)                                           xcutsel(1X)



     the selection.  This highlighting serves to remind you which
     client application owns the current selection.  Note that
     the value of the selection remains constant; if the cut
     buffer is changed, you must again activate the ``copy 0 to
     PRIMARY'' button to retrieve the new value when desired.

   X defaults
     The xcutsel client application accepts all the standard X
     Toolkit resource names and classes in addition to the fol-
     lowing:

     cutBuffer (class CutBuffer)
             Specifies the number of the cut buffer to use.  The
             default is CUT_BUFFER0.

     selection (class Selection)
             Specifies the name of the selection to use.  The de-
             fault is PRIMARY.

   Widget names
     The following instance names may be used when user confi-
     guration of the labels in them is desired:

     sel-cut (class Command)
             This is the ``copy SELECTION to BUFFER'' button.

     cut-sel (class Command)
             This is the ``copy BUFFER to SELECTION'' button.

     quit (class Command)
             This is the quit button.

LIMITATIONS
     There is no way to change the selection name or cut buffer
     number while xcutsel is running.

NOTES
     Copyright 1988, Massachusetts Institute of Technology.
     See X(1X) for a full statement of rights and permissions.

     Author: Ralph R. Swick, DEC and MIT Project Athena

SEE ALSO
     X(1X), xclipboard(1X), xterm(1X)

     Documentation of individual client applications for making a
     selection

     Chapter 5, ``Text Widgets,'' in Athena Widget Set - C
     Language Interface





2                                                  November, 1990