[PATCH 2/4] Documentation/notes: adjust description to use configuration section
- From
Jonathan Nieder <jrnieder@gmail.com>
- Date
- May 3, 2010, 23:42 UTC
- Message-ID
- <20100503234209.GB27483@progeny.tock>
- In-Reply-To
- <20100503233604.GA27451@progeny.tock>
Introduce the default notes ref early on to give the reader a frame of reference for understanding the rest of the description.
Cc: Johan Herland <johan@herland.net> Signed-off-by: Jonathan Nieder <jrnieder@gmail.com> --- Documentation/git-notes.txt | 14 ++++++-------- 1 files changed, 6 insertions(+), 8 deletions(-)
diff --git a/Documentation/git-notes.txt b/Documentation/git-notes.txt index b26598e..0594776 100644 --- a/Documentation/git-notes.txt +++ b/Documentation/git-notes.txt @@ -23,6 +23,10 @@ DESCRIPTION This command allows you to add/remove notes to/from objects, without changing the objects themselves. +By default, notes are saved to and read from `refs/notes/commits`, but +this default can be overridden. See the CONFIGURATION and ENVIRONMENT +sections below. + A typical use of notes is to extend a commit message without having to change the commit itself. Such commit notes can be shown by `git log` along with the original commit message. To discern these notes from the @@ -30,14 +34,8 @@ message stored in the commit object, the notes are indented like the message, after an unindented line saying "Notes (<refname>):" (or "Notes:" for the default setting). -This command always manipulates the notes specified in "core.notesRef" -(see linkgit:git-config[1]), which can be overridden by GIT_NOTES_REF. -To change which notes are shown by 'git-log', see the -"notes.displayRef" configuration. - -See the description of "notes.rewrite.<command>" in -linkgit:git-config[1] for a way of carrying your notes across commands -that rewrite commits. +See the "notes.rewrite.<command>" configuration for a way of carrying +notes across commands that rewrite commits. SUBCOMMANDS
-- 1.7.1