Home

How to clone this repository

Using Git

$ git clone git://github.com/b4winckler/vim.git

Using Mercurial

Make sure you have enabled the hg-git and bookmarks extensions before this step (see below).

$ hg clone git://github.com/b4winckler/vim.git

How this repository was cloned from the Vim Mercurial repository

The hg-git Mercurial extension (as well as Mercurial itself) is required in order to track a Mercurial repository with Git, see below on how to enable it.

Create local Mercurial clone:

$ hg clone https://vim.googlecode.com/hg/ vim
$ cd vim

Add bookmark to master branch:

Make sure the bookmarks extension is enabled before this step (see below).

$ hg bookmark -r default master

(Optional) Add bookmark to other Mercurial branches:

$ hg bookmark -r vim73 hg/vim73
$ hg bookmark -r vim72 hg/vim72

Set up Mercurial so that it pushes to the Git repository:

Edit vim/.hg/hgrc and add default-push path:

[paths]
default-push = git+ssh://git@github.com:b4winckler/vim.git

Push all changesets to the Git repository:

Be aware that this may take a long time to complete (up to several hours!).

$ hg push

Updating the Git repository:

Every time the Mercurial repository is modified it is necessary to manually update the Git repository.

First pull and merge all new changesets from the Mercurial repository (see below on how to enable the fetch extension which is used in this step).

$ hg fetch

Bookmarks created with the -r flag are not automatically updated when you fetch the latest changesets, so manually update the bookmarks (the -f flag is required to force the update):

$ hg bookmark -fr default master

If you bookmarked other branches, then update them as well:

$ hg bookmark -fr vim73 hg/vim73
$ hg bookmark -fr vim72 hg/vim72

Now push all new changesets to the Git repository (this time it will only take a minute or so):

$ hg push

Setting up Mercurial:

Install hg-git:

$ sudo easy_install hg-git

To enable the extensions used above, edit ~/.hgrc and add:

[extensions]
bookmarks =
hggit =
fetch =

Notes

Note that the hg-git bridge is lossless, so that:

• If you loose your local Mercurial repository, the above steps can be repeated to set up a new one and you can continue updating the Git repository (only new changesets will be pushed).
• If somebody else sets up a Git clone of the Mercurial repository you can git-pull from that to update your own Git clone (the Git commit ids are identical).
• A maintainer of the Mercurial repository can pull changesets into a Mercurial repository from a cloned Git repository.
• You can use Mercurial to clone a Git clone (if you prefer using Mercurial over Git). New changesets can be pulled from either the original Mercurial repository or from any Git clone. (Normally you would just clone the Mercurial repository, of course.)