Mercurial Instructions

There are two ways of accessing the code stored within the repositories upon this machine:

  • Anonymously
    • i.e. read-only.
  • With authentication
    • i.e. with permission to commit changes.

Anonymous Access

To checkout the project foo over HTTP please run:

hg clone http://foo.repository.steve.org.uk/

Authenticated Access

To checkout the project foo using authenticated SSH please run:

hg clone ssh://user@www.steve.org.uk//projects/foo/

To push changes back to the repository please run:

hg push ssh://user@www.steve.org.uk//projects/foo/

Note: the double '/' is intentional.

Mercurial Basics

You can find a good deal of information on using Mercurial via "man hg", or "hg help" but here are brief instructions on the two most common operations you'll want to carry out against code hosted here.

Updating Your Copy

If you have a checked out of a mercurial repository copy and you wish to pull updates from the remote source please run:

hg pull

This will pull all the changes which are available remotely, but not apply them. To apply the freshly downloaded updates run:

hg update

You can combine the two steps into one by running:

hg pull --update

Seeing Your Changes

If you make local changes against the remote repository you can see them by running:

hg diff