'''file rename''' ''?'''''-force'''''? ?- -? source target''

'''file rename''' ''?'''''-force'''''? ?- -? source ?source ...? targetDir''

The first form takes the file or directory specified by pathname ''source'' and renames it to ''target'', moving the file if the pathname ''target'' specifies a name in a different directory. If ''target'' is an existing directory, then the second form is used. The second form moves each ''source'' file or directory into the directory ''targetDir''. Existing files will not be overwritten unless the '''-force''' option is specified. When operating inside a single filesystem, Tcl will rename symbolic links rather than the things that they point to. Trying to overwrite a non-empty directory, overwrite a directory with a file, or a file with a directory will all result in errors. Arguments are processed in the order specified, halting at the first error, if any. A '''- -''' marks the end of switches; the argument following the '''- -''' will be treated as a source even if it starts with a '''-'''. 

----

See also:

   * [file]
   * [file copy]
   * [file delete]

----

[Tcl syntax help] -
[Category Command]