exporters/hg-fast-export.README

   1 hg-fast-import.py - mercurial to bzr converter using bzr fast-import
   2
   3 Legal
   4 =====
   5
   6 Most hg-* scripts are licensed under the MIT license[0] and were written
   7 by Rocco Rutte <pdmef@gmx.net> with hints and help from the git list and
   8 #mercurial on freenode. hg-fast-export[1] was integrated into
   9 bzr-fastimport by Ian Clatworthy with permission from Rocco.
  10
  11 The current maintainer is Frej Drejhammar <frej.drejhammar@gmail.com>.
  12
  13 Usage
  14 =====
  15
  16 Using hg-fast-export is quite simple for a mercurial repository <repo>:
  17
  18   bzr init-repo foo.bzr
  19   cd foo.bzr
  20   hg-fast-import.py -r <repo> | bzr fast-import -
  21
  22 Notes/Limitations
  23 =================
  24
  25 hg-fast-import supports multiple branches but only named branches with exactly
  26 one head each. Otherwise commits to the tip of these heads within branch
  27 will get flattened into merge commits.
  28
  29 The way the hg API and remote access protocol is designed it is not
  30 possible to use hg-fast-export on remote repositories
  31 (http/ssh). First clone the repository, then convert it.
  32
  33 Design
  34 ======
  35
  36 hg-fast-import.py was designed in a way that doesn't require a 2-pass mechanism
  37 or any prior repository analysis: if just outputs what it finds.
  38 This also implies that it heavily relies on strictly
  39 linear ordering of changesets from hg, i.e. its append-only storage
  40 model so that changesets hg-fast-import already saw never get modified.
  41
  42 Todo
  43 ====
  44
  45 Test incremental imports, particularly handling of branches and tags.
  46
  47 For one-time conversions, everything should be fine.
  48
  49 Footnotes
  50 =========
  51
  52 [0] http://www.opensource.org/licenses/mit-license.php
  53
  54 [1] http://repo.or.cz/w/fast-export.git