Documentation/notes: describe content of notes blobs
authorJonathan Nieder <jrnieder@gmail.com>
Sun, 9 May 2010 03:21:34 +0000 (22:21 -0500)
committerJunio C Hamano <gitster@pobox.com>
Sun, 9 May 2010 05:30:02 +0000 (22:30 -0700)
commit8d6888ec6aee97f8b2b395e7e075dd00d9689c25
treed6511d9df9a552d8cb7008fb7931a2ed53b0834d
parent9eb3f816dea9fa00e7c20204516b0cb288219057
Documentation/notes: describe content of notes blobs

stripspace/text-based formatting kicks in when specifying the notes
content with -m or -F, or when an editor is used to edit the notes.
To binary-safely create notes from files, the following construct is
required:

    git notes add -C $(git hash-object -w <file>) <object>

Explain this trick (thanks, Johan!) in the manual.  Add an ordinary
example, too, to keep this esoteric one company.

Cc: Johan Herland <johan@herland.net>
Cc: Thomas Rast <trast@student.ethz.ch>
Cc: Jeff King <peff@peff.net>
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-notes.txt
t/t3307-notes-man.sh [new file with mode: 0755]