1. TortoiseHg
  2. TortoiseHg
  3. thg-winbuild


thg-winbuild /

Filename Size Date modified Message
145 B
468 B
4.4 KB
104 B
979 B
28.7 KB

TortoiseHg and Mercurial installer builder for Windows

Repository subdirs:

contrib/ - Bundled libraries and utilities external to (T)HG misc/ - Miscellaneous files used to build packages

Clones (setup.py will create these clones at runtime):

hg-main - Mercurial repository tortoisehg - TortoiseHg repository hgfold - case folding conflict detection and resolution extension hgcr-gui - code review extension keyring - python-keyring-lib hgkeyring - mercurial keyring extension perfarce - perforce integration extension hgeol - EOL handling extension (eventual successor to win32text)

=== Mercurial Prerequisites ===

  • Python 2.6.4

    http://www.python.org/ C:Python26 must be in your PATH

  • C++ Compiler

    Get the gratis "Microsoft Windows SDK for Windows 7 and .NET Framework 3.5 SP1" from microsoft.com.

    See the win32/shellext/README.txt file in the TortoiseHg source for details on installing this package.

    If you already have Visual Studio 2008, installing the SDK will confuse DISTUTILS when it tries to build Mercurial's C extensions. Simply comment out the line in setup.py that sets the DISTUTILS_USE_SDK environment variable, and distutils will use VC2008 to build Mercurial and our build scripts will use SDK's compiler to build the THG shell extension. These are supposedly the same compiler, so it should be ok.

  • pywin32

    Get the latest version for your Python release http://sourceforge.net/projects/pywin32/ pywin32-214.win32-py2.6.exe

  • gettext

    We recommend the 'Setup program' from http://gnuwin32.sourceforge.net/packages/gettext.htm

  • py2exe

    Get the latest version for your Python release http://sourceforge.net/projects/py2exe/

  • Windows Installer XML

    Get the latest stable 3.0 package from http://sourceforge.net/projects/wix/files/

  • Docutils

    Building HTML man pages for Mercurial requires the rst2html.py script from docutils. The easiest way to get docutils is to install setuptools (below), then: C:Python26Scriptseasy_install.exe docutils

=== Building TortoiseHg documentation ===

To build just the TortoiseHg docs, install the packages below then:

python setup.py --thg-doc

  • setuptools (provides easy_install.exe)

    Get the latest version for your Python release http://pypi.python.org/pypi/setuptools We're using:


  • sphinx, docutils, jinja2, pygments, etc

    (requires easy_install from setuptools) The sphinx package has dependencies for docutils, jinja, etc, so installing sphinx pulls in all the other prerequisites.

    easy_install sphinx

  • MiKTeX (to build PDF docs)

    http://miktex.org/2.8/setup You can chose for it to automatically download packages when it needs them, else the first time it builds PDF docs it will require much user interaction. We're using:


  • HTML Help Workshop (to build CHM docs)

    This should come with the Windows SDK, but also available here: http://msdn.microsoft.com/en-us/library/ms669985%28VS.85%29.aspx

=== Building TortoiseHg Installer Packages ===

To build TortoiseHg MSI packages, you need the Mercurial prerequisites, TortoiseHg documentation prerequisites, and these packages:

  • GTK+ for Windows

    http://www.gtk.org/download-windows.html Unzip to C:GTK or set GTK_PATH to the unzip location The WiX scripts require:


  • PyGTK

    Get the latest version for your Python release http://www.pygtk.org/downloads.html The WiX scripts require:

    pycairo-1.8.6.win32-py2.6 pygobject-2.20.0.win32-py2.6 pygtk-2.16.0.win32-py2.6

  • iniparse

    (requires easy_install from setuptools) easy_install --always-unzip iniparse

  • pyreadline (optional)

    required by wincolor extension (requires easy_install from setuptools) easy_install --always-unzip pyreadline

  • OpenSSL Python bindings (optional)

    easy_install --always-unzip pyopenssl

  • Subversion Python bindings (optional)

    If you want your TortoiseHg package to include Subversion Python bindings (for svn conversions), install the bindings from: http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=8100 We're using:


== Build Steps ==

It's entirely automated. Ensure C:Python26 is in your path, then run:

python setup.py --help