Mercurial > hg-website
Help: amend
hg amend [OPTION]... [FILE]...
aliases: refresh
combine a changeset with updates and replace it with a new one
Commits a new changeset incorporating both the changes to the given files and all the changes from the current parent changeset into the repository.
See 'hg commit' for details about committing changes.
If you don't specify -m, the parent's message will be reused.
If --extract is specified, the behavior of 'hg amend' is reversed: Changes to selected files in the checked out revision appear again as uncommitted changed in the working directory.
Returns 0 on success, 1 if nothing changed.
options ([+] can be repeated):
| -A | --addremove | mark new/missing files as added/removed before committing |
| -a | --all | match all files |
| -e | --edit | invoke editor on commit messages |
| --extract | extract changes from the commit to the working copy | |
| --patch | make changes to wdir parent by editing patch | |
| --close-branch | mark a branch as closed, hiding it from the branch list | |
| -s | --secret | use the secret phase for committing |
| -n | --note TEXT | store a note on amend |
| -I | --include PATTERN [+] | include names matching the given patterns |
| -X | --exclude PATTERN [+] | exclude names matching the given patterns |
| -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 |
| -i | --interactive | use interactive mode |
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) |