summaryrefslogtreecommitdiffstats
path: root/git-fast-import.txt
diff options
context:
space:
mode:
authorJunio C Hamano <junio@kernel.org>2011-08-02 00:09:12 +0000
committerJunio C Hamano <junio@kernel.org>2011-08-02 00:09:12 +0000
commitfbc773ce792b42ab94e5dcc0cead5637e9c4079e (patch)
tree159860d1bc50e4c2fbfb50860c61c7e6b2192017 /git-fast-import.txt
parent0f7806a7b05d4c716f629d409438975029c210c3 (diff)
downloadgit-htmldocs-fbc773ce792b42ab94e5dcc0cead5637e9c4079e.tar.gz
Autogenerated HTML docs for v1.7.6-396-ge0613
Diffstat (limited to 'git-fast-import.txt')
-rw-r--r--git-fast-import.txt25
1 files changed, 25 insertions, 0 deletions
diff --git a/git-fast-import.txt b/git-fast-import.txt
index 95e480ef7..296938888 100644
--- a/git-fast-import.txt
+++ b/git-fast-import.txt
@@ -102,6 +102,12 @@ OPTIONS
when the `cat-blob` command is encountered in the stream.
The default behaviour is to write to `stdout`.
+--done::
+ Require a `done` command at the end of the stream.
+ This option might be useful for detecting errors that
+ cause the frontend to terminate before it has started to
+ write a stream.
+
--export-pack-edges=<file>::
After creating a packfile, print a line of data to
<file> listing the filename of the packfile and the last
@@ -331,6 +337,11 @@ and control the current import process. More detailed discussion
standard output. This command is optional and is not needed
to perform an import.
+`done`::
+ Marks the end of the stream. This command is optional
+ unless the `done` feature was requested using the
+ `--done` command line option or `feature done` command.
+
`cat-blob`::
Causes fast-import to print a blob in 'cat-file --batch'
format to the file descriptor set with `--cat-blob-fd` or
@@ -1021,6 +1032,11 @@ notes::
Versions of fast-import not supporting notes will exit
with a message indicating so.
+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.
`option`
~~~~~~~~
@@ -1050,6 +1066,15 @@ not be passed as option:
* cat-blob-fd
* force
+`done`
+~~~~~~
+If the `done` feature is not in use, treated as if EOF was read.
+This can be used to tell fast-import to finish early.
+
+If the `--done` command line option or `feature done` command is
+in use, the `done` command is mandatory and marks the end of the
+stream.
+
Crash Reports
-------------
If fast-import is supplied invalid input it will terminate with a