NAME

       hg rename - rename files; equivalent of copy + remove

SYNOPSIS

       hg rename [OPTION]... SOURCE... DEST

DESCRIPTION

       Mark  dest as copies of sources; mark sources for deletion. If dest is a directory, copies
       are put in that directory. If dest is a file, there can only be one source.

       By default, this command copies the contents  of  files  as  they  exist  in  the  working
       directory.  If  invoked  with  -A/--after,  the  operation  is recorded, but no copying is
       performed.

       To undo marking a destination file as renamed, use --forget. With that option,  all  given
       (positional)  arguments  are  unmarked as renames. The destination file(s) will be left in
       place (still tracked). The source file(s) will  not  be  restored.  Note  that  hg  rename
       --forget behaves the same way as hg copy --forget.

       This command takes effect with the next commit by default.

       Returns 0 on success, 1 if errors are encountered.

OPTIONS

       --forget
              unmark a destination file as renamed

       -A, --after
              record a rename that has already occurred

       --at-rev <REV>
              (un)mark renames in the given revision (EXPERIMENTAL)

       -f, --force
              forcibly move over an existing managed file

       -I,--include <PATTERN[+]>
              include names matching the given patterns

       -X,--exclude <PATTERN[+]>
              exclude names matching the given patterns

       -n, --dry-run
              do not perform actions, just print output

              [+] marked option can be specified multiple times

ALIASES

       move, mv

                                                                                       HG(RENAME)