******************************************************************
copypseq - a macro used to copy all files related to a pulse sequence 
                to a new name. 
******************************************************************

copypseq  - copypseq(<'seqname1',>'seqname2') 
                where seqname1 is the rootname of an existing sequence 
                in ~/vnmrsys/psglib and seqname2 is the new sequence
                rootname. If seqname1 is omitted the 'seqfil is used 
                instead. Used in pulse-sequence development to 
                provide a starting sequence for editing in the 
                interface.
                
            *Sequence naming restriction - seqname1 should begin 
                 with a lowercase character and not resemble any parameter
                 name or command string found in the setup macro, parameter
                 file or protocol.xml file. A sequence with an invalid
                 name will copy with errors in the files seqname2_pars, 
                 Seqname2.pars and Seqname2.xml. 
                
             copypseq copys:
                seqname1.c to seqname2.c (sequence in ~/vnmrsys/psglib)
                seqname1_pars to seqname2_pars (setup macro in 
                    ~/vnmrsys/maclib)
                 - changes the sequence name in the macro*.
                Seqname1 to Seqname2 (protocol macro in ~/vnmrsys/maclib)
                Seqname1.par to Seqname2.par (parameter file in 
                   ~/vnmrsys/parlib)
                 - changes the sequence name in Seqname.par/procpar 
                   wherever found*. 
                seqname1 to seqname2 (manual file in ~/vnmrsys/manual)
                seqname1 to seqname2 (template directory in 
                   ~/vnmrsys/templates/layout) 
                Seqname1.xml to Seqname2.xml (protocol.xml file in 
                   ~/vnmrsys/templates/vnmrj/protocols)
                 - changes seqname1 and Seqname1 in Seqname1.xml 
                   wherever found*

             copypseq aborts if seqname1.c is not found and writes an 
                error to the text window if any other files of seqname
                are missing. 
                
             copypseq uses the macro capatilizestring
                
******************************************************************            

