xclipboard(X)                   19 June 1992                   xclipboard(X)


 Name

    xclipboard - X clipboard client

 Syntax

    xclipboard [ -toolkitoption ...] [-w] [-nw]

 Description

    The xclipboard program is used to collect and display 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 selec-
    tion as a separate string, each of which can be selected.  Each time
    CLIPBOARD is asserted by another application, 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.

    Since xclipboard uses a Text Widget to display the contents of the clip-
    board, text sent to the CLIPBOARD may be re-selected for use in other
    applications.  xclipboard also responds to requests for the CLIPBOARD
    selection from other clients by sending the entire contents of the
    currently displayed buffer.

    An xclipboard window has the following buttons across the top:

    quit     when this button is pressed, xclipboard exits

    delete   when this button is pressed, the current buffer is deleted and
             the next one displayed

    new      creates a new buffer with no contents,  useful in constructing a
             new CLIPBOARD selection by hand

    next     displays the next buffer in the list

    previous displays the previous buffer

 Options

    The xclipboard program accepts all of the standard X Toolkit command line
    options as well as the following:

    -w       This option indicates that lines of text that are too long to be
             displayed on one line in the clipboard should wrap around to the
             following lines.

    -nw      This option indicates that long lines of text should not wrap
             around.  This is the default behavior.

 Widgets

    In order to specify resources, it is useful to know the hierarchy of the
    widgets which compose xclipboard.  In the notation below, indentation
    indicates hierarchical structure.  The widget class name is given first,
    followed by the widget instance name.

    XClipboard   xclipboard
    Form         form
    Command      quit
    Command      delete
    Command      new
    Command      next
    Command      prev
    Text         text


 Sending/retrieving clipboard contents

    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
    event bindings that a user may wish to include in a resource configura-
    tion file to use the clipboard are:


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


 See also

    X(X), xcutsel(X), xterm(X), individual client documentation for how to
    make a selection and send it to the CLIPBOARD.

 Environment


    DISPLAY          to get the default host and display number.

    XENVIRONMENT     to get the name of a resource file that overrides the
                     global resources stored in the RESOURCEMANAGER pro-
                     perty.

 Files

    /usr/lib/X11/app-defaults/XClipboard - specifies required resources