RENAME
------

Format:        RENAME filespec [/H] filename
                           or
               REN filespec [/H] filename

Purpose:       Renames one or more files.

Use:           The  filespec specifies the files that are  to 
          be  renamed,  and  /H  allows hidden  files  to  be 
          included in the operation.

               The  filename specifies the new name that  the 
          files  will  be  given.  A  '?'  in  the  new  name 
          indicates  that  one character will be copied  from 
          the  old name into the new name at the position  of 
          the '?' (a '*' just being a series of '?').

               If the new filename for any of the files being 
          renamed already exists,  or is an invalid filename, 
          then  the  rename operation stops and an  error  is 
          returned.

Examples:

     RENAME FRED WOMBAT

               The  file  FRED  is renamed  to  the  filename 
          WOMBAT.


     REN B:\SOURCE\*.MAC/H *.OLD

               All  files  with  the  extension  MAC  in  the 
          directory  \SOURCE on drive  B:,  including  hidden 
          files, are renamed with an extension of OLD.
