From: Thomas Rast Date: Fri, 12 Mar 2010 17:04:37 +0000 (+0100) Subject: git-notes(1): add a section about the meaning of history X-Git-Tag: v1.7.1-rc0~37^2~1 X-Git-Url: https://git.tokkee.org/?a=commitdiff_plain;h=66d681998411e8e5034080d5267a5e0f6cdc0c17;p=git.git git-notes(1): add a section about the meaning of history To the displaying code, the only interesting thing about a notes ref is that it has a tree of the required format. However, notes actually have a history since they are recorded as successive commits. Make a note about the existence of this history in the manpage, but keep some doors open if we want to change the details. Signed-off-by: Thomas Rast Acked-by: Johan Herland Signed-off-by: Junio C Hamano --- diff --git a/Documentation/git-notes.txt b/Documentation/git-notes.txt index dbfa1e88e..e2701cff1 100644 --- a/Documentation/git-notes.txt +++ b/Documentation/git-notes.txt @@ -121,6 +121,20 @@ OPTIONS GIT_NOTES_REF and the "core.notesRef" configuration. The ref is taken to be in `refs/notes/` if it is not qualified. + +NOTES +----- + +Every notes change creates a new commit at the specified notes ref. +You can therefore inspect the history of the notes by invoking, e.g., +`git log -p notes/commits`. + +Currently the commit message only records which operation triggered +the update, and the commit authorship is determined according to the +usual rules (see linkgit:git-commit[1]). These details may change in +the future. + + Author ------ Written by Johannes Schindelin and