From: Michael Haggerty <mhagger@alum.mit.edu>
Date: Wed, 30 Oct 2013 05:32:56 +0000 (+0100)
Subject: get_expanded_map(): add docstring
X-Git-Tag: v1.9-rc0~79^2~16
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=f166db26af524278b42caac8f092d8de5e3e9c29;p=thirdparty%2Fgit.git

get_expanded_map(): add docstring

Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
---

diff --git a/remote.c b/remote.c
index e9fedfa918..bef81cdb6c 100644
--- a/remote.c
+++ b/remote.c
@@ -1553,6 +1553,13 @@ static int ignore_symref_update(const char *refname)
 	return (flag & REF_ISSYMREF);
 }
 
+/*
+ * Create and return a list of (struct ref) consisting of copies of
+ * each remote_ref that matches refspec.  refspec must be a pattern.
+ * Fill in the copies' peer_ref to describe the local tracking refs to
+ * which they map.  Omit any references that would map to an existing
+ * local symbolic ref.
+ */
 static struct ref *get_expanded_map(const struct ref *remote_refs,
 				    const struct refspec *refspec)
 {