From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sun, 20 Jul 2008 11:02:01 GMT
Subject: Re: Suggestion: doc restructuring
Message-ID: <alpine.DEB.1.00.0807201257400.3305@eeepc-johanness>
In-Reply-To: <7vk5fhc6qo.fsf@gitster.siamese.dyndns.org>

Hi,

On Sun, 20 Jul 2008, Junio C Hamano wrote:

> Johannes Schindelin <Johannes.Schindelin@gmx.de> writes:
> 
> > So what I really would like is this: leave the plumbing pages as they 
> > are, but enhance those pages that users (especially new ones) are 
> > likely to see most often.
> 
> Regarding the original "do we want to ever teach plumbing to new users?" 
> issue, I suspect that, with sufficient enhancement to Porcelain, we 
> might be able to reach a point where end users can work without ever 
> touching a single plumbing command at all.

I just went back to the thread I mentioned earlier, 
http://thread.gmane.org/gmane.comp.version-control.git/59935/focus=62021
and I did not find where you need plumbing.

> Perhaps move the plumbing documentation to section 3; just like Perl has 
> DBI.3pm and friends there, /usr/share/man/man3/git-cat-file.3git will 
> describe what scripts can do with the command.

But of course!  I was wondering where to put it, but understanding 
plumbing as a sort of library for shell scripts makes sense absolutely!

Ciao,
Dscho