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

Re: [PATCH 1/5] check-ref-format doc: de-emphasize the implementation detail of a ref

From
Eric Sunshine <sunshine@sunshineco.com>
Date
Jun 23, 2011, 22:14 UTC
Message-ID
<4E03BACA.8000303@sunshineco.com>
In-Reply-To
<1308847958-3429-2-git-send-email-gitster@pobox.com>
On 6/23/2011 12:52 PM, Junio C Hamano wrote:
Show 5 quoted lines
>   A reference is used in git to specify branches and tags.  A
> -branch head is stored under the `$GIT_DIR/refs/heads` directory, and
> -a tag is stored under the `$GIT_DIR/refs/tags` directory (or, if refs
> -are packed by `git gc`, as entries in the `$GIT_DIR/packed-refs` file).
> +branch head is stored in the `refs/heads` hierarchy while
s/hierarchy while/hierarchy, while/
> +a tag is stored in the `refs/tags` hierarchy of the ref namespace
> +(which are found in `$GIT_DIR/refs/heads` and `$GIT_DIR/refs/tags`
> +directories or, if refs are packed by `git gc`, as entries in
> +the `$GIT_DIR/packed-refs` file).

Grammatical complexity of parenthetical comment makes it a bit difficult to read. Perhaps simplify as:

   (typically in `$GIT_DIR/refs/heads` and `$GIT_DIR/refs/tags`
   directories, or as entries in file `$GIT_DIR/packed-refs`
   if refs are packed by `git gc`).
-- ES
Previous: Junio C HamanoNext: Junio C Hamano
Message 9 of 16 in “git-remote.txt: fix wrong remote refspec”
  1. git-remote.txt: fix wrong remote refspecNamhyung Kim, Jun 23, 2011
  2. Junio C HamanoJun 23, 2011
  3. Namhyung KimJun 23, 2011
  4. git-remote.txt: fix wrong remote refspecNamhyung Kim, Jun 23, 2011
  5. Junio C HamanoJun 23, 2011
  6. Namhyung KimJun 23, 2011
  7. 0/5 Clarify "refs"Junio C Hamano, Jun 23, 2011
  8. 1/5 check-ref-format doc: de-emphasize the implementation detail of a refJunio C Hamano, Jun 23, 2011
  9. Eric SunshineJun 23, 2011
  10. 2/5 git.txt: de-emphasize the implementation detail of a refJunio C Hamano, Jun 23, 2011
  11. 3/5 glossary: update description of "tag"Junio C Hamano, Jun 23, 2011
  12. Eric SunshineJun 23, 2011
  13. 4/5 glossary: update description of head and refJunio C Hamano, Jun 23, 2011
  14. 5/5 glossary: clarify description of HEADJunio C Hamano, Jun 23, 2011
  15. Carlos Martín NietoJun 23, 2011
  16. Junio C HamanoJun 23, 2011

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.