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

Re: [PATCH] Documentation/log: clarify what --raw means

From
Junio C Hamano <gitster@pobox.com>
Date
May 15, 2015, 17:44 UTC
Message-ID
<xmqqpp61hh0x.fsf@gitster.dls.corp.google.com>
In-Reply-To
<loom.20150515T174530-547@post.gmane.org>
Ed Avis <eda@waniasset.com> writes:
> Thanks, I think that is a bit clearer.
>
> You might also need to clarify the part about --format=raw where it says
> 'SHA-1s are displayed in full, regardless of whether --abbrev or --no-abbrev'.

This part of the description being "--format" option, the "SHA-1s" the description refers to are the ones that appear in the commit object itself, something like:

    tree 2b5bfdf7798569e0b59b16eb9602d5fa572d6038
    author Linus Torvalds <torvalds@ppc970.osdl.org> 1112911993 -0700
    committer Linus Torvalds <torvalds@ppc970.osdl.org> 1112911993 -0700
    Initial revision of "git", the information manager from hell

And the commit object itself does not have any "diff", as you are not comparing anything with any other thing. It is about recording one single state in time.

I think that is what the reader needs to be made aware of, and the current documentation is not doing a good job at it.

Previous: Ed AvisNext: Eric Sunshine
Message 8 of 16 in “git log --raw abbreviates SHA1s, despite what manual says”
  1. Ed AvisMay 15, 2015
  2. Matthieu MoyMay 15, 2015
  3. Ed AvisMay 15, 2015
  4. Ed AvisMay 15, 2015
  5. Matthieu MoyMay 15, 2015
  6. Documentation/log: clarify what --raw meansMatthieu Moy, May 15, 2015
  7. Ed AvisMay 15, 2015
  8. Junio C HamanoMay 15, 2015
  9. Eric SunshineMay 15, 2015
  10. Junio C HamanoMay 15, 2015
  11. Matthieu MoyMay 18, 2015
  12. 1/2 Documentation/log: clarify what --raw meansMatthieu Moy, May 18, 2015
  13. 2/2 Documentation/log: clarify sha1 non-abbreviation in log --rawMatthieu Moy, May 18, 2015
  14. Junio C HamanoMay 18, 2015
  15. Matthieu MoyMay 18, 2015
  16. Junio C HamanoMay 18, 2015

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.