NAME

       rename-file -  (files)

PURPOSE

       Renames a file.

SYNTAX

           rename-file <from file> to <to file> [ status <status> ]

DESCRIPTION

       rename-file will rename <from file> to <to file>. <status> number is GG_OKAY on success and GG_ERR_RENAME
       on failure.

       <from  file>  and  <to  file>  must  be  specified with full paths unless they are in the current working
       directory (see directories), in which case a name alone will suffice. <from file> and <to file> can be in
       different directories.

EXAMPLES

       Rename files:

           rename-file "/home/u1/d1/f1" to "/home/u1/d2/f2" status st
           if-true st equal GG_OKAY
               @Rename successful. <br/>
           end-if

       Rename files in the current working directory:

           rename-file "f1" to "f2" status st
           if-true st equal GG_OKAY
               @Rename successful. <br/>
           end-if

SEE ALSO

        Files

       change-mode close-file copy-file delete-file file-position file-storage  file-uploading  lock-file  open-
       file  read-file  read-line  rename-file stat-file temporary-file uniq-file unlock-file write-file See all
       documentation

$DATE                                               $VERSION                                           GOLF(2gg)