From: David Kastrup <dak@gnu.org>
Date: Tue, 21 Aug 2007 15:02:01 GMT
Subject: Re: [PATCH] Document the -p option for git-show.
Message-ID: <867inpexsm.fsf@lola.quinscape.zz>
In-Reply-To: <46CAE41C.4614FDF4@eudaptics.com>

Johannes Sixt <J.Sixt@eudaptics.com> writes:

> Miklos Vajna wrote:
>> +-p::
>> +       For commits, show the change the commit introduces in a patch form.
>
> This is already documented by referencing git-diff-tree a few lines
> above:
>
> 	The command takes options applicable to the git-diff-tree[1]
> 	command to control how the changes the commit introduces are
> 	shown.
>
> The man page of git-diff-tree talks about -p, and a lot more
> options.

I am not really convinced this is a good idea: at the current point of
time, man-pages are not pulled into they user manual or any other
complete reference tome.  So they are basically standalone.  Even if
they weren't, I think it does not make all too much sense for a
porcelain command to point to the documentation of a plumbing command
for much of its functionality.

-- 
David Kastrup