From: Junio C Hamano <gitster@pobox.com>
Date: Tue, 02 Feb 2010 00:46:02 GMT
Subject: Re: A git-mv question
Message-ID: <7vwrywmpmd.fsf@alter.siamese.dyndns.org>
In-Reply-To: <alpine.LFD.2.00.1002011927490.1681@xanadu.home>

Nicolas Pitre <nico@fluxnic.net> writes:

> Please see:
>
> http://www.kernel.org/pub/software/scm/git/docs/gitdiffcore.html

Thanks.

Probably it needs a bit of updates to help new people read it.

 * It talks about diff-* family.  They exist, but what they do can be
   triggered also by "diff" wrapper and that is the primary way the users
   know about "diff" these days.

 * Because it was written to illustrate the low-level diff-* family, it
   says "when they are run without -p option".  People who only know
   Porcelain "diff" need to read as if it said "when run with --raw".

 * It does not talk about "log -p" but the discussion applies there as
   well (log is a glorified form of diff-tree).