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)