fast-import: document the --done option
authorEric S. Raymond <esr@thyrsus.com>
Wed, 22 Aug 2012 10:57:05 +0000 (06:57 -0400)
committerJunio C Hamano <gitster@pobox.com>
Wed, 22 Aug 2012 18:15:16 +0000 (11:15 -0700)
Acked-by: Sverre Rabbelier <srabbelier@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-fast-import.txt

index 0fc68a911e9659e1d06355e872d2d84359ec9e9b..3e7e62057e9fd8236331f56309ced2e180d2d03d 100644 (file)
@@ -38,6 +38,10 @@ OPTIONS
        See ``Date Formats'' below for details about which formats
        are supported, and their syntax.
 
+-- done::
+       Terminate with error if there is no 'done' command at the
+       end of the stream.
+
 --force::
        Force updating modified existing branches, even if doing
        so would cause commits to be lost (as the new commit does
@@ -1030,7 +1034,9 @@ done::
        Error out if the stream ends without a 'done' command.
        Without this feature, errors causing the frontend to end
        abruptly at a convenient point in the stream can go
-       undetected.
+       undetected.  This may occur, for example, if an import
+       front end dies in mid-operation without emitting SIGTERM
+       or SIGKILL at its subordinate git fast-import instance.
 
 `option`
 ~~~~~~~~