Documentation/git-remote-helpers: explain how import works with multiple refs

This is important for two reasons:

* when two "import" lines follow each other, only one "done" command
  should be issued in the fast-import stream, not one per "import".

* The blank line terminating an import command should not be confused
  with the one terminating the sequence of commands.

While we're there, illustrate the corresponding explanation for push
batches with an example.

Signed-off-by: Matthieu Moy <Matthieu.Moy@imag.fr>
Acked-by: Sverre Rabbelier <srabbelier@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
1 file changed
tree: e2bed2cbd31786075fb3ee87d530a1f4a6174fee
  1. block-sha1/
  2. builtin/
  3. compat/
  4. contrib/
  5. Documentation/
  6. git-gui/
  7. git_remote_helpers/
  8. gitk-git/
  9. gitweb/
  10. mergetools/
  11. perl/
  12. po/
  13. ppc/
  14. t/
  15. templates/
  16. vcs-svn/
  17. xdiff/
  18. .gitattributes
  19. .gitignore
  20. .mailmap
  21. abspath.c
  22. aclocal.m4
  23. advice.c
  24. advice.h
  25. alias.c
  26. alloc.c
  27. archive-tar.c
  28. archive-zip.c
  29. archive.c
  30. archive.h
  31. attr.c
  32. attr.h
  33. base85.c
  34. bisect.c
  35. bisect.h
  36. blob.c
  37. blob.h
  38. branch.c
  39. branch.h
  40. builtin.h
  41. bundle.c
  42. bundle.h
  43. cache-tree.c
  44. cache-tree.h
  45. cache.h
  46. check-builtins.sh
  47. check-racy.c
  48. check_bindir
  49. color.c
  50. color.h
  51. combine-diff.c
  52. command-list.txt
  53. commit.c
  54. commit.h
  55. config.c
  56. config.mak.in
  57. configure.ac
  58. connect.c
  59. convert.c
  60. convert.h
  61. copy.c
  62. COPYING
  63. csum-file.c
  64. csum-file.h
  65. ctype.c
  66. daemon.c
  67. date.c
  68. decorate.c
  69. decorate.h
  70. delta.h
  71. diff-delta.c
  72. diff-lib.c
  73. diff-no-index.c
  74. diff.c
  75. diff.h
  76. diffcore-break.c
  77. diffcore-delta.c
  78. diffcore-order.c
  79. diffcore-pickaxe.c
  80. diffcore-rename.c
  81. diffcore.h
  82. dir.c
  83. dir.h
  84. editor.c
  85. entry.c
  86. environment.c
  87. exec_cmd.c
  88. exec_cmd.h
  89. fast-import.c
  90. fetch-pack.h
  91. fixup-builtins
  92. fsck.c
  93. fsck.h
  94. generate-cmdlist.sh
  95. gettext.c
  96. gettext.h
  97. git-add--interactive.perl
  98. git-am.sh
  99. git-archimport.perl
  100. git-bisect.sh
  101. git-compat-util.h
  102. git-cvsexportcommit.perl
  103. git-cvsimport.perl
  104. git-cvsserver.perl
  105. git-difftool--helper.sh
  106. git-difftool.perl
  107. git-filter-branch.sh
  108. git-instaweb.sh
  109. git-lost-found.sh
  110. git-merge-octopus.sh
  111. git-merge-one-file.sh
  112. git-merge-resolve.sh
  113. git-mergetool--lib.sh
  114. git-mergetool.sh
  115. git-parse-remote.sh
  116. git-pull.sh
  117. git-quiltimport.sh
  118. git-rebase--am.sh
  119. git-rebase--interactive.sh
  120. git-rebase--merge.sh
  121. git-rebase.sh
  122. git-relink.perl
  123. git-remote-testgit.py
  124. git-repack.sh
  125. git-request-pull.sh
  126. git-send-email.perl
  127. git-sh-i18n.sh
  128. git-sh-setup.sh
  129. git-stash.sh
  130. git-submodule.sh
  131. git-svn.perl
  132. GIT-VERSION-GEN
  133. git-web--browse.sh
  134. git.c
  135. git.spec.in
  136. graph.c
  137. graph.h
  138. grep.c
  139. grep.h
  140. hash.c
  141. hash.h
  142. help.c
  143. help.h
  144. hex.c
  145. http-backend.c
  146. http-fetch.c
  147. http-push.c
  148. http-walker.c
  149. http.c
  150. http.h
  151. ident.c
  152. imap-send.c
  153. INSTALL
  154. levenshtein.c
  155. levenshtein.h
  156. LGPL-2.1
  157. list-objects.c
  158. list-objects.h
  159. ll-merge.c
  160. ll-merge.h
  161. lockfile.c
  162. log-tree.c
  163. log-tree.h
  164. mailmap.c
  165. mailmap.h
  166. Makefile
  167. match-trees.c
  168. merge-file.c
  169. merge-file.h
  170. merge-recursive.c
  171. merge-recursive.h
  172. name-hash.c
  173. notes-cache.c
  174. notes-cache.h
  175. notes-merge.c
  176. notes-merge.h
  177. notes.c
  178. notes.h
  179. object.c
  180. object.h
  181. pack-check.c
  182. pack-refs.c
  183. pack-refs.h
  184. pack-revindex.c
  185. pack-revindex.h
  186. pack-write.c
  187. pack.h
  188. pager.c
  189. parse-options-cb.c
  190. parse-options.c
  191. parse-options.h
  192. patch-delta.c
  193. patch-ids.c
  194. patch-ids.h
  195. path.c
  196. pkt-line.c
  197. pkt-line.h
  198. preload-index.c
  199. pretty.c
  200. progress.c
  201. progress.h
  202. quote.c
  203. quote.h
  204. reachable.c
  205. reachable.h
  206. read-cache.c
  207. README
  208. reflog-walk.c
  209. reflog-walk.h
  210. refs.c
  211. refs.h
  212. remote-curl.c
  213. remote.c
  214. remote.h
  215. replace_object.c
  216. rerere.c
  217. rerere.h
  218. resolve-undo.c
  219. resolve-undo.h
  220. revision.c
  221. revision.h
  222. run-command.c
  223. run-command.h
  224. send-pack.h
  225. server-info.c
  226. setup.c
  227. sh-i18n--envsubst.c
  228. sha1-array.c
  229. sha1-array.h
  230. sha1-lookup.c
  231. sha1-lookup.h
  232. sha1_file.c
  233. sha1_name.c
  234. shallow.c
  235. shell.c
  236. shortlog.h
  237. show-index.c
  238. sideband.c
  239. sideband.h
  240. sigchain.c
  241. sigchain.h
  242. strbuf.c
  243. strbuf.h
  244. streaming.c
  245. streaming.h
  246. string-list.c
  247. string-list.h
  248. submodule.c
  249. submodule.h
  250. symlinks.c
  251. tag.c
  252. tag.h
  253. tar.h
  254. test-chmtime.c
  255. test-ctype.c
  256. test-date.c
  257. test-delta.c
  258. test-dump-cache-tree.c
  259. test-genrandom.c
  260. test-index-version.c
  261. test-line-buffer.c
  262. test-match-trees.c
  263. test-mktemp.c
  264. test-obj-pool.c
  265. test-parse-options.c
  266. test-path-utils.c
  267. test-run-command.c
  268. test-sha1.c
  269. test-sha1.sh
  270. test-sigchain.c
  271. test-string-pool.c
  272. test-subprocess.c
  273. test-svn-fe.c
  274. test-treap.c
  275. thread-utils.c
  276. thread-utils.h
  277. trace.c
  278. transport-helper.c
  279. transport.c
  280. transport.h
  281. tree-diff.c
  282. tree-walk.c
  283. tree-walk.h
  284. tree.c
  285. tree.h
  286. unimplemented.sh
  287. unpack-trees.c
  288. unpack-trees.h
  289. upload-pack.c
  290. url.c
  291. url.h
  292. usage.c
  293. userdiff.c
  294. userdiff.h
  295. utf8.c
  296. utf8.h
  297. walker.c
  298. walker.h
  299. wrap-for-bin.sh
  300. wrapper.c
  301. write_or_die.c
  302. ws.c
  303. wt-status.c
  304. wt-status.h
  305. xdiff-interface.c
  306. xdiff-interface.h
  307. zlib.c