From: Johan Herland Date: Tue, 9 Nov 2010 21:49:38 +0000 (+0100) Subject: (trivial) notes.h: Minor documentation fixes to copy_notes() X-Git-Tag: v1.7.4-rc0~82^2~21 X-Git-Url: https://git.tokkee.org/?a=commitdiff_plain;h=55d060771a15f4ce75e71b966d8117d8a32cc47b;p=git.git (trivial) notes.h: Minor documentation fixes to copy_notes() Signed-off-by: Johan Herland Signed-off-by: Junio C Hamano --- diff --git a/notes.h b/notes.h index 65fc3a66b..c0288b0d3 100644 --- a/notes.h +++ b/notes.h @@ -104,6 +104,10 @@ const unsigned char *get_note(struct notes_tree *t, * Copy a note from one object to another in the given notes_tree. * * Fails if the to_obj already has a note unless 'force' is true. + * + * IMPORTANT: The changes made by copy_note() to the given notes_tree structure + * are not persistent until a subsequent call to write_notes_tree() returns + * zero. */ int copy_note(struct notes_tree *t, const unsigned char *from_obj, const unsigned char *to_obj, @@ -149,6 +153,7 @@ int copy_note(struct notes_tree *t, * notes tree) from within the callback: * - add_note() * - remove_note() + * - copy_note() * - free_notes() */ typedef int each_note_fn(const unsigned char *object_sha1,