cvs2git: clarify documentation of --use-external-blob-generator
commitc5a611d1d4fa7d380f8cca3c85a48626c26096c9
authormhagger <mhagger@be7e6eca-30d4-0310-a8e5-ac0d63af7087>
Tue, 16 Nov 2010 05:48:38 +0000 (16 05:48 +0000)
committermhagger <mhagger@be7e6eca-30d4-0310-a8e5-ac0d63af7087>
Tue, 16 Nov 2010 05:48:38 +0000 (16 05:48 +0000)
tree4c5e5bea7702570e06f28f13730ea6bb2f4241a2
parent3a1ceafd8f12f57885b3bf7e7df6f24f0651f143
cvs2git: clarify documentation of --use-external-blob-generator

The blob generator runs without heavy supervision by the main cvs2git
script, which is great for parallelism.  The only gotcha is that the
blob generator and main cvs2git need access to separate parts of the
fast-import stream, which breaks the pattern

cvs2git <options> | git fast-import

that was great for parallelism.  Document this requirement (blobs
and revisions must go to different files) to avoid confusion.

Can we salvage the parallelism by streaming blobs directly to
fast-import and queuing up revs in a file?  Alas, no: the blob
generator seeks around in its output file to be able to read back old
blobs.  Document that requirement, too (the blob file cannot be a
pipe).

Balance out the new cautionary notes by removing an old one: the
--use-external-blob-generator code is solid and no longer deserves
the fearsome "experimental" tag.

Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
git-svn-id: http://cvs2svn.tigris.org/svn/cvs2svn/trunk@5304 be7e6eca-30d4-0310-a8e5-ac0d63af7087
cvs2svn_lib/git_run_options.py