From: Jakub Narebski <jnareb@gmail.com>
Date: Fri, 19 Jan 2007 22:18:47 GMT
Subject: Re: [PATCH] Documentation/git.txt: command re-classification
Message-ID: <eorg2u$f1o$2@sea.gmane.org>
In-Reply-To: <Pine.LNX.4.64.0701191437450.3011@xanadu.home>

Nicolas Pitre wrote:

>> +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.

I think it should read "To put it another way, Porcelain level commands
are subject to change" instead of much less readable "To put it another way,
the interface to Plumbing commands are subject to change".
-- 
Jakub Narebski
Warsaw, Poland
ShadeHawk on #git