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

Re: [PATCH 3/5] git-diff.txt: group the [--] and [<path>...] templates

From
Junio C Hamano <gitster@pobox.com>
Date
Apr 24, 2013, 18:20 UTC
Message-ID
<7vtxmvdc4d.fsf@alter.siamese.dyndns.org>
In-Reply-To
<1366821216-20868-4-git-send-email-artagnon@gmail.com>
Ramkumar Ramachandra <artagnon@gmail.com> writes:
> -'git diff' [options] [--] [<path>...]::
> +'git diff' [options] [[--] [<path>...]]::
You can say
    "git diff A B --" without any path
    "git diff A B pathspec" without any double-dashes
    "git diff -- pathspec"

and all three of them are expressed by versions before or after the patch, so there is no change in the semantics introduced by this patch.

While the update might be logically more correct, it looks to me that the only end-user visibile effect of it is to make the end result harder to read.

Previous: Ramkumar RamachandraNext: Ramkumar Ramachandra
Message 9 of 39 in “Documentation/git-diff.txt improvements”
  1. 0/5 Documentation/git-diff.txt improvementsRamkumar Ramachandra, Apr 24, 2013
  2. 1/5 git-diff.txt: reorder the <commit> <commit> formRamkumar Ramachandra, Apr 24, 2013
  3. Jonathan NiederApr 24, 2013
  4. 2/5 git-diff.txt: strip the leading "--" from options templateRamkumar Ramachandra, Apr 24, 2013
  5. Jonathan NiederApr 24, 2013
  6. Ramkumar RamachandraApr 24, 2013
  7. Junio C HamanoApr 24, 2013
  8. 3/5 git-diff.txt: group the [--] and [<path>...] templatesRamkumar Ramachandra, Apr 24, 2013
  9. Junio C HamanoApr 24, 2013
  10. Ramkumar RamachandraApr 24, 2013
  11. Junio C HamanoApr 24, 2013
  12. Ramkumar RamachandraApr 24, 2013
  13. Junio C HamanoApr 24, 2013
  14. Ramkumar RamachandraApr 24, 2013
  15. Jonathan NiederApr 24, 2013
  16. 4/5 git-diff.txt: document the .. and ... forms in SYNOPSISRamkumar Ramachandra, Apr 24, 2013
  17. Jonathan NiederApr 24, 2013
  18. 5/5 git-diff.txt: fix ordering of the [--no-index] formRamkumar Ramachandra, Apr 24, 2013
  19. Junio C HamanoApr 24, 2013
  20. Ramkumar RamachandraApr 24, 2013
  21. Jonathan NiederApr 24, 2013
  22. Ramkumar RamachandraApr 24, 2013
  23. Jonathan NiederApr 24, 2013
  24. Ramkumar RamachandraApr 24, 2013
  25. Jonathan NiederApr 24, 2013
  26. Ramkumar RamachandraApr 24, 2013
  27. Jonathan NiederApr 24, 2013
  28. Ramkumar RamachandraApr 24, 2013
  29. Jonathan NiederApr 24, 2013
  30. Ramkumar RamachandraApr 24, 2013
  31. 6/5 git-diff.txt: banish the <commit>..<commit> formRamkumar Ramachandra, Apr 24, 2013
  32. Junio C HamanoApr 24, 2013
  33. Ramkumar RamachandraApr 24, 2013
  34. Ramkumar RamachandraApr 25, 2013
  35. Junio C HamanoApr 29, 2013
  36. Ramkumar RamachandraApr 29, 2013
  37. Junio C HamanoApr 29, 2013
  38. Ramkumar RamachandraApr 29, 2013
  39. Junio C HamanoApr 29, 2013

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.