d6576e1fe3
"git notes prune" will remove all notes that annotate unreachable/non- existing objects. The patch includes tests verifying correct behaviour of the new subcommand. Suggested-by: Junio C Hamano <gitster@pobox.com> Signed-off-by: Johan Herland <johan@herland.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
66 lines
1.5 KiB
Plaintext
66 lines
1.5 KiB
Plaintext
git-notes(1)
|
|
============
|
|
|
|
NAME
|
|
----
|
|
git-notes - Add/inspect commit notes
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'git notes' (edit [-F <file> | -m <msg>] | show | remove | prune) [commit]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This command allows you to add/remove notes to/from 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).
|
|
|
|
remove::
|
|
Remove the notes for a given commit (defaults to HEAD).
|
|
This is equivalent to specifying an empty note message to
|
|
the `edit` subcommand.
|
|
|
|
prune::
|
|
Remove all notes for non-existing/unreachable objects.
|
|
|
|
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
|