ARPUS/ce, Version 2.6.2 (03/10/05)    (SCCS 1.9)
_______________________________________________________________________________
 xp [-r [-a]] [-l] [-f <pathname> | <name>]
 "text paste"
 
 DESCRIPTION:
     'xp'  copies  text to the current or marked cursor position  from
     either  an internal paste buffer accessible from X selections, an
     internal  paste buffer that is local to the edit session, a named
     paste buffer in the paste buffer directory, or a text file.
     
     xp can be used in one of four ways:
     
     xp      
         Paste  text  from  the  default  paste  buffer  as defined by
         the  Ce.dfltPasteBuf  X  resource.   This   paste  buffer  is
         available  to other ce windows  and  to other X  applications
         using  the   X  selection mechanism.  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. This  file contains the text.
                             
     xp <name> 
         paste  text from the internal paste buffer with name  <name>.
         This  paste  buffer is available to other ce windows  and  to
         other  X  applications using the X selection mechanism  named
         <name>. 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. There are three special
         paste buffer names (BangIn, BangOut, and BangErr) used by the
         ! (bang) command that always use the paste buffer files.
                             
     xp -f <pathname> 
         paste text from an on-disk file.
     
     xp -l
         Paste  text  from  the  default  paste  buffer  as defined by
         the  Ce.dfltPasteBuf X resource.  Position the cursor at  the
         end  of  the  pasted  region  instead  of  at  the  point  of
         insertion.
     
 PARAMETERS
     -r      Do a rectangular paste.  A rectangular paste differs from
             a normal paste as follows: A normal paste inserts all the
             text  from  the  paste   buffer  at  the  current  cursor
             location.   This includes newlines.  A rectangular  paste
             inserts  the  first line of the paste buffer (up  to  the
             newline) at the current cursor position.  The position in
             the  cursor is then moved down one line from the original
             cursor  position and the next line of the paste buffer is
             inserted at that point. This is repeated for each line of
             the  paste buffer.  The file is extended at the bottom as
             necessary.

             An  example of the usefulness of rectangular paste can be
             seen  in  the following example.  Consider a file with  5
             columns  of numbers.  Each column is 200 lines long.   We
             desire  to move the second column of numbers and make  it
             the  fourth  column.  To do this, we mark  a  rectangular
             region  highlighting the second column of numbers and cut
             it.   We  then put the cursor on the first line over  the
             spot  we  wish to insert the column we just cut.  The  we
             execute  a  rectangular paste and the column is where  it
             belongs.

     -a      Specified  alone,  -a  does nothing in  the  xp  command.
             Specified  with -r, the -a option causes the paste to  be
             done in overstrike mode instead of insert mode. It covers
             up  characters.   This is useful for pasting data into  a
             predefined box.

     -f <path>
             Copy the  text from a file on the  machine  Ce  is
             executing  on.

     -l      The -l argument specifies that the cursor is to be placed
             at  the  end  of  the  pasted text  rather  than  at  the
             beginning.   This  option is ignored if  -r  (rectangular
             paste)  is specified.  Note that this option makes use of
             labels

      <name>
             Get data from the named X paste buffer.
     

 
 RELATED HELP FILES:
     !             (bang )            
     xc            (Copy )            
     xd            (Cut  )            
     xl            (Copy Literal)     
     xp            (Paste)            
     xa            (Concat Pastebuff) 
        
     regionsCon    (marking regions)  
     pastebufCon   (Paste buffers)    
     support       (customer support) 

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