Re: [PATCH] Documentation/git.txt: command re-classification

From: Nicolas Pitre <nico@cam.org>
Date: Jan 19, 2007, 22:08 UTC
Message-ID: <Pine.LNX.4.64.0701191437450.3011@xanadu.home>
In-Reply-To: <7v1wlrle61.fsf@assigned-by-dhcp.cox.net>

On Thu, 18 Jan 2007, Junio C Hamano wrote:

Show 9 quoted lines

>  * I unfortunately had to drop your patch on the floor, because
>    I was cooking a few patches to automate the maintenance of
>    the command list (which are now in 'master' and the product is
>    being served at www.kernel.org/pub/software/scm/git/docs/),
>    which majorly conflicted with your work.
> 
>    So here is a counterproposal; I moved commands across groups
>    after looking at what your patch did, but classified some of
>    them differently.

OK.  But I think the following are still misclassified:

  git-rev-parse
  git-runstatus
  git-fsck-objects

Show 6 quoted lines

> +The interface (input, output, set of options and the semantics)
> +to these low-level commands are meant to be a lot more stable
> +than Porcelain level commands, because these commands are
> +primarily for scripted use.  To put it another way, the
> +interface to Plumbing commands are subject to change in order to
> +improve the end user experience.

I think the "to put it another way" sentence is a bit confusing here.

Nicolas