XCLIPBOARD(1)               X Version 11(Release 5)               XCLIPBOARD(1)


NAME
      xclipboard - X clipboard client

SYNOPSIS
      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
      selection 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
      clipboard, 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,


10/89                                                                    Page 1

XCLIPBOARD(1)               X Version 11(Release 5)               XCLIPBOARD(1)


      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
      configuration file to use the clipboard are:

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



SEE ALSO
      X(1), xcutsel(1), xterm(1), 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 RESOURCE_MANAGER property.

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

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

AUTHOR
      Ralph R. Swick, DEC/MIT Project Athena
      Chris D. Peterson, MIT X Consortium
      Keith Packard, MIT X Consortium






Page 2                                                                    10/89