X-Git-Url: http://git.tremily.us/?a=blobdiff_plain;f=transport-helper.c;h=cfe098849022fcc56bcb1a57d00e4c89e753492b;hb=df995c7dd21bca9c61f9e5480fdfc1a015b4f1a0;hp=61c928f6cd85aa9cf60942208423e615c9b99352;hpb=10a32fa95466f0c16531fe9b3d3f9a190f90f5f2;p=git.git

diff --git a/transport-helper.c b/transport-helper.c
index 61c928f6c..cfe098849 100644
--- a/transport-helper.c
+++ b/transport-helper.c
@@ -444,6 +444,21 @@ static int fetch_with_import(struct transport *transport,
 	free(fastimport.argv);
 	fastimport.argv = NULL;
 
+	/*
+	 * The fast-import stream of a remote helper that advertises
+	 * the "refspec" capability writes to the refs named after the
+	 * right hand side of the first refspec matching each ref we
+	 * were fetching.
+	 *
+	 * (If no "refspec" capability was specified, for historical
+	 * reasons we default to *:*.)
+	 *
+	 * Store the result in to_fetch[i].old_sha1.  Callers such
+	 * as "git fetch" can use the value to write feedback to the
+	 * terminal, populate FETCH_HEAD, and determine what new value
+	 * should be written to peer_ref if the update is a
+	 * fast-forward or this is a forced update.
+	 */
 	for (i = 0; i < nr_heads; i++) {
 		char *private;
 		posn = to_fetch[i];