From: Matthieu Moy <matthieu.moy@grenoble-inp.fr>
Date: Thu, 05 Aug 2010 16:09:58 GMT
Subject: Re: [PATCH v2] Document -B<n>[/<m>], -M<n> and -C<n> variants of -B, -M and -C
Message-ID: <vpqbp9hoxbd.fsf@bauges.imag.fr>
In-Reply-To: <7vsk2wlvxv.fsf@alter.siamese.dyndns.org>

Junio C Hamano <gitster@pobox.com> writes:

> After reading this, we know that with magic numbers given to -B, we can
> "break" changes into "pairs of delete and create".  What does it mean in
> the practical terms?  That is a lot more essential information than how
> the magic numbers affect the decision to break or not break.  The user
> does not get a motivation to help git "break" a pair from the above.
>
>     The -B option serves two purposes.
>     [...]

I like your version much more than mine. I took it with a bit of
asciidoc reformatting.

I detailed a bit more the -M<n> case, so that users do not have to
read the whole -B thing to understand -M<n>. I'm citing the expression
"similarity index" since it sometimes appears in the output of diff,
hence, can help the user to match what's happening and the doc.

New version follows.

-- 
Matthieu Moy
http://www-verimag.imag.fr/~moy/