From: Jonathan Nieder <jrnieder@gmail.com>
Date: Sat, 18 Dec 2010 08:49:08 GMT
Subject: Re: [PATCHv2 0/8] docs: use metavariables consistently
Message-ID: <20101218084908.GE6187@burratino>
In-Reply-To: <1292650725-21149-1-git-send-email-lodatom@gmail.com>

Mark Lodato wrote:

>                               The biggest change is to drop the <tree-ish> and
> <commit-ish> (or <committish>) notation and just use <tree> or <commit>, since
> every command but commit-tree accepts tree-ishes and commit-ishes.

Thanks.  I think this will encourage UI consistency ("where you accept
a tree, accepts commits and tags, too") as a side effect.

> This is a rework of my earlier patch set from March [1], with the following
> differences:
>
> - Drop the patch to commit-tree that makes it accept a tree-ish.

Ah, missed this before.  It is not clear to me why this difference ---
is it just to be conservative about changing behavior?

> [1] http://kerneltrap.org/mailarchive/git/2010/3/13/25484
http://thread.gmane.org/gmane.comp.version-control.git/142078