home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / xclipboard.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  4.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XCLIPBOARD(1)                        XCLIPBOARD(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        xclipboard - X clipboard client
  9.  
  10. SSYYNNOOPPSSIISS
  11.        xxcclliippbbooaarrdd [ _-_t_o_o_l_k_i_t_o_p_t_i_o_n ... ] [ --ww ] [ --nnww ]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        The _x_c_l_i_p_b_o_a_r_d program is used to collect and display text
  15.        selections  that     are  sent  to    the  CLIPBOARD    by  other
  16.        clients.      It  is  typically used to save CLIPBOARD selec-
  17.        tions for later use.  It stores each  CLIPBOARD    selection
  18.        as a separate string, each of which can be selected.  Each
  19.        time CLIPBOARD is asserted by another application,  _x_c_l_i_p_-
  20.        _b_o_a_r_d  transfers     the  contents of that selection to a new
  21.        buffer and displays it in the text  window.   Buffers  are
  22.        never  automatically  deleted,  so  you'll want to use the
  23.        delete button to get rid of useless items.
  24.  
  25.        Since _x_c_l_i_p_b_o_a_r_d uses a Text Widget to  display    the  con-
  26.        tents  of the clipboard, text sent to the CLIPBOARD may be
  27.        re-selected for use  in    other  applications.   _x_c_l_i_p_b_o_a_r_d
  28.        also responds to requests for the CLIPBOARD selection from
  29.        other clients by sending the entire contents of    the  cur-
  30.        rently displayed buffer.
  31.  
  32.        An  _x_c_l_i_p_b_o_a_r_d window has the following buttons across the
  33.        top:
  34.  
  35.        _q_u_i_t    When this button is pressed, _x_c_l_i_p_b_o_a_r_d exits.
  36.  
  37.        _d_e_l_e_t_e  When this button is pressed, the current buffer is
  38.            deleted and the next one displayed.
  39.  
  40.        _n_e_w     Creates    a new buffer with no contents.    Useful in
  41.            constructing a new CLIPBOARD selection by hand.
  42.  
  43.        _s_a_v_e    Displays a File Save  dialog  box.   Pressing  the
  44.            Accept button saves the currently displayed buffer
  45.            to the file specified in the text field.
  46.  
  47.        _n_e_x_t    Displays the next buffer in the list.
  48.  
  49.        _p_r_e_v_i_o_u_s
  50.            Displays the previous buffer.
  51.  
  52. OOPPTTIIOONNSS
  53.        The _x_c_l_i_p_b_o_a_r_d program  accepts    all  of     the  standard    X
  54.        Toolkit command line options as well as the following:
  55.  
  56.        --ww      This  option indicates that lines of text that are
  57.            too long to be displayed on one line in the  clip-
  58.            board should wrap around to the following lines.
  59.  
  60.        --nnww     This  option  indicates    that  long  lines of text
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XCLIPBOARD(1)                        XCLIPBOARD(1)
  71.  
  72.  
  73.            should not  wrap     around.   This     is  the  default
  74.            behavior.
  75.  
  76. WWIIDDGGEETTSS
  77.        In  order  to  specify resources, it is useful to know the
  78.        hierarchy of the widgets which compose _x_c_l_i_p_b_o_a_r_d.  In the
  79.        notation     below, indentation indicates hierarchical struc-
  80.        ture.  The widget class name is given first,  followed  by
  81.        the widget instance name.
  82.  
  83.        XClipboard  xclipboard
  84.         Form  form
  85.          Command  Quit
  86.          Command  delete
  87.          Command  new
  88.          Command  Save
  89.          Command  next
  90.          Command  prev
  91.          Label    index
  92.          Text  text
  93.         TransientShell  fileDialogShell
  94.          Dialog     fileDialog
  95.               Label  label
  96.               Command  accept
  97.               Command  cancel
  98.               Text value
  99.         TransientShell  failDialogShell
  100.          Dialog     failDialog
  101.               Label  label
  102.               Command  continue
  103.  
  104.  
  105. SSEENNDDIINNGG//RREETTRRIIEEVVIINNGG CCLLIIPPBBOOAARRDD CCOONNTTEENNTTSS
  106.        Text  is copied to the clipboard whenever a client asserts
  107.        ownership of the CCLLIIPPBBOOAARRDD selection.  Text is copied from
  108.        the  clipboard  whenever a client requests the contents of
  109.        the CCLLIIPPBBOOAARRDD selection.     Examples of event bindings  that
  110.        a  user    may  wish  to include in a resource configuration
  111.        file to use the clipboard are:
  112.  
  113.        *VT100.Translations: #override \
  114.         <Btn3Up>:             select-end(CLIPBOARD) \n\
  115.         <Btn2Up>:             insert-selection(PRIMARY,CLIPBOARD) \n\
  116.         <Btn2Down>:             ignore ()
  117.  
  118.  
  119.  
  120. SSEEEE AALLSSOO
  121.        X(1), xcutsel(1), xterm(1), individual  client  documenta-
  122.        tion  for how to make a selection and send it to the CLIP-
  123.        BOARD.
  124.  
  125. EENNVVIIRROONNMMEENNTT
  126.        DDIISSPPLLAAYY to get the default host and display number.
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XCLIPBOARD(1)                        XCLIPBOARD(1)
  137.  
  138.  
  139.        XXEENNVVIIRROONNMMEENNTT
  140.            to get the name of a resource file that    overrides
  141.            the     global     resources    stored    in    the
  142.            RESOURCE_MANAGER property.
  143.  
  144. FFIILLEESS
  145.        <XRoot>/lib/X11/app-defaults/XClipboard      -    specifies
  146.        required resources
  147.  
  148. AAUUTTHHOORR
  149.        Ralph R. Swick, DEC/MIT Project Athena
  150.        Chris D. Peterson, MIT X Consortium
  151.        Keith Packard, MIT X Consortium
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.