README.rst
author Hal Wine <hwine@mozilla.com>
Tue, 03 Jun 2014 16:07:26 -0700
changeset 359284 57b51fdb0c8767101be83495c4bad90667623c6c
parent 358878 2b4ece5493e8200d80095d51af2d0363534d4d7a
child 359556 b4a179764b6eea35b3be2605d95bbbba0da3585f
permissions -rw-r--r--
bug 1010053 - remove try_gcc45 hook; r=glandium

=============================
Mozilla Version Control Tools
=============================

This repository contains tools, extensions, hooks, etc to support version
control at Mozilla.

The canonical repository is https://hg.mozilla.org/hgcustom/version-control-tools/

Mercurial Extensions
====================

This repository contains a number of Mercurial extensions. Each is
described in the sections below.

All extensions are located under the ``hgext/`` subdirectory.

bzexport
--------

The bzexport extension provides commands for interacting with Bugzilla.
It's known for its namesake ``hg bzexport`` command, which exports/uploads
patches to Bugzilla. It also offers an ``hg newbug`` command to create
new bugs from the command line.

This extension lives under ``hgext/bzexport``.

mozext
------

*mozext* is a Swiss Army Knife for Firefox development. It provides a
number of features:

* It defines aliases for known Firefox repositories. You can do
  ``hg pull central``, etc.
* It provides a mechanism for tracking each repository via bookmarks,
  allowing you to more easily operate a unified repository.
* Changes to Python files are automatically checked for style.
* Pushlog data is synchronized to a local database.
* Bug data is extracted from commit messages and stored in a database.
* Many revision set and template functions are added.

If you are looking to turn Mercurial into a more powerful query tool or
want to maintain a unified repository, *mozext* is very valuable.

This extension lives under ``hgext/mozext``.

Testing
=======

Testing requires a special Python environment. To create this
environment:

  $ ./create-test-environment
  $ source venv/bin/activate

Then, launch the tests:

  $ ./run-mercurial-tests.py