git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH v2] Document -B<n>[/<m>], -M<n> and -C<n> variants of -B, -M and -C

From
Matthieu Moy <matthieu.moy@grenoble-inp.fr>
Date
Aug 5, 2010, 16:09 UTC
Message-ID
<vpqbp9hoxbd.fsf@bauges.imag.fr>
In-Reply-To
<7vsk2wlvxv.fsf@alter.siamese.dyndns.org>
Junio C Hamano <gitster@pobox.com> writes:
Show 8 quoted lines
> 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/
Previous: Junio C HamanoNext: Matthieu Moy
Message 7 of 8 in “Document -B<n>[/<m>], -M<n> and -C<n> variants of -B, -M and -C”
  1. Document -B<n>[/<m>], -M<n> and -C<n> variants of -B, -M and -CMatthieu Moy, Jul 28, 2010
  2. Junio C HamanoJul 29, 2010
  3. Matthieu MoyJul 30, 2010
  4. Junio C HamanoJul 30, 2010
  5. Document -B<n>[/<m>], -M<n> and -C<n> variants of -B, -M and -CMatthieu Moy, Aug 2, 2010
  6. Junio C HamanoAug 2, 2010
  7. Matthieu MoyAug 5, 2010
  8. Document -B<n>[/<m>], -M<n> and -C<n> variants of -B, -M and -CMatthieu Moy, Aug 5, 2010

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.