=over =item rename OLDNAME,NEWNAME X X X X Changes the name of a file; an existing file NEWNAME will be clobbered. Returns true for success; on failure returns false and sets L|perlvar/$!>. Behavior of this function varies wildly depending on your system implementation. For example, it will usually not work across file system boundaries, even though the system I command sometimes compensates for this. Other restrictions include whether it works on directories, open files, or pre-existing files. Check L and either the L manpage or equivalent system documentation for details. For a platform independent L|File::Copy/move> function look at the L module. Portability issues: L. =back