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

[PATCH/RFC] Documentation: add a FILES section for show-ref

From
Jonathan Nieder <jrnieder@gmail.com>
Date
Aug 9, 2010, 01:32 UTC
Message-ID
<20100809013243.GA9385@burratino>
In-Reply-To
<AANLkTi=J3tDnZUg3k5bzDk2ydzYVVLKLwoW0gpBypYAs@mail.gmail.com>

A peek at where the refs are kept might help understanding, even if, as the DESCRIPTION section suggests, direct access is not part of the public API.

Balance that out with a pointer to update-ref.
Suggested-by: Geoff Russell <geoffrey.russell@gmail.com>
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
---
 Documentation/git-show-ref.txt |    7 ++++++-
 1 files changed, 6 insertions(+), 1 deletions(-)
diff --git a/Documentation/git-show-ref.txt b/Documentation/git-show-ref.txt
index 3f9d9c6..3fe961d 100644
--- a/Documentation/git-show-ref.txt
+++ b/Documentation/git-show-ref.txt
@@ -163,9 +163,15 @@ flag, so you can do
 
 to get a listing of all tags together with what they dereference.
 
+FILES
+-----
+`.git/refs/*`, `.git/packed-refs`
+
 SEE ALSO
 --------
-linkgit:git-ls-remote[1]
+linkgit:git-ls-remote[1],
+linkgit:git-update-ref[1],
+linkgit:gitrepository-layout[5]
 
 AUTHORS
 -------
-- 
1.7.2.1.544.ga752d.dirty
Previous: Jonathan NiederNext: Junio C Hamano
Message 10 of 11 in “understanding how remote tracking works”
  1. Geoff RussellAug 9, 2010
  2. Ralf EbertAug 9, 2010
  3. Geoff RussellAug 9, 2010
  4. Michael WittenAug 9, 2010
  5. Jonathan NiederAug 9, 2010
  6. Geoff RussellAug 9, 2010
  7. Junio C HamanoAug 9, 2010
  8. Jonathan NiederAug 9, 2010
  9. discarding refs/original/* after filter-branch (Re: understanding how remote tracking works)Jonathan Nieder, Aug 9, 2010
  10. Documentation: add a FILES section for show-refJonathan Nieder, Aug 9, 2010
  11. Junio C HamanoAug 9, 2010

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.