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

Re: documentation issues

From
CSChris Shoemaker <c.shoemaker@cox.net>
Date
Dec 1, 2005, 21:54 UTC
Message-ID
<20051201215424.GA13016@pe.Belkin>
In-Reply-To
<7v64q8fqm8.fsf@assigned-by-dhcp.cox.net>
On Thu, Dec 01, 2005 at 01:34:55PM -0800, Junio C Hamano wrote:
Show 6 quoted lines
> > also, git-diff-index supports a "-r" option, but that doesn't seem to be 
> > documented on this page.
> 
> What Chris Shoemaker said is right.
> 
> But we could do this instead if you want.  I am neutral myself.

I think it is more clear without this, since we imply elsewhere that diff-* accepts the options in diff-options.txt. Documenting "-r" in the only place it applies (diff-tree) means we don't need exceptions anywhere else.

Incidentally, I think it would make more sense if diff-tree defaulted to recursive behavior and required a flag to produce non-recursive behavior, but I realize that's impractical now, and only of minor benefit.

-chris
Previous: Junio C HamanoNext: Chuck Lever
Message 4 of 5 in “documentation issues”
  1. Chuck LeverDec 1, 2005
  2. Chris ShoemakerDec 1, 2005
  3. Junio C HamanoDec 1, 2005
  4. Chris ShoemakerDec 1, 2005
  5. Chuck LeverDec 1, 2005

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.