cd067d3bf4
The builtin-ification includes some minor behavioural changes to the command-line interface: It is no longer allowed to mix the -m and -F arguments, and it is not allowed to use multiple -F options. As part of the builtin-ification, we add the commit_notes() function to the builtin API. This function (together with the notes.h API) can be easily used from other builtins to manipulate the notes tree. Also includes needed changes to t3301. This patch has been improved by the following contributions: - Stephen Boyd: Use die() instead of fprintf(stderr, ...) followed by exit(1) Cc: Stephen Boyd <bebarino@gmail.com> Signed-off-by: Johan Herland <johan@herland.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
59 lines
1.3 KiB
Plaintext
59 lines
1.3 KiB
Plaintext
git-notes(1)
|
|
============
|
|
|
|
NAME
|
|
----
|
|
git-notes - Add/inspect commit notes
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'git notes' (edit [-F <file> | -m <msg>] | show) [commit]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This command allows you to add notes to commit messages, without
|
|
changing the commit. To discern these notes from the message stored
|
|
in the commit object, the notes are indented like the message, after
|
|
an unindented line saying "Notes:".
|
|
|
|
To disable commit notes, you have to set the config variable
|
|
core.notesRef to the empty string. Alternatively, you can set it
|
|
to a different ref, something like "refs/notes/bugzilla". This setting
|
|
can be overridden by the environment variable "GIT_NOTES_REF".
|
|
|
|
|
|
SUBCOMMANDS
|
|
-----------
|
|
|
|
edit::
|
|
Edit the notes for a given commit (defaults to HEAD).
|
|
|
|
show::
|
|
Show the notes for a given commit (defaults to HEAD).
|
|
|
|
|
|
OPTIONS
|
|
-------
|
|
-m <msg>::
|
|
Use the given note message (instead of prompting).
|
|
If multiple `-m` options are given, their values
|
|
are concatenated as separate paragraphs.
|
|
|
|
-F <file>::
|
|
Take the note message from the given file. Use '-' to
|
|
read the note message from the standard input.
|
|
|
|
|
|
Author
|
|
------
|
|
Written by Johannes Schindelin <johannes.schindelin@gmx.de>
|
|
|
|
Documentation
|
|
-------------
|
|
Documentation by Johannes Schindelin
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[7] suite
|