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

[PATCH] docs: improve the example that illustrates git-notes path names

From
Noam Yorav-Raphael via GitGitGadget <gitgitgadget@gmail.com>
Date
Aug 3, 2020, 14:43 UTC
Message-ID
<pull.692.git.1596465817121.gitgitgadget@gmail.com>
From: Noam Yorav-Raphael <noamraph@gmail.com>
The existing git-notes doc says:
> Permitted pathnames have the form ab/cd/ef/…​/abcdef…​: a sequence of
> directory names of two hexadecimal digits each followed by a filename
> with the rest of the object ID.

Even though the text says that the filename has the rest of the object ID, I felt the need to check this, since the example gives the impression that the filename is the entire object ID (a schema which is quite prevalent).

The new example makes it clear that the filename has only the rest of the object ID, and not the entire object ID.

Signed-off-by: Noam Yorav-Raphael <noamraph@gmail.com>
---
    Improve the example that illustrates git-notes path names
    
    The existing git-notes doc says:
    
    > Permitted pathnames have the form ab/cd/ef/…​/abcdef…​: a sequence of
    > directory names of two hexadecimal digits each followed by a filename
    > with the rest of the object ID.
    
    Even though the text says that the filename has the rest of the object
    ID, I felt the need to check this, since the example gives the
    impression that the filename is the entire object ID (a schema which is
    quite prevalent).
    
    The new example makes it clear that the filename has only the rest of
    the object ID, and not the entire object ID.
Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-692%2Fnoamraph%2Fclearer-notes-path-doc-v1
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-692/noamraph/clearer-notes-path-doc-v1
Pull-Request: https://github.com/gitgitgadget/git/pull/692
 Documentation/git-notes.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Documentation/git-notes.txt b/Documentation/git-notes.txt
index ced2e8280e..9fc1979531 100644
--- a/Documentation/git-notes.txt
+++ b/Documentation/git-notes.txt
@@ -223,7 +223,7 @@ are taken from notes refs.  A notes ref is usually a branch which
 contains "files" whose paths are the object names for the objects
 they describe, with some directory separators included for performance
 reasons footnote:[Permitted pathnames have the form
-'ab'`/`'cd'`/`'ef'`/`'...'`/`'abcdef...': a sequence of directory
+'12'`/`'34'`/`'56'`/`'...'`/`'789abc...': a sequence of directory
 names of two hexadecimal digits each followed by a filename with the
 rest of the object ID.].
 

base-commit: 85b4e0a6dc8407de6f69808d9ee6debdf167ced3
-- 
gitgitgadget
Next: Taylor Blau
Message 1 of 9 in “docs: improve the example that illustrates git-notes path names”
  1. docs: improve the example that illustrates git-notes path namesNoam Yorav-Raphael via GitGitGadget, Aug 3, 2020
  2. Taylor BlauAug 3, 2020
  3. Junio C HamanoAug 3, 2020
  4. Taylor BlauAug 3, 2020
  5. docs: improve the example that illustrates git-notes path namesNoam Yorav-Raphael via GitGitGadget, Aug 3, 2020
  6. Taylor BlauAug 3, 2020
  7. docs: improve the example that illustrates git-notes path namesNoam Yorav-Raphael via GitGitGadget, Aug 3, 2020
  8. Taylor BlauAug 3, 2020
  9. Junio C HamanoAug 3, 2020

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.