Mercurial > hg-stable
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 <new-email@example.com>'
- 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 REV [+] | revision to edit |
--fold | also fold specified revisions into one | |
-n | --note TEXT | store a note on metaedit |
-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 'section.name=value') | |
--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) |