|Initial release||19 April 2005|
5.8 / 3 May 2021
|Written in||Python, C, and Rust|
|Operating system||Unix-like, Windows, macOS|
|License||GNU GPL v2+|
Mercurial's major design goals include high performance and scalability, decentralization, fully distributed collaborative development, robust handling of both plain text and binary files, and advanced branching and merging capabilities, while remaining conceptually simple. It includes an integrated web-interface. Mercurial has also taken steps to ease the transition for users of other version control systems, particularly Subversion. Mercurial is primarily a command-line driven program, but graphical user interface extensions are available, e.g. TortoiseHg, and several IDEs offer support for version control with Mercurial. All of Mercurial's operations are invoked as arguments to its driver program
hg (a reference to Hg – the chemical symbol of the element mercury).
Olivia Mackalloriginated Mercurial and served as its lead developer until late 2016. Mercurial is released as free software under the terms of the GNU GPL v2 (or any later version). It is mainly implemented using the Python programming language, but includes a binary diff implementation written in C.
Mackall first announced Mercurial on 19 April 2005. The impetus for this was the announcement earlier that month by Bitmover that they were withdrawing the free version of BitKeeper because of the development of SourcePuller.
BitKeeper had been used for the version control requirements of the Linux kernel project. Mackall decided to write a distributed version control system as a replacement for use with the Linux kernel. This project started a few days after the now well-known Git project was initiated by Linus Torvalds with similar aims.
The Linux kernel project decided to use Git rather than Mercurial, but Mercurial is now used by many other projects (see below). "Git vs. Mercurial" has become one of the holy wars of hacker culture.
In an answer on the Mercurial mailing list, Olivia Mackall explained how the name "Mercurial" was chosen:
Shortly before the first release, I read an article about the ongoing Bitkeeper debacle that described Larry McVoy as mercurial (in the sense of 'fickle'). Given the multiple meanings, the convenient abbreviation, and the good fit with my pre-existing naming scheme (see my email address), it clicked instantly. Mercurial is thus named in Larry's honor. I do not know if the same is true of Git.
Mercurial uses SHA-1 hashes to identify revisions. For repository access via a network, Mercurial uses an HTTP-based protocol that seeks to reduce round-trip requests, new connections, and data transferred. Mercurial can also work over SSH where the protocol is very similar to the HTTP-based protocol. By default it uses a 3-way merge before calling external merge tools.
Figure 1 shows some of the most important operations in Mercurial and their relations to Mercurial's concepts.
Although Mercurial was not selected to manage the Linux kernel sources, it has been adopted by several organizations, including Facebook, the W3C, and Mozilla. Facebook is using the Rust programming language to write Mononoke, a Mercurial server specifically designed to support large multi-project repositories.
In 2013, Facebook adopted Mercurial and began work on scaling it to handle their large, unified code repository.
Google also use Mercurial on their 'Piper' monorepo.
Bitbucket announced that its web-based version control services would end support for Mercurial in June 2020 (then extended to July 2020), explaining that "less than 1% of new projects use it, and developer surveys indicated that 90% of developers use Git". Meanwhile, hundreds of users openly questioned the reasoning for massively deleting historical data, asked why there was not significant warning nor a formal migration plan, and panicked about the rushed timing in their official company support thread.
Mercurial servers and repository management
- Heptapod, a Gitlab fork for Mercurial by Octobus
- Kallithea, a GPLv3 fork of RhodeCode
- Kiln by Fog Creek Software
- Phabricator by Phacility
- RhodeCode by RhodeCode Inc.
Source code hosting
The following websites provide free source code hosting for Mercurial repositories:
- Bitbucket by Atlassian (deprecated from February 2020; read-only since July 2020)
- GNU Savannah by FSF
- Puszcza (a sister site to GNU Savannah, hosted in Ukraine)
Open source projects using Mercurial
Some projects using the Mercurial distributed RCS:
- Mackall, Matt (20 April 2005). "Mercurial v0.1 – a minimal scalable distributed SCM". Linux kernel (Mailing list).
- "README file in rust subdirectory, master branch". 24 January 2020. Retrieved 30 January 2020.
- Mackall, Matt. "Towards a Better SCM: Revlog and Mercurial" (PDF). Mercurial. Archived (PDF) from the original on 26 May 2019. Retrieved 26 May 2019.
- "Matt Mackall is now Olivia Mackall". Mercurial. Retrieved 28 May 2021.
- "Relicensing", Mercurial (wiki), Mercurial-scm.org.
- Mackall, Matt (29 April 2005). "Re: Mercurial 0.4b vs git patchbomb benchmark". Linux kernel (Mailing list). Archived from the original on 9 July 2012.
- "Managing source code with Mercurial".
Mercurial and Git fans are also happy to discuss the learning curve, merits, and usability of each VCS system's command set. Space prevents that discussion here, but a web search on that topic will provide lots of interesting reading material.
- Mackall, Matt (15 February 2012). "Why did Matt choose the name Mercurial?". Mercurial (Mailing list). Retrieved 7 June 2016.
- Torvalds has said: "I'm an egotistical bastard, so I name all my projects after myself. First Linux, now git."
- James Gosling (October 2006). "Open Sourcing Sun's Java Platform Implementations, Part 1" (Interview). Interviewed by Robert Eckstein. Sun. Archived from the original on 1 March 2009.CS1 maint: unfit URL (link)
- "Scaling Mercurial at Facebook". 7 January 2014.
- "A Mercurial source control server, specifically designed to support large monorepos.: facebookexperimental/mononoke". 31 January 2019 – via GitHub.
- "Google Groups".
- Goode, Durham; Agarwal, Siddharth. "Scaling Mercurial at Facebook". Facebook Code. Retrieved 13 October 2015 – via Facebook.
- "Why Google Stores Billions of Lines of Code in a Single Repository".
- "Sunsetting Mercurial support in Bitbucket". 21 April 2020. Archived from the original on 1 July 2020.
- Chan, Denise (20 August 2019). "Sunsetting Mercurial support in Bitbucket". Bitbucket. Retrieved 29 August 2019.
- "What to do with your Mercurial repos when Bitbucket sunsets support". Archived from the original on 11 July 2020. Alt URL
- "Git, Mercurial & Subversion hosting". Features. Codebase HQ. 4 March 2013. Archived from the original on 30 March 2014. Retrieved 4 March 2013.
- "Let's start OSS development with Mercurial (Hg) – OSDN". osdn.net.
- "Hosting", Mercurial (wiki), Mercurial-scm.org.
- "Try Helix TeamHub Free | Perforce". info.perforce.com.
- "Welcome [Puszcza]". ps.gnu.org.ua.
- "TuxFamily: Free hosting for free people". tuxfamily.org.
- "Some projects that use Mercurial", Mercurial (wiki), Mercurial-scm.org.
- Reed, J Paul (12 April 2007). "Version Control System Shootout Redux Redux".
- mozilla-mobile/fenix, Mozilla Mobile, 19 March 2021, retrieved 19 March 2021
|Look up mercurial in Wiktionary, the free dictionary.|
|Wikimedia Commons has media related to Mercurial.|
- Mackall, Matt, "FLOSS Podcast", This week in Tech
- O'Sullivan, Bryan (2009), Mercurial: The Definitive Guide (book), O'Reilly, freely available online
- Spolsky, Joel, Mercurial tutorial, archived from the original on 13 June 2016, retrieved 6 April 2010
- An example-based Mercurial tutorial (PDF), SE: Jemander covering both basic and advanced use
- "Mercurial: an alternative to git", LWN
- "Subversion or CVS, Bazaar or Mercurial? Four open source version control systems compared", JavaWorld, September 2007
- "Mercurial", TechTalk (video)
- List of projects using Mercurial from the Mercurial wiki
- Official website