


XCLIPBOARD(1)            USER COMMANDS              XCLIPBOARD(1)



NAME
     xclipboard - X clipboard client

SYNOPSIS
     xclipboard [ -_t_o_o_l_k_i_t_o_p_t_i_o_n ...] [-w] [-nw]

DESCRIPTION
     The _x_c_l_i_p_b_o_a_r_d 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, _x_c_l_i_p_b_o_a_r_d 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 _x_c_l_i_p_b_o_a_r_d 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.   _x_c_l_i_p_b_o_a_r_d  also
     responds  to requests for the CLIPBOARD selection from other
     clients by sending the  entire  contents  of  the  currently
     displayed buffer.

     An _x_c_l_i_p_b_o_a_r_d window has the following  buttons  across  the
     top:

     _q_u_i_t    When this button is pressed, _x_c_l_i_p_b_o_a_r_d exits.

     _d_e_l_e_t_e  When this button is pressed, the current  buffer  is
             deleted and the next one displayed.

     _n_e_w     Creates a new buffer with no  contents.   Useful  in
             constructing a new CLIPBOARD selection by hand.

     _n_e_x_t    Displays the next buffer in the list.

     _p_r_e_v_i_o_u_s
             Displays the previous buffer.

OPTIONS
     The _x_c_l_i_p_b_o_a_r_d 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 clip-
             board 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.




X Version 11         Last change: Release 4                     1






XCLIPBOARD(1)            USER COMMANDS              XCLIPBOARD(1)



WIDGETS
     In order to specify resources, it  is  useful  to  know  the
     hierarchy  of  the widgets which compose _x_c_l_i_p_b_o_a_r_d.  In the
     notation below, indentation  indicates  hierarchical  struc-
     ture.  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 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.




X Version 11         Last change: Release 4                     2






XCLIPBOARD(1)            USER COMMANDS              XCLIPBOARD(1)



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



















































X Version 11         Last change: Release 4                     3



