Mercurial-3.1.2

Introduction to Mercurial

Mercurial is a distributed source control management tool similar to Git and Bazaar. Mercurial is written in Python and is used by projects such as Mozilla and Vim.

This package is known to build and work properly using an LFS-7.6 platform.

Package Information

  • Download (HTTP): http://mercurial.selenic.com/release/mercurial-3.1.2.tar.gz

  • Download MD5 sum: 72a79798de828d6d6fb055273f91201a

  • Download size: 3.9 MB

  • Estimated disk space required: 44 MB (additional 250 MB for the tests and 2 MB for docs generation)

  • Estimated build time: 0.1 SBU (additional 9 SBU for tests)

Mercurial Dependencies

Required

Python-2.7.8

Optional

Bazaar-2.5.1, CVS-1.11.23, git-2.1.3, GnuPG-2.0.26 (gpg2 with Python bindings), Subversion-1.8.10 (with Python bindings), Docutils (required to build the documentation), pyflakes, pygments, and pyOpenSSL

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/mercurial

Installation of Mercurial

Build Mercurial by issuing the following command:

make build

To build the documentation (requires Docutils), issue:

make doc

Running the test suite is optional. Failure of test-patchbomb is expected with Python-2.7.x (x > 7). To test the results in the subdiretory tests/tmp, skipping the failing test, issue:

cat > tests/blacklists/test-failed << "EOF"
# Failure with Python-2.7.8
  test-patchbomb.t
EOF
rm -rf tests/tmp &&
TESTFLAGS="--tmpdir tmp --blacklist blacklists/test-failed" \
make check

More failing tests might be added to that file, if necessary. Tests may be run in parallel, just add “-j$(getconf _NPROCESSORS_ONLN)” to TESTFLAGS. In order to investigate a particular apparently failing test, e.g “test-parse-date.t”, issue the following commands (notice that omitting --debug sometimes modifies the result):

pushd tests &&
rm -rf tmp  &&
./run-tests.py --debug --tmpdir tmp test-parse-date.t &&
popd

Install Mercurial by running the following command (as root):

make PREFIX=/usr install-bin

If you built the documentation, install it by running the following command (as root):

make PREFIX=/usr install-doc

After installed, two very quick and simple tests should run correctly. First one needs some configuration:

cat >> ~/.hgrc << "EOF"
[ui]
username = <user_name> <your@mail>
EOF

where you must replace <user_name> and <your@mail> (mail is optional and can be omitted). With the user identity defined, run hg debuginstall and several lines will be displayed, the last one reading "no problems detected". Another quick and simple test is just hg, which should output basic commands that can be used with hg.

Configuring Mercurial

Config Files

/etc/mercurial/hgrc

If you have installed the Certificate Authority Certificates and you want Mercurial to use them, as the root user:

install -v -d -m755 /etc/mercurial &&
cat > /etc/mercurial/hgrc << "EOF"
[web]
cacerts = /etc/ssl/ca-bundle.crt
EOF

Contents

Installed Programs: hg
Installed Libraries: several under /usr/lib/python2.7/site-packages/mercurial
Installed Directories: /etc/mercurial, /usr/lib/python2.7/site-packages/hgext and /usr/lib/python2.7/site-packages/mercurial

Short Descriptions

hg

is the program file for mercurial.

Last updated on 2014-10-05 14:19:41 +0000