%general-entities; ]> $LastChangedBy$ $Date$ Mercurial-&mercurial-version; mercurial 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. &lfs77_checked; &gcc5_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &mercurial-md5sum; Download size: &mercurial-size; Estimated disk space required: &mercurial-buildsize; Estimated build time: &mercurial-time; Mercurial Dependencies Required Optional , , (gpg2 with Python bindings), (with Python bindings), Bazaar, Docutils (required to build the documentation), pyflakes, pygments, and pyOpenSSL User Notes: 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-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 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 /etc/mercurial/hgrc If you have installed the 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 Installed Libraries Installed Directories hg several internal modules under /usr/lib/python&python2-majorver;/site-packages/mercurial /etc/mercurial and /usr/lib/python&python2-majorver;/site-packages/{hgext,mercurial} Short Descriptions hg is the program file for mercurial. hg