git - 有人可以解释 git range-diff 的用法吗？

Question

Git 2.19 版引入了 git range-diff，它应该用于比较两个提交范围。我一直在阅读文档，但我不明白这个新功能的目的是什么。

我查了官方Git documentation ，我很难理解它的语法(省略标志):

git range-diff ( <range1> <range2> | <rev1>...​<rev2> | <base> <rev1> <rev2> )

什么是 rev1 和 rev2？

有人可以解释一下它们什么时候有用吗？我指的是每种情况？

Answer 1

我还没有真正使用过它们，但它们是对旧的 git cherry* 流程的改进，用于分析/比较一些上游或下游变更集与你现在拥有的内容。为了使范围集有用，我们需要一些“这是我的提交”和“这是他们的提交”的集合，尽可能简单地表达。

range1 range2 集合可以写成，例如:

git range-diff theirs~5..theirs ours~4..ours

如果你有，例如:

          T1--T2--T3--T4--T5   <-- theirs
         /
...--o--*   <-- base
         \
          O1--O2--O3--O4   <-- ours

O 提交是“我们的”，T 提交是“他们的”。

然而，给定这个完全相同的配置，我们也可以这样写:

git range-diff theirs...ours    # or ours...theirs

(注意三个点)。 (例如，这是与 git rev-list --cherry-mark --left-right 一起使用的语法。)

或者，再次给定同样的情况，我们可以这样写:

git range-diff base theirs ours   # or base ours theirs

这里 base 是他们和我们的停止点，避免倒数 5。

如果情况更复杂——如图所示:

          X1--T1--T2--T3   <-- theirs
         /
...--o--*   <-- base
         \
          Y1--Y2--O1--O2--O3--O4   <-- ours

三点和 base ours theirs 这种语法都不太有效，所以两组范围(theirs~3..theirs ours~4..ours) 最好。