Builtin-ify git-notes
[git/jrn.git] / Documentation / git-notes.txt
blob0d1ada6a0ced4ad0d1df8e32b34eedc7d463547d
1 git-notes(1)
2 ============
4 NAME
5 ----
6 git-notes - Add/inspect commit notes
8 SYNOPSIS
9 --------
10 [verse]
11 'git notes' (edit [-F <file> | -m <msg>] | show) [commit]
13 DESCRIPTION
14 -----------
15 This command allows you to add notes to commit messages, without
16 changing the commit.  To discern these notes from the message stored
17 in the commit object, the notes are indented like the message, after
18 an unindented line saying "Notes:".
20 To disable commit notes, you have to set the config variable
21 core.notesRef to the empty string.  Alternatively, you can set it
22 to a different ref, something like "refs/notes/bugzilla".  This setting
23 can be overridden by the environment variable "GIT_NOTES_REF".
26 SUBCOMMANDS
27 -----------
29 edit::
30         Edit the notes for a given commit (defaults to HEAD).
32 show::
33         Show the notes for a given commit (defaults to HEAD).
36 OPTIONS
37 -------
38 -m <msg>::
39         Use the given note message (instead of prompting).
40         If multiple `-m` options are given, their values
41         are concatenated as separate paragraphs.
43 -F <file>::
44         Take the note message from the given file.  Use '-' to
45         read the note message from the standard input.
48 Author
49 ------
50 Written by Johannes Schindelin <johannes.schindelin@gmx.de>
52 Documentation
53 -------------
54 Documentation by Johannes Schindelin
56 GIT
57 ---
58 Part of the linkgit:git[7] suite