Mercurial

[http://www.selenic.com/mercurial/mercurial-logo.png]

Hg: the chemical symbol for mercury, from the Greek hydrargyrum.

mercurial: relating to or having characteristics (eloquence, shrewdness, swiftness, thievishness) attributed to the god Mercury

Mercurial: "a fast, lightweight Source Control Management system designed for efficient handling of very large distributed projects". ([http://packages.debian.org/unstable/devel/mercurial ref]) Mercurial is developed using Python and open source licensed.

This is a wiki for the Mercurial ["DistributedSCM"] tool.

Please contribute!

Contributions are most welcome, but please create a user name for yourself before you edit anything. To do this, click on the "Login" link up in the top right corner of this page and follow the instructions from there. All wiki content is available under the [http://www.gnu.org/copyleft/gpl.html GNU GPL].

New to all this stuff?

• Check out the MajorFeatures

• See WhatsNew and read the UpgradeNotes

• ["Download"] the latest source or check for BinaryPackages for your system

• UnixInstall describes how to install Mercurial under Linux, MacOS X, and Unix variants

• WindowsInstall describes how to install Mercurial under Windows

Using Mercurial

• A QuickStart for the impatient

• ["Tutorial"] for new users (["FrenchTutorial"], ["SpanishTutorial"] and ["JapaneseTutorial"] available)

• [:FAQ:Frequently Asked Questions]

• TipsAndTricks

• [http://www.selenic.com/mercurial/hg.1.html hg(1)] and [http://www.selenic.com/mercurial/hgrc.5.html hgrc(5)] manpages

• WorkingPractices describing several somewhat sane ways to use Mercurial

• How to handle MultipleCommitters

• CommunicatingChanges describes the various ways Mercurial can exchange changesets

• PublishingRepositories and ServerInstall describes various ways to make your code visible to the world

For refugees from CVS and other systems

• CvsConcepts - translations of ["CVS"] concepts into Mercurial terms

• CvsCommands - equivalents of commands provided by ["CVS"]

• ConvertingRepositories from other ["SCM"] formats to Mercurial

• ["Glossary"] of terms (useful if you're not used to distributed source management)
• A ["Tag"] is slightly different in Mercurial than in other ["SCM"] systems

Extensions

• UsingHgk - how to use the GUI repository browser

• MqExtension - Mercurial Patch Queues

• ExtensionHowto - how to write Mercurial extensions

Information for contributors

• Tips for ContributingChanges

• The ToDo list and MissingFeatures

• ["Design"] - Mercurial's data structures and how it uses them.

• WhatGoesWhere - the project architecture

• WireProtocol - the push/pull changegroup protocol

• OptionNaming - the conventions used to name command-line options

• DebuggingFeatures - how to poke around in Mercurial's internals

• ["Theming"] - how to create new styles for Mercurial's web interface

• WritingTests - how to add tests to the test suite

• DeveloperRepos - where to find various public repositories of Mercurial work

• The RoadMap and the InternationalizationPlan

• NewFeatureDiscussions - A page of links to discussions about new features.

Links

• MailingList

• [http://selenic.com/mercurial/bugs/ Mercurial bug tracker]

• IRC channel: #mercurial on irc.freenode.net

• OtherTools that work with Mercurial

• A list of ["ProjectsUsingMercurial"] and links to their repositories.