


            Rename(V1.3, 2.x, 3.x in C:)



     NAME
          Rename - To rename or move files and directories.

     SYNOPSIS
          1.3:
          Rename [From] fromname [TO or AS] toname

          2.x/3.x:
          Rename [From] fromname [TO or AS] toname [QUIET]

     DESCRIPTION
            Rename is a complete replacement of Commodore's old 
        Move command.  Originally, Rename was a limited form of 
        the more advanced Move command.  The difference between 
        the two was that Move will also Rename files across 
        devices, while Rename cannot. Move also had a few 
        additional options which are quite pleasant.  It was 
        recommended that you delete this file and use Move, 
        defining an Alias if you have scripts which use Rename. 
        But, times have changed and Rename has become a much more 
        versitile program.

            Well, Commodore got rid of Move because Rename is 
        'better'.  Well, despite its advances, it still cannot 
        Rename accross devices or volumes.  You are only able to 
        move files from one directory to the next on the same 
        disk.  You are also able to use it to reorganize the 
        entire directory structure of your disk.

      KEYWORDS

        FROM fromname
            This is the file to rename. If this is the first 
        statement you don't need to use the keyword.  2.x/3.x 
        lets you utilize any wildcard pattern supported by 
        AmigaDOS.

        TO (AS) toname
            These commands are optional. This is the name of the 
        file you are renaming to. You can use either the TO or 
        the AS keyword to get the same effect. If the file you 
        are RENAMing to already exists then RENAME will fail.

        QUIET
        2.x/3.x only:
            Keeps the progress report from being shown on the 
        screen while renames are being made.


        EXAMPLES:

        1. To move a file "SomeThing" to a directory named
           "InHere/Now" without changing the file name:

        RENAME Something InHere/Now/Something

              or

        RENAME Something InHere/Now

        (note: This will also work with renaming entire
         directories as well.)

 
        2. To Rename a file called BigBlue to Commodore:

        RENAME BigBlue Commodore

  
        3. To move a file "Work Docs" to a directory called
        "Textra/Work" without changing the name:

        RENAME "Work Docs" ":Textra/Work/Work Docs"

