= Mercurial Branches =

This page documents how to use Mercurial, rather than Subversion, to hack on Django.

== Core developers ==

For people who are core committers, and want to use Mercurial rather than Subversion as their client:

 1. Install the [http://mercurial.selenic.com/wiki/HgSubversion hgsubversion] extension (and understand basically how it works).
 2. Clone the Subversion repository:
    {{{
hg clone svn+http://code.djangoproject.com/svn/django/ django
    }}}
    This will take a while.
 3. Use normal hg commands to make commits, switch branches, push back to the subversion repository etc.

=== Tips ===

 * Use the [http://mercurial.selenic.com/wiki/BookmarksExtension bookmarks] extension for git-style local feature branches.
 * To collapse several commits into a single commit before pushing back to svn, use the [http://mercurial.selenic.com/wiki/HisteditExtension histedit] extension
 * To backport a changeset from trunk, use the [http://mercurial.selenic.com/wiki/TransplantExtension transplant] extension