Re: [PATCH] Documentation: Simplify git-rev-parse's example

From: Jon Loeliger <jdl@freescale.com>
Date: Jun 19, 2008, 19:12 UTC
Message-ID: <485AAF82.3030209@freescale.com>
In-Reply-To: <1213873976-4192-1-git-send-email-pdebie@ai.rug.nl>

Pieter de Bie wrote:

Show 11 quoted lines

> This example was overly complex and therefore confusing.
> The commits have been renamed to start the oldest commit with "A"
> and working up from there. Also, this removes some commits so the graph
> is simpler. Finally the graph has been reversed in direction to make it
> more like gitk.
> 
> Signed-off-by: Pieter de Bie <pdebie@ai.rug.nl>
> ---
> 
> This was created after some discussion in #git about how this was confusing.
> The consesus was that this example is better.

How is this a vast improvement?

I could see that inverting it top-to-bottom would be more consistent with gitk or show-branch output. Your example doesn't have a 3-parent commit, though, and it isn't _that_ much simpler otherwise...

So this is really better _how_?

Oh, right, of course.  It removes my name.  Got it. :-)

jdl