Mercurial-3.5.1

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. If there are failures, e.g. test-parse-date.t, those tests can be disabled. To test the results in the subdiretory tests/tmp, skipping failing tests, issue:

cat > tests/blacklists/failed-tests << "EOF"
# Test Failures
   test-hgweb-commands.t
   test-convert-svn-source.t
   test-subrepo-svn.t
   test-convert-hg-svn.t
   test-mq-subrepo-svn.t
   test-gpg.t
EOF
rm -rf tests/tmp &&
TESTFLAGS="-j<N> --tmpdir tmp --blacklist blacklists/failed-tests" \
make check

where <N> is an integer between one and the number of processor threads, inclusive. 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.

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