From: Junio C Hamano Date: Fri, 19 Jan 2007 22:22:17 GMT Subject: Re: [PATCH] Documentation/git.txt: command re-classification Message-ID: <7vbqkufyhy.fsf@assigned-by-dhcp.cox.net> In-Reply-To: Nicolas Pitre writes: > OK. But I think the following are still misclassified: > > git-rev-parse > git-runstatus > git-fsck-objects Thanks for proofreading. runstatus should be a pure helper. I am not sure what rev-parse and fsck-objects are, but they are not primary porcelain. rev-parse could sit next to rev-list and fsck-objects, I guess. >> +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 agree. What I wanted to say was the interface to plumbing is sacred and we will not lightly change it without a very good reason, while Porcelains are more or less "for breaking". Better wording is certainly appreciated.