Developer Info

Information on working on the Mercurial code base.

This page is obviously intended for developers.

1. Start hacking

• WritingExtensions - how to write Mercurial extensions

• Theming - how to create new styles for Mercurial's web interface

• DeveloperBasics - some basic code examples

• MercurialApi - The internal API for Mercurial

• TranslatingMercurial - how to translate Mercurial into your own language

2. Contributing code

• Contributing changes - how to send us your changes

• Coding style - how to make your code pretty

• WritingTests - how to add tests to the test suite

• CompatibilityRules - how we keep our existing users from crying

• DevelopmentGuidelines - other things we try to follow when writing code

3. Internals

• Design - Mercurial's data structures and how it uses them

• FileFormats - list of Mercurial's disk file formats

• WhatGoesWhere - the project architecture

• WireProtocol - the push/pull changegroup protocol

• DebuggingFeatures - how to poke around in Mercurial's internals

4. Working with the community

• ManagingBugs - how to work with the bug tracker

• TimeBasedReleasePlan

• DeveloperRepos - where to find various public repositories of Mercurial work

• IRC - where most of the developers hang out

5. Feature proposals

• NewFeatureDiscussions - A page of links to discussions about new features.

6. Developer tips

• MacOSXTools - Installing the tool chain on Mac OS X.

• Using Wine to tests Windows support under Linux

CategoryDeveloper