Colors

[color]
changeset.public = green
changeset.secret = red

ui.warning = yellow

Annotate

[annotate]
ignorews = True

Ignore white space in hg annotate.

Update

[commands]
update.check = noconflict

This makes hg update abort if there is potential for a merge conflict. This way you can mentally prepare for dealing with it instead of suddenly dropping unprepared into vimdiff.

Note: This is currently enabled by ui.tweakdefaults.

Non-publishing

[phases]
publish = False

Setting this in your local hgrc prevents marking changes as published when pushed between local repositories.

Path sub-options

[paths]
default = https://hg.example.org/project/
default:pushurl = ssh://hg@hg.example.org/project/
default:pushrev = .

A ssh :pushurl is useful when the repo is read-only via https, or is otherwise different.

Setting :pushrev is equivalent to hg push -r REV, with . being the currently checked out revision.

Automatic commit message prefix

This inserts the common directory path as prefix when starting a commit editor:

[committemplate]
changeset = {ifeq(desc, "", "{commondir(files)}: ", "{desc}")}\n\n\n{changeset_trailer}\n{diff()}

Viewing changes in alternate ways

The extdiff extension is handy for showing changes in various alternate ways.

[alias]
meld = extdiff -p meld
vimdiff = extdiff -p vimdiff

[extensions]
extdiff =

This allows e.g. hg meld -c . to show the currently checked out changeset.

Code formatting

The fix extension provides a handy command for applying filters to code, such as code formatters or simply trimming trailing whitespace. It can operate on both uncommitted changes and draft commits, amending them in place.

[fix]
# Trim trailing whitespace (only) on changed lines
trailing-whitespace:command = sed
trailing-whitespace:linerange = -e '{first},{last}s/\s\+$//'
trailing-whitespace:pattern = set:not binary()

# Normalize XML
xmllint:command = xmllint --nsclean --encode UTF-8 --format -
xmllint:pattern = set:**.xml + **.svg

[extensions]
fix =

Then you can run it like hg fix -w thisfile.ext to apply the filters in the working directory, or hg fix -r REV to rewrite commits with filters applied.

Finding tags

Sometimes you find the fix for some bug in revision rev and wonder which release, if any, it was included in.

hg log -r 'first(rev:: and tag())'

What this does is:

1. rev is the revision we’re interested in.
2. rev:: is that and every descendant of it.
3. rev:: and tag() are all tags that descends from rev.
4. first(rev:: and tag()) is the first tag.

Links

Here’s how to add hg link command which gives you the URL to a hgweb instance, either the latest revision or one specified with --rev REV.

Add to your main hgrc:

[alias]
links = log -T '{weblink}\n'
link = links -l 1

[templatealias]
# An alias that constructs a hgweb URL from the default path
# or a specified base URL based on the phase of the changeset
weblink = '{config("web", phase, config("paths","default"))}rev/{node|short}'

In any project where this does not produce correct URLs from path.default, e.g. because it uses ssh://, or if you otherwise want to override the base URL, you can add to the project/.hg/hgrc like this:

[web]
public = https://hg.example.com/project/
draft = http://localhost:8080/

Draft changesets can have different URLs, useful if you use some non-publishing repo where drafts can be shared for review.

[templatealias]
linked(url, text) = '\33]8;;{url}\33\\{text}\33]8;;\33\\'

[templates]
withlinks = '{linked(weblink, node|short)} {desc|firstline}\n'

hg log -T withlinks