Help: metaedit

hg metaedit [OPTION]... [-r] [REV]

edit commit information

Edits the commit information for the specified revisions. By default, edits commit information for the working directory parent.

With --fold, also folds multiple revisions into one if necessary. In this case, the given revisions must form a linear unbroken chain.

Some examples:

  • Edit the commit message for the working directory parent:
    hg metaedit
  • Change the username for the working directory parent:
    hg metaedit --user 'New User <>'
  • Combine all draft revisions that are ancestors of foo but not of @ into one:
    hg metaedit --fold 'draft() and only(foo,@)'

    See 'hg help phases' for more about draft revisions, and 'hg help revsets' for more about the 'draft()' and 'only()' keywords.

options ([+] can be repeated):

-r --rev VALUE [+] revision to edit
--fold also fold specified revisions into one
-m --message TEXT use text as commit message
-l --logfile FILE read commit message from file
-d --date DATE record the specified date as commit date
-u --user USER record the specified user as committer
-D --current-date record the current date as commit date
-U --current-user record the current user as committer

global options ([+] can be repeated):

-R --repository REPO repository root directory or name of overlay bundle file
--cwd DIR change working directory
-y --noninteractive do not prompt, automatically pick the first choice for all prompts
-q --quiet suppress output
-v --verbose enable additional output
--color TYPE when to colorize (boolean, always, auto, never, or debug)
--config CONFIG [+] set/override config option (use '')
--debug enable debugging output
--debugger start debugger
--encoding ENCODE set the charset encoding (default: UTF-8)
--encodingmode MODE set the charset encoding mode (default: strict)
--traceback always print a traceback on exception
--time time how long the command takes
--profile print command execution profile
--version output version information and exit
-h --help display help and exit
--hidden consider hidden changesets
--pager TYPE when to paginate (boolean, always, auto, or never) (default: auto)