Typical Mercurial Usage¶

Unlike git, hg workflow maintains three trees in the local repository: Working Directory -> Index -> Head.

Create a New Repository¶

hg init

hg clone /path/to/local/repository
hg clone username@host:/path/to/remote/repository

hg add <directory | file>

This will add the changes to the Index.

hg commit [-m message]

This will commit the changes to the Head, but not to the remote repository yet.

hg push [-b branch_name]

The changes in Head will be sent to the remote repository, whose default branch is master.

hg branch <name_of_feature>
hg commit -m "Start <name_of_feature> branch."

hg update default

hg update <name_of_feature>
hg commit -m "Close <name_of_feature>." --close-branch

A branch is not available to others unless it is pushed to the desired remote repository.

hg diff -r <source_branch>:<target_branch>

hg pull

hg merge [branch]

After this step, one typically performs a commit and push.

hg tag -r <changeset_id> <semantic_versioning>

The version number should have semantic meaning.

hg log [-l limit_to_last_n_entries] [-u username]
hg glog [-l limit_to_last_n_entries] [-u username]

hg commit --amend

hg update -C

hg revert -r <changeset_id> <directory | file>

hg log --patch --rev tip

hg export -o /path/to/local/file -r <changeset_id>