Notes API: add_note(): Add note objects to the internal notes tree structure

[git.git] / notes.h

diff --git a/notes.h b/notes.h
index d745ed12da5a412c78d7e97a65b66210930ae976..5f2285217e994e1bf6fec2a0fa651a8aff417a93 100644 (file)
--- a/notes.h
+++ b/notes.h
@@ -1,6 +1,30 @@
 #ifndef NOTES_H
 #define NOTES_H
 
+/*
+ * Flags controlling behaviour of notes tree initialization
+ *
+ * Default behaviour is to initialize the notes tree from the tree object
+ * specified by the given (or default) notes ref.
+ */
+#define NOTES_INIT_EMPTY 1
+
+/*
+ * Initialize internal notes tree structure with the notes tree at the given
+ * ref. If given ref is NULL, the value of the $GIT_NOTES_REF environment
+ * variable is used, and if that is missing, the default notes ref is used
+ * ("refs/notes/commits").
+ *
+ * If you need to re-intialize the internal notes tree structure (e.g. loading
+ * from a different notes ref), please first de-initialize the current notes
+ * tree by calling free_notes().
+ */
+void init_notes(const char *notes_ref, int flags);
+
+/* Add the given note object to the internal notes tree structure */
+void add_note(const unsigned char *object_sha1,
+               const unsigned char *note_sha1);
+
 /* Free (and de-initialize) the internal notes tree structure */
 void free_notes(void);