ARPUS/ce, Version 2.6.2 (03/10/05)    (SCCS 1.9)
_______________________________________________________________________________
 [range] xc [-a] [-r] [-l] [-f <pathname> | <name>]
 "text copy"
 
 DESCRIPTION:
     'xc'  copies  a  range  of  text  into  either an internal paste buffer
     accessible from X selections, an internal paste buffer  that  is  local
     to   the   edit  session,  a  named  paste  buffer file in  the   paste
     buffer directory, or an text file.
     
     xc operates on a region of text that is either  explicitly  defined  or
     allowed  to default.  If no region is defined prior to invoking xc, the
     default region is from the current cursor position to the  end  of  the
     line. 
     
     Examples:
     
     xc                  Copy  the  effected region into the  default  paste
                         buffer   as  defined  by  the   Ce.dfltPasteBuf   X
                         resource.      The     -dpb   option     or     the
                         Ce.dfltPasteBuf  X  resource can be used to  change
                         this  name.   This  is often changed  to  the  name
                         PRIMARY.   PRIMARY is the name of the paste  buffer
                         used by xterm and many other X applications. If the
                         X selection is owned by a ce session when that edit
                         session  terminates, the paste buffer data is saved
                         in the paste buffer directory as a file.  After the
                         data  is saved in the paste buffer directory, it is
                         still   available   to   Ce  programs.    Other   X
                         applications will no longer be able to access it.
                         
     xc <name>           Copy  the  effected region into the internal  paste
                         buffer with name <name>. This operates exactly like
                         the default "xc", an arbitrary name can be specified
                         as  the buffer name.  There are three special paste
                         buffer names (BangIn, BangOut, and BangErr) used by
                         the  !  (bang) command, which always use the  paste
                         buffer files.
                         
     xc -f <pathname>    Copy the  effected  region into an on-disk file.


 PARAMETERS
     -l      Use a "local only" paste buffer. This works like a normal paste
             buffer  except that the X server does not get involved and  the
             contents  of  the  paste buffer are not saved in  a  file  upon
             termination. This improves performance and disables the copying
             of  data  between  different  windows.  It is  useful  for  cut
             commands which are throwing data away.
     
     -r      Treat  the  affected region as a rectangular region.   See  the
             'regions' help file mentioned below for an exact description of
             the behavior of rectangular regions.

     -a      Append mode.  Append the region being copied to the paste buffer.

     -f <path>
             Copy  the  affected  region into a file on the  machine  Ce  is
             executing  on.  Text copied to a file will probably not be able
             to  be  pasted  into a Ce window executing on  another  machine
             unless  that  machine has access to the file which  was  pasted
             into.

     <name>
             Copy to the named X paste buffer.
     
 
 RELATED HELP FILES:
     !             (bang )            
     xc            (Copy )            
     xd            (Cut  )            
     xl            (Copy Literal)     
     xp            (Paste)            
     xa            (Concat Pastebuff) 
     
     keyboard      (common keys)      
     regionsCon    (marking regions)  
     pastebufCon   (Paste buffers)    
     support       (customer support) 
     

_______________________________________________________________________________
  Copyright (c) 2005, Robert Styma Consulting.  All rights reserved.