MacHg icon

Using an External Mercurial Version

You should almost always use the version of Mercurial which is built into MacHg. It has been tested to work correctly with the version of MacHg you are using. Using a different version of Mercurial will very likely lead to problems. However some developers and other people might like to experiment with using a different version of Mercurial. (In fact personally I would have not included this option at all but there has been a large amount of pressure to include it.)

To use an External Mercurial Version:

  1. Open the MacHg preferences and choose Advanced Preferences

  2. Change the popup 'Mercurial Binary' from 'Builtin' to 'Other'

  3. In the text field that appears enter the absolute path to the mercurial binary you want to use.

Important: The external Mercurial must have the exact same extensions included in it that the Mercurial included with MacHg uses. Currently this means you must include both the modified histedit and the modified collapse extensions which are included in the bundled version of Mercurial which is included in MacHg. Moreover these modified extensions need to be placed in the extensions folder of the external Mercurial. Specifically you must copy into the external Mercurial extensions folder the following extensions:

  1. MacHg.app/Contents/PlugIns/LocalMercurial/hgext/collapse.py

  2. MacHg.app/Contents/PlugIns/LocalMercurial/hgext/histedit