fast-import doc: cat-blob and ls responses need to be consumed quickly
authorJonathan Nieder <jrnieder@gmail.com>
Wed, 11 Apr 2012 21:25:01 +0000 (16:25 -0500)
committerJunio C Hamano <gitster@pobox.com>
Sun, 15 Apr 2012 20:21:51 +0000 (13:21 -0700)
commitd57e490af31dff940052a5929fe05947c7ad03ad
tree50b0f9c0911659f188ebe151cd2232268bf7710b
parente8dde3e5f9ddb7cf95a6ff3cea6cf07c3a2db80d
fast-import doc: cat-blob and ls responses need to be consumed quickly

If fast-import's command pipe and the frontend's cat-blob/ls response
pipe are both filled, there can be a deadlock.  Luckily all existing
frontends consume any pending cat-blob/ls responses completely before
writing the next command.

Document the requirements so future frontend authors and users can be
spared from the problem, too.  It is not always easy to catch that
kind of bug by testing.

To set the scene, add some words of explanation to help the novice
understand that "cat-blob" and "ls" output are meant for consumption
by the frontend.

Reported-by: Junio C Hamano <gitster@pobox.com>
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-fast-import.txt