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

Re: [PATCH 5/5] git-diff.txt: fix ordering of the [--no-index] form

From
Junio C Hamano <gitster@pobox.com>
Date
Apr 24, 2013, 18:25 UTC
Message-ID
<7vmwsndbve.fsf@alter.siamese.dyndns.org>
In-Reply-To
<1366821216-20868-6-git-send-email-artagnon@gmail.com>
Ramkumar Ramachandra <artagnon@gmail.com> writes:
> The SYNOPSIS lists the [--no-index] form as the last item, but the
> DESCRIPTION lists it as a natural extension of the first form.
Perhaps either the description or your reading is wrong.

The "--no-index" mode was a hack to allow "git diff" goodies to be used outside the context of "git", and a proper execution of it should have been to send patches to GNU or BSD diff maintainers, not to add the "--no-index" option that is unrelated to "git" to our code.

I think it is more correct to list it as a footnote and list separately from the main text, which is what the original SYNOPSIS section does.

Previous: Ramkumar RamachandraNext: Ramkumar Ramachandra
Message 19 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.