Mercurial

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.

Please contribute!

Contributions are most welcome! Please create a user name for yourself by clicking "Login" in the upper right. Mercurial and all wiki content are available under the [http://www.gnu.org/copyleft/gpl.html GNU GPL].

Getting Started

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

• See WhatsNew and read the UpgradeNotes

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

• WindowsInstall describes how to install Mercurial under Windows

• A QuickStart for the impatient

Using Mercurial

• A QuickStart2 for graduates of the above - read before your first commit!

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

• [:FAQ:Frequently Asked Questions] - FAQ

• TipsAndTricks

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

• XemacsAndEmacsUsers - Here is a .hgignore that users of XEmacs and Emacs will love

• 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

• NamedBranches gives an introduction to this recent feature

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

• UsingBisect - how to use the bisect extension to find bugs

• TransplantExtension - cherry-picks patches and rebases branches

• ExtensionHowto - how to write Mercurial extensions

  See CategoryExtension for a more complete list.

How To

• HgSysTrac - Using hg and trac for Unix system configuration changes management.

Further information

• MailingLists:

  • general list:

    [http://www.selenic.com/mailman/listinfo/mercurial/ subscriptions], [http://www.selenic.com/pipermail/mercurial/ archives], and [http://marc.theaimsgroup.com/?l=mercurial&w=2 archive search] developers list:

    [http://www.selenic.com/mailman/listinfo/mercurial-devel/ subscriptions], [http://www.selenic.com/pipermail/mercurial-devel/ archives]

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

• ["DeveloperInfo"] for Mercurial hackers

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

• OtherTools that work with Mercurial

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

• A list of ["Presentations"] and other related events.

• Ideas for Google's SummerOfCode2006.