X-Git-Url: http://git.tremily.us/?a=blobdiff_plain;f=notes.c;h=bc454e1eab2b0e1d264cee7bb1f84bdb3bb14237;hb=refs%2Fheads%2Fwtk%2Fsubmodule-doc-fixup;hp=93e9868d5d1aa536b70e981d3a4cd3c7969764d3;hpb=cd82e584707bffdbb9553c6140e9a8fef130e5b8;p=git.git

diff --git a/notes.c b/notes.c
index 93e9868d5..bc454e1ea 100644
--- a/notes.c
+++ b/notes.c
@@ -1196,8 +1196,18 @@ void free_notes(struct notes_tree *t)
 	memset(t, 0, sizeof(struct notes_tree));
 }
 
-void format_note(struct notes_tree *t, const unsigned char *object_sha1,
-		struct strbuf *sb, const char *output_encoding, int flags)
+/*
+ * Fill the given strbuf with the notes associated with the given object.
+ *
+ * If the given notes_tree structure is not initialized, it will be auto-
+ * initialized to the default value (see documentation for init_notes() above).
+ * If the given notes_tree is NULL, the internal/default notes_tree will be
+ * used instead.
+ *
+ * 'flags' is a bitwise combination of the flags for format_display_notes.
+ */
+static void format_note(struct notes_tree *t, const unsigned char *object_sha1,
+			struct strbuf *sb, const char *output_encoding, int flags)
 {
 	static const char utf8[] = "utf-8";
 	const unsigned char *sha1;