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

Undocumented git-diff syntax

From
YDYann Dirson <dirson@bertin.fr>
Date
Oct 11, 2010, 13:03 UTC
Message-ID
<20101011150342.292ad725@chalon.bertin.fr>

When trying "just to see it it would work", I noticed that the following syntax appears to do what it looks like it should do.

git diff v1.7.3-rc0:Documentation/RelNotes-1.7.3.txt v1.7.3:Documentation/RelNotes/1.7.3.txt

It is a useful thing, but I could not find described in the manpage. I have not dig this part of diff yet, and maybe someone would have already a description of it (does it simply allow to diff two arbitrary blobs ?). Is it here just by some magic side-effect ? :)

Another thought: if we can already compare arbitrary blobs, maybe it would not be so hard to extend it to take arbitrary contents that are not stored as blobs yet ? (a quick hack would be to insert an object for them, but that does not look too clean...). As a use-case, I'm often found generating diffs from within custom scripts, from contents derived from a git repo, but can't use all the bells and whistles (--color, --color-words, etc), just because I have to use plain diff; that makes the output of those scripts very inconsistent with native git commands.

Would there be any objections to moving into that direction ?
-- 
Yann Dirson - Bertin Technologies
Next: Santi Béjar
Message 1 of 15 in “Undocumented git-diff syntax”
  1. Yann DirsonOct 11, 2010
  2. Santi BéjarOct 11, 2010
  3. Yann DirsonOct 11, 2010
  4. Santi BéjarOct 11, 2010
  5. 0/4 Re: Undocumented git-diff syntaxJonathan Nieder, Oct 11, 2010
  6. 1/5 Documentation: gitrevisions is in section 7Jonathan Nieder, Oct 11, 2010
  7. Sverre RabbelierOct 11, 2010
  8. 2/4 Documentation: diff can compare blobsJonathan Nieder, Oct 11, 2010
  9. 3/4 Documentation: expand 'git diff' SEE ALSO sectionJonathan Nieder, Oct 11, 2010
  10. 4/4 Documentation: update "git diff --no-index" descriptionJonathan Nieder, Oct 11, 2010
  11. 5/4 Documentation: flesh out diff --no-index descriptionJonathan Nieder, Oct 11, 2010
  12. Junio C HamanoOct 13, 2010
  13. Yann DirsonOct 11, 2010
  14. Sverre RabbelierOct 11, 2010
  15. Jakub NarebskiOct 11, 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.