ARPUS/ce, Version 2.6.2 (03/10/05)    (SCCS 1.2)
_______________________________________________________________________________
 xa {-f <topathname> | [-l] <toname>} {-f <frompathname> | <fromname>}
 "Append one paste buffer to another"
 
 DESCRIPTION:
     'xa' appends the contents of one paste buffer to another. This is
     useful in building key definitions which build command files from
     parts.
     
 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 avoids any unwanted  interactions
             between  windows.   This  argument only applies  to  the.
             target (first) paste buffer
     
     -f <path>
             The  positional  argument  following -f is  a  path  name
             rather  than an X paste buffer name.  The -f argument can
             be  applied  to the first paste buffer name,  the  second
             paste buffer name, or both.

     <name>
             Name of the X paste buffer. The first name is the target.
             The  contents  of the second paste buffer is appended  to
             the first.
     
 EXAMPLES:
     The click on a file key definition (m3) could be written:

     kd m3   sic;/[^-a-zA-Z._@$0-9\\/\\\~]/dr;  ?[^-a-zA-Z._@$0-9\\/\\\\~]?;/./xc -l cv_file; xl -l cvcmd "cv '";xa -l cvcmd  cv_file;xl -l -a cvcmd "'";cmdf -p cvcmd ke


     A  more  typical example would be to use *m2 to grab a word  (The
     author  uses  this  as  his  normal m2)  and  then  use  the  key
     definition:

     kd ^1 xl -l rename "pn -";xa -l rename PRIMARY;cmdf -p rename ke

     This would allow you to grab the name of a file and then rename
     the current file to that name.


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

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