xclipboard(1X)                                     xclipboard(1X)



NAME
     xclipboard - collects and makes available text selections

SYNOPSIS
     xclipboard [toolkit-option]...  [ { -w | -nw} ]

DESCRIPTION
     xclipboard collects and displays text selections that are
     sent to the CLIPBOARD by other clients.  It is typically
     used to save CLIPBOARD selections for later use. It stores
     each CLIPBOARD selection as a separate string, each of which
     can be selected. Each time another application asserts CLIP-
     BOARD, xclipboard transfers the contents of that selection
     to a new buffer and displays it in the text window. Buffers
     are never automatically deleted, so you'll want to use the
     Delete button to get rid of useless items.

     Because xclipboard uses a Text Widget to display the con-
     tents of the CLIPBOARD, text sent to the CLIPBOARD may be
     reselected for use in other applications.  The xclipboard
     client application also responds to requests for the CLIP-
     BOARD selection from other clients by sending the entire
     contents of the currently displayed buffer.

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

     -nw     Indicates that long lines of text should not wrap
             around to the following lines. This is the default.

     -w      Indicates that when lines of text that are too long
             to be displayed on one line in the CLIPBOARD, they
             should wrap around to the following lines.

   The xclipboard window
     An xclipboard window has these buttons across the top:

     Quit    Causes xclipboard to exit.

     Delete  Deletes the current buffer and displays the next
             buffer.

     New     Creates a new, empty buffer. This button is useful
             when constructing a new CLIPBOARD selection by hand.

     Next    Displays the next buffer in the list.

     Previous
             Displays the previous buffer.




November, 1990                                                  1

xclipboard(1X)                                     xclipboard(1X)



   Sending text to the CLIPBOARD
     Text is copied to the CLIPBOARD whenever a client asserts
     ownership of the CLIPBOARD selection. Text is copied from
     the CLIPBOARD whenever a client requests the contents of the
     CLIPBOARD selection.  Examples of CLIPBOARD event bindings
     that a user might wish to include in a resource configura-
     tion file are:

     *VT100.Translations: #override \
       <Btn3Up>:    select-end(CLIPBOARD) \n\
       <Btn2Up>:    insert-selection(PRIMARY,CLIPBOARD) \n\
       <Btn2Down>:  ignore ()

   Environment variables
     The xclipboard command uses these environment variables:

     DISPLAY Specifies the default host, display number, and
             screen.

     XENVIRONMENT
             Specifies the name of a resource file that overrides
             the global resources stored in the RESOURCE_MANAGER
             property.

FILES
     /usr/lib/X11/app-defaults/XClipboard
             Specifies required resources.

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

     Authors: Ralph R. Swick, DEC and MIT Project Athena; Chris
     D. Peterson, MIT X Consortium; and Keith Packard, MIT X Con-
     sortium

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

     Documentation of individual client applications for making a
     selection and sending it to the CLIPBOARD














2                                                  November, 1990