hg commit [OPTION]... [FILE]...

aliases: ci

commit the specified files or all outstanding changes

Commit changes to the given files into the repository. Unlike a centralized SCM, this operation is a local operation. See 'hg push' for a way to actively distribute your changes.

If a list of files is omitted, all changes reported by 'hg status' will be committed.

If you are committing the result of a merge, do not provide any filenames or -I/-X filters.

If no commit message is specified, Mercurial starts your configured editor where you can enter a message. In case your commit fails, you will find a backup of your message in ".hg/last-message.txt".

The --close-branch flag can be used to mark the current branch head closed. When all heads of a branch are closed, the branch will be considered closed and no longer listed.

The --amend flag can be used to amend the parent of the working directory with a new commit that contains the changes in the parent in addition to those currently reported by 'hg status', if there are any. The old commit is stored in a backup bundle in ".hg/strip-backup" (see 'hg help bundle' and 'hg help unbundle' on how to restore it).


It is not possible to amend public changesets (see 'hg help phases') or changesets that have children.


Returns 0 on success, 1 if nothing changed.


options ([+] can be repeated):

-A --addremove mark new/missing files as added/removed before committing
--close-branch mark a branch head as closed
--amend amend the parent of the working directory
-s --secret use the secret phase for committing
-e --edit invoke editor on commit messages
-i --interactive use interactive mode
-m --message TEXT use text as commit message
-l --logfile FILE read commit message from file
-u --user USER record the specified user as committer
-S --subrepos recurse into subrepositories

global options ([+] can be repeated):

--cwd DIR change working directory
-q --quiet suppress output
-v --verbose enable additional output
--debug enable debugging output
--debugger start debugger
--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