← Back to branch summary

~bzr/bzr-fastimport/0.6

« back to all changes in this revision

Viewing changes to __init__.py

  • Committer: Ian Clatworthy
  • Date: 2008-02-27 02:05:19 UTC
  • Revision ID: ian.clatworthy@internode.on.net-20080227020519-yajniarqzxf6g8w8
cleanly restart after an interruption - basic mirroring

Show diffs side-by-side

added added

removed removed

Lines of Context:
__init__.py
72
72
 
73
73
    While reusing an existing format with existing frontends is
74
74
    great, it does mean a slightly more complex recipe when
75
 
    importing large projects, namely::
 
75
    importing large projects via exporters that reuse blob data
 
76
    across commits, namely::
76
77
 
77
78
      bzr init-repo .
78
79
      front-end > xxx.fi
83
84
    holds caching hints that the second pass uses to lower memory
84
85
    usage.
85
86
    
 
87
    At checkpoints and on completion, the commit-id -> revision-id
 
88
    map is saved to a file called 'fastimport-id-map' in the control
 
89
    directory for the repository (e.g. .bzr/repository). If the import
 
90
    is interrupted or unexpectedly crashes, it can be started again
 
91
    and this file will be used to skip over already loaded revisions.
 
92
    As long as subsequent exports from the original source begin
 
93
    with exactly the same revisions, you can use this feature to
 
94
    maintain a mirror of a repository managed by a foreign tool.
 
95
    If and when Bazaar is used to manage the repository, this file
 
96
    can be safely deleted.
 
97
 
86
98
    If you wish to write a custom exporter for your project, see
87
99
    http://bazaar-vcs.org/BzrFastImport for the detailed protocol
88
100
    specification. In many cases, exporters can be written quite