= Combinator =

'''Combinator''' is a tool for managing branch-based development in subversion repositories like Twisted's.

If you have bzr, you can obtain Combinator by running the following commands from your project directory:

{{{
mkdir Divmod
bzr branch lp:divmod.org Divmod/trunk
}}}

If you neither have nor want bzr, you can [https://bazaar.launchpad.net/~divmod-dev/divmod.org/trunk/tarball/2688?start_revid=2688 download the divmod.org files as a tgz archive].  Extract it and rename the "divmod.org" directory to "Divmod."

Then read [https://bazaar.launchpad.net/~divmod-dev/divmod.org/trunk/view/head:/Combinator/README.txt Divmod/trunk/Combinator/README.txt] and follow the directions there.

''The directory names are significant.''  If Combinator is not within a Divmod/trunk directory, you're likely to see an error like "Combinator sitecustomize located outside of Combinator directory, aborting."

== Further Reading ==

 * UltimateQualityDevelopmentSystem
 * [http://twistedmatrix.com/trac/wiki/TwistedWithCombinator Instructions on using Combinator for Twisted development]
 * [http://twistedmatrix.com/documents/current/core/development/policy/svn-dev.html Working from Twisted's Subversion repository]
 * [http://web.archive.org/web/20100109103156/http://divmod.org/trac/wiki/DivmodCombinator Archive of the old Combinator page at divmod]
 * [http://web.archive.org/web/20100107235656/http://divmod.org/trac/wiki/CombinatorTutorial Archive of the Combinator tutorial]
 * [https://bazaar.launchpad.net/~divmod-dev/divmod.org/trunk/files/head:/Combinator/ Combinator sources in the divmod project on launchpad]