]> git.ipfire.org Git - thirdparty/git.git/commit
range-diff: optionally accept pathspecs
authorJohannes Schindelin <johannes.schindelin@gmx.de>
Fri, 26 Aug 2022 09:39:30 +0000 (09:39 +0000)
committerJunio C Hamano <gitster@pobox.com>
Fri, 26 Aug 2022 16:49:26 +0000 (09:49 -0700)
commitb75747829f4c277323c78b1c5973ad63ea038a2d
treef7046d3e87addc8468950a6bb019ff4e5dfbe98c
parent0087d7dfbebf10f23394f32db3c283eb7ab03129
range-diff: optionally accept pathspecs

The `git range-diff` command can be quite expensive, which is not a
surprise given that the underlying algorithm to match up pairs of
commits between the provided two commit ranges has a cubic runtime.

Therefore it makes sense to restrict the commit ranges as much as
possible, to reduce the amount of input to that O(N^3) algorithm.

In chatty repositories with wide trees, this is not necessarily
possible merely by choosing commit ranges wisely.

Let's give users another option to restrict the commit ranges: by
providing a pathspec. That helps in repositories with wide trees because
it is likely that the user has a good idea which subset of the tree they
are actually interested in.

Example:

git range-diff upstream/main upstream/seen HEAD -- range-diff.c

This shows commits that are either in the local branch or in `seen`, but
not in `main`, skipping all commits that do not touch `range-diff.c`.

Note: Since we piggy-back the pathspecs onto the `other_arg` mechanism
that was introduced to be able to pass through the `--notes` option to
the revision machinery, we must now ensure that the `other_arg` array is
appended at the end (the revision range must come before the pathspecs,
if any).

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-range-diff.txt
builtin/range-diff.c
range-diff.c
t/t3206-range-diff.sh