Re: [PATCH v2 2/3] builtin: introduce diff-pairs command

From: Jean-Noël Avila <jn.avila@free.fr>
Date: Feb 12, 2025, 11:40 UTC
Message-ID: <24dadfc4-6831-46df-b40f-98842d2865db@free.fr>
In-Reply-To: <20250212041825.2455031-3-jltobler@gmail.com>

Le 12/02/2025 à 05:18, Justin Tobler a écrit :

Show 7 quoted lines

>
> +
> +SYNOPSIS
> +--------
> +[verse]
> +'git diff-pairs' [diff-options]
> +

This should read:

[synopsis] git-diff-pairs [<diff-options>]

> +DESCRIPTION
> +-----------
> +
> +Given the output of `diff-tree -z` on its stdin, `diff-pairs` will

Please do not use the future form when describing the actual behavior.

Show 15 quoted lines

> +reformat that output into whatever format is requested on its command
> +line.  For example:
> +
> +-----------------------------
> +git diff-tree -z -M $a $b |
> +git diff-pairs -p
> +-----------------------------
> +
> +will compute the tree diff in one step (including renames), and then
> +`diff-pairs` will compute and format the blob-level diffs for each pair.
> +This can be used to modify the raw diff in the middle (without having to
> +parse or re-create more complicated formats like `--patch`), or to
> +compute diffs progressively over the course of multiple invocations of
> +`diff-pairs`.
> +

JN