Mercurial

From ArchWiki
Revision as of 09:22, 9 October 2011 by W0ng (Talk | contribs) (Configuration)

Jump to: navigation, search

Mercurial (commonly referred to as hg) is a distributed version control system written in Python and is similar in many ways to Git, Bazaar and darcs.

Installation

Mercurial is available from the standard repositories (see Template:Package Official): Template:Cli

Configuration

At the minimum you should configure your username or mercurial will most likely give you an error when trying to commit. Do this by editing Template:Filename and adding the following: Template:File


To use the graphical browser hgk aka. hg view, add the following to Template:Filename (see forum thread): Template:File


To remove Mercurial warnings of unverified certificate fingerprints, add the following to Template:Filename (see Mercurial wiki): Template:File

Usage

All mercurial commands are initiated with the hg prefix. To see a list of some of the common commands, run Template:Cli

You can either work with a pre-existing repository (collection of code or files), or create your own to share.

To work with a pre-existing repository, you must clone it to a directory of your choice: Template:Cli

To create you own, change to the directory you wish to share and initiate a mercurial project Template:Cli


Dotfiles Repo

If you intend on creating a repo of all your Template:Filename files, you simply initiate the project in your home folder: Template:Cli

It is then just a case of adding the specific files you wish to track: Template:Cli

You can then create a Template:Filename to ensure that only the files you wish to include in the repository are tracked by mercurial.

Tip: If you include: syntax: glob at the top of the Template:Filename file, you can easily exclude groups of files from your repository.


More Resources