d9246d4303
The "-m" and "-F" options are already the established method (in both git-commit and git-tag) to specify a commit/tag message without invoking the editor. This patch teaches "git notes edit" to respect the same options for specifying a notes message without invoking the editor. Multiple "-m" and/or "-F" options are concatenated as separate paragraphs. The patch also updates the "git notes" documentation and adds selftests for the new functionality. Unfortunately, the added selftests include a couple of lines with trailing whitespace (without these the test will fail). This may cause git to warn about "whitespace errors". This patch has been improved by the following contributions: - Thomas Rast: fix trailing whitespace in t3301 Signed-off-by: Johan Herland <johan@herland.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
61 lines
1.4 KiB
Plaintext
61 lines
1.4 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` (or `-F`) 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.
|
|
If multiple `-F` (or `-m`) options are given, their
|
|
values are concatenated as separate paragraphs.
|
|
|
|
|
|
Author
|
|
------
|
|
Written by Johannes Schindelin <johannes.schindelin@gmx.de>
|
|
|
|
Documentation
|
|
-------------
|
|
Documentation by Johannes Schindelin
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[7] suite
|