fast-import: document the --done option
Acked-by: Sverre Rabbelier <srabbelier@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Eric S. Raymond committed
Aug 22, 2012 at 06:57 UTC
3266de10747c4ad3fa972994004fcb0fca9ebe1f
1 file changed
+7
-1
Documentation/git-fast-import.txt
+7
-1
@@ -38,6 +38,10 @@ OPTIONS
38
See ``Date Formats'' below for details about which formats
39
are supported, and their syntax.
40
41
+-- done::
42
+ Terminate with error if there is no 'done' command at the
43
+ end of the stream.
44
+
45
--force::
46
Force updating modified existing branches, even if doing
47
so would cause commits to be lost (as the new commit does
@@ -1030,7 +1034,9 @@ done::
1034
Error out if the stream ends without a 'done' command.
1035
Without this feature, errors causing the frontend to end
1036
abruptly at a convenient point in the stream can go
1033
- undetected.
1037
+ undetected. This may occur, for example, if an import
1038
+ front end dies in mid-operation without emitting SIGTERM
1039
+ or SIGKILL at its subordinate git fast-import instance.
1040
1041
`option`
1042
~~~~~~~~