Rocco Rutte 69e2d5df9b Add some degign notes to readme
Signed-off-by: Rocco Rutte <pdmef@gmx.net>
2007-03-08 09:37:41 +00:00
2007-03-08 09:37:23 +00:00
2007-03-08 09:37:41 +00:00

hg2git.(sh|py) - mercurial to git converter using git-fast-import

Legal
=====

The scripts are licensed under the GPL version 2 and were written by
Rocco Rutte <pdmef@gmx.net> with hints and help from the git list and
#mercurial on freenode.

Usage
=====

Using it is quite simple for a mercurial repository <repo>:

  mkdir repo-git # or whatever
  cd repo-git
  git init
  hg2git.sh <repo>

Incremental imports to track hg repos is supported, too.

Notes
=====

As each git-fast-import run creates a new pack file, it may be required
to repack the repository quite often for incremental imports (especially
when importing a small number of changesets per incremental import).

Design
======

hg2git.py was designed in a way that doesn't require a 2-pass mechanism
or any prior repository analysis: if just feeds what it finds into
git-fast-import. This also implies that it heavily relies on strictly
linear ordering of changesets from hg, i.e. its append-only storage
model so that changesets hg2git already saw never get modified.
Description
A mercurial to git converter using git-fast-import:
https://repo.or.cz/w/fast-export.git
Readme 1.2 MiB
Languages
Python 70.7%
Shell 29.1%
Makefile 0.2%