;
                                 RENAME.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
RENAME.CIM     4k (29)   10BB  3.4        Gene Pizzetta 4/90       Z3COM10
RENAME.COM     4k (29)   C2D6  3.4        Gene Pizzetta 4/90       Z3COM10

  1- Syntax/Options  2- Notes  3- Examples of use                             


   RENAME is  a transient program for renaming files.  More powerful than REN,
RENAME allows ambiguous  file names and inspection.  Vs 3.0 (5/84) by R. Conn.
:1

   Syntax   RENAME dir:afn1=afn2,dir:afn3=afn4,... [/]o

        or  RENAME dir:afn2 afn1,dir:afn4 afn3,... [/]o

        or  RENAME dir:afn,dir:afn1=afn2,,dir:afn4 afn3... [/]o

   The first form shows elements of the CP/M style form (dir:afn1=afn2).   The 
second  form  shows elements of the MS-DOS style form  (dir:afn2  afn1).   The 
third form adds an element of the single-filespec form (dir:afn), which is the 
same  as  the completely pointless 'dir:afn=afn' except that it  automatically 
invokes a Control Mode which allows the user to rename files individually.

  Options   I   <-- Inspect and approve each rename

            S   <-- Include System files

            E   <-- Erase existing file without prompt
:2
 RENAME Notes - 1/3 

   a. Besides  allowing ambiguous  file names  and  supporting  inspection and
      control modes,  RENAME accepts a list of files, renames Read/Only files, 
      and sets the  attributes (R/O, SYS) of the new file names to be the same 
      as those on the old file names.

   b. Vs 3.4 updates (03/31/90, Gene Pizzetta):
      - Modified for more compact display, usually a single line for each file
        renamed.  ^C aborts at any prompt.
 
   c. Vs 3.3a updates (12/30/87, Bruce Morgen):
      - Strip high bit from EFCB program name characters.  "E" and "S" options
        require Wheel byte set; help message reflects this.
 RENAME Notes - 2/3 

   d. Vs 3.3 updates (12/19/87, Bruce Morgen):
      - Implements the PPIP-style dual syntax.  Control Mode is mandatory  and
        automatic for single-filespec elements.   If a single-filespec element 
        is the last (or only) one in  a RENAME command line,  the second file-
        spec in the last (or only) command  is tested if the MS-DOS  syntax is
        detected.  If that second filespec starts with  a '/' or includes only 
        valid option letters (and no more characters than the number  of valid 
        option letters), it is assumed to be an option specifier rather than a
        rename-to filespec.  

   e. Vs 3.2 updates (08/25/87, Jay Sage);
      - Changed to allow  a leading slash  before  an  option  to make program
        consistent with a  number of  other Z  programs (this  was supposed to
        happen, but there was a bug in the code).  Put data into a DSEG.  Made
        header indicate load address.
 RENAME Notes - 3/3 

   f. Vs 3.1 updates (04/12/87, Jay Sage):
      - Took idea of Rick Charnes and implemented it  as an option so that one
        does not have to have two versions of the program.  The option is 'E'.
        Also updated code to ZCPR33 type-3 environment to allow linking RENAME
        for execution in high memory if desired.

   g. Vs 3.0a updates (04/09/87, Rick Charnes):
      - Modified slightly so  that  if  you try to rename FILE1  to FILE2  and
        FILE2 already exists, the program will NOT ask you if you are sure you
        want to delete FILE2.  
:3
 Examples of Use 

   a. RENAME *.txt

      - rename all *.TXT files to names input by user

   b. RENAME asm:*.mac=*.asm

      - rename all *.ASM files to *.MAC

   c. RENAME *.obj=*.com SI 

      - rename all COM files to OBJ and include SYStem files and Inspect
        and approve each change
