Re: [PATCH] Document the -p option for git-show.

From: David Kastrup <dak@gnu.org>
Date: Aug 21, 2007, 15:02 UTC
Message-ID: <867inpexsm.fsf@lola.quinscape.zz>
In-Reply-To: <46CAE41C.4614FDF4@eudaptics.com>

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

Show 13 quoted lines

> 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