[PATCH v10 04/12] refs: document how ref_iterator_advance_fn should handle symrefs

From

Han-Wen Nienhuys via GitGitGadget <gitgitgadget@gmail.com>

Date

Apr 27, 2020, 20:13 UTC

Message-ID

<fd67cdff0cd74bd9d9bc504976a642a89dbb1e3b.1588018418.git.gitgitgadget@gmail.com>

In-Reply-To

<pull.539.v10.git.1588018418.gitgitgadget@gmail.com>

From: Han-Wen Nienhuys <hanwen@google.com>

Signed-off-by: Han-Wen Nienhuys <hanwen@google.com>
---
 refs/refs-internal.h | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/refs/refs-internal.h b/refs/refs-internal.h
index ff2436c0fb7..3490aac3a40 100644
--- a/refs/refs-internal.h
+++ b/refs/refs-internal.h
@@ -438,6 +438,11 @@ void base_ref_iterator_free(struct ref_iterator *iter);
 
 /* Virtual function declarations for ref_iterators: */
 
+/*
+ * backend-specific implementation of ref_iterator_advance.
+ * For symrefs, the function should set REF_ISSYMREF, and it should also
+ * dereference the symref to provide the OID referent.
+ */
 typedef int ref_iterator_advance_fn(struct ref_iterator *ref_iterator);
 
 typedef int ref_iterator_peel_fn(struct ref_iterator *ref_iterator,

-- 
gitgitgadget