git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH] doc: Clarify which objects notes can be attached to

From
Sebastian Schuberth <sschuberth@gmail.com>
Date
Apr 4, 2016, 08:37 UTC
Message-ID
<570227DA.6040808@gmail.com>
In-Reply-To
<CAHGBnuP71qpOoNAAwXE-nbPbVyK56Up0YpmhhjC5430VwW73kQ@mail.gmail.com>

Explicitly name the supported object types, and ensure patches cannot be misinterpreted as non-objects that can have notes attached.

Signed-off-by: Sebastian Schuberth <sschuberth@gmail.com>
---
 Documentation/git-notes.txt | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)
diff --git a/Documentation/git-notes.txt b/Documentation/git-notes.txt
index 8de3499..101e6ba 100644
--- a/Documentation/git-notes.txt
+++ b/Documentation/git-notes.txt
@@ -25,7 +25,8 @@ SYNOPSIS
 DESCRIPTION
 -----------
 Adds, removes, or reads notes attached to objects, without touching
-the objects themselves.
+the objects themselves.  Supported objects are commits, blobs, trees
+and annotated tags.
 
 By default, notes are saved to and read from `refs/notes/commits`, but
 this default can be overridden.  See the OPTIONS, CONFIGURATION, and
@@ -39,9 +40,9 @@ message stored in the commit object, the notes are indented like the
 message, after an unindented line saying "Notes (<refname>):" (or
 "Notes:" for `refs/notes/commits`).
 
-Notes can also be added to patches prepared with `git format-patch` by
-using the `--notes` option. Such notes are added as a patch commentary
-after a three dash separator line.
+Notes contents can also be included in patches prepared with
+`git format-patch` by using the `--notes` option. Such notes are added
+as a patch commentary after a three dash separator line.
 
 To change which notes are shown by 'git log', see the
 "notes.displayRef" configuration in linkgit:git-log[1].
-- 
2.8.0.windows.1
Previous: Sebastian SchuberthNext: Junio C Hamano
Message 5 of 8 in “doc: clarify that notes can be attached to any type of stored object”
  1. doc: clarify that notes can be attached to any type of stored objectSebastian Schuberth, Apr 1, 2016
  2. Junio C HamanoApr 1, 2016
  3. Junio C HamanoApr 1, 2016
  4. Sebastian SchuberthApr 4, 2016
  5. doc: Clarify which objects notes can be attached toSebastian Schuberth, Apr 4, 2016
  6. Junio C HamanoApr 4, 2016
  7. Sebastian SchuberthApr 4, 2016
  8. Junio C HamanoApr 4, 2016

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.