From: Chris Shoemaker <c.shoemaker@cox.net>
Date: Thu, 01 Dec 2005 21:54:24 GMT
Subject: Re: documentation issues
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:
> > 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