Message ID | pull.859.git.1616621553.gitgitgadget@gmail.com (mailing list archive) |
---|---|
Headers | show |
Series | Optimization batch 11: avoid repeatedly detecting same renames | expand |
"Elijah Newren via GitGitGadget" <gitgitgadget@gmail.com> writes: > === Basic Optimization idea === > > This series avoids repeatedly detecting the same renames in a sequence of > merges such as a rebase or cherry-pick of several commits. When there are > many renames between the old base and the new base, traditionally all those > renames are re-detected for every commit that is transplanted. This > optimization avoids redoing that work. Unless this section is easily understandable, the readers have no incentive to read on, but the above is a bit too hand wavy. > This one adds a fourth (remember-renames), with some interesting properties: > > * unlike basename-guided rename detection, there are no behavioral changes > (there is no heuristic involved)[2]. > > * like skip-because-irrelevant, this optimization does not apply to all git > commands using the rename machinery. In fact, this one is even more > restrictive since it is ONLY useful for rebases and cherry-picks (not > even merges), and only for second and later commits in a linear series. So, is it correct to understand that one case this would help is this scenario? ---o---o---o---X---o---o---o---O ours \ A---B---C topic where there is a side branch A--B--C that touched some files, while on our side, there is a commit X that is unknown to the side branch that renamed these files. Now we want to transplant the side topic to the tip of our history, replaying the changes A--B--C made to these files under their original name to the corresponding files that have been renamed. And each step in this "rebase" is a 3-way merge of commits A, B and C onto HEAD, using the parent of the commit being cherrk-picked as a virtual common ancestor. Which means - To transplant A (i.e. the first step), we'd compare the diff of A^..O (i.e. what our side did, including the renames done at X) and diff of A^..A (i.e. what the first commit did in the range), and the former does quite a lot of rename detection. - After transplanting B (i.e. the second step), then we'd compare the diff of A^..A' (where A' is A cherry-picked on O, i.e. the result of the previous step). If we are lucky, O..A' did not rename anything so the renames done in A^..O (i.e. what we detected during the first step) and A^..A' (i.e. what we should be computing for this second step) should be quite similar. If we assume that the "quite similar" is good enough, then we can blindly reuse the record of "<path in A^> correspnds to <path in O>" as if it were "<path in A^> corresponds to <path in A'>". - Do the same for C, pretending that renames discovered between A^ and O is identical to the renames between A^ and B' (i.e. the result of cherry-picking A--B on top of O).
On Wed, Mar 24, 2021 at 3:04 PM Junio C Hamano <gitster@pobox.com> wrote: > > "Elijah Newren via GitGitGadget" <gitgitgadget@gmail.com> writes: > > > === Basic Optimization idea === > > > > This series avoids repeatedly detecting the same renames in a sequence of > > merges such as a rebase or cherry-pick of several commits. When there are > > many renames between the old base and the new base, traditionally all those > > renames are re-detected for every commit that is transplanted. This > > optimization avoids redoing that work. > > Unless this section is easily understandable, the readers have no > incentive to read on, but the above is a bit too hand wavy. Oh, yeah, it's very hand wavy. I figured the commit messages were the right place to include the details, and just wanted to give a flavor of the idea in the cover letter. > > This one adds a fourth (remember-renames), with some interesting properties: > > > > * unlike basename-guided rename detection, there are no behavioral changes > > (there is no heuristic involved)[2]. > > > > * like skip-because-irrelevant, this optimization does not apply to all git > > commands using the rename machinery. In fact, this one is even more > > restrictive since it is ONLY useful for rebases and cherry-picks (not > > even merges), and only for second and later commits in a linear series. > > So, is it correct to understand that one case this would help is > this scenario? > > ---o---o---o---X---o---o---o---O ours > \ > A---B---C topic > > where there is a side branch A--B--C that touched some files, while > on our side, there is a commit X that is unknown to the side branch > that renamed these files. Now we want to transplant the side topic > to the tip of our history, replaying the changes A--B--C made to > these files under their original name to the corresponding files > that have been renamed. > > And each step in this "rebase" is a 3-way merge of commits A, B and > C onto HEAD, using the parent of the commit being cherrk-picked as a > virtual common ancestor. Which means You generated nearly the same description and diagram I used in the commit message (the one in 3/7) describing this. :-) > - To transplant A (i.e. the first step), we'd compare the diff of > A^..O (i.e. what our side did, including the renames done at X) > and diff of A^..A (i.e. what the first commit did in the range), > and the former does quite a lot of rename detection. > > - After transplanting B (i.e. the second step), then we'd compare > the diff of A^..A' (where A' is A cherry-picked on O, i.e. the Close, but for transplanting B we do the diff of B^..A', not A^...A'. (And in this diagram, B^ is A.) That's critical below... > result of the previous step). If we are lucky, O..A' did not > rename anything so the renames done in A^..O (i.e. what we > detected during the first step) and A^..A' (i.e. what we should > be computing for this second step) should be quite similar. Again, B^..A' rather than A^..A'. Luck is not involved here. If O..A' did rename anything, it's one of two reasons: - There were conflicts when trying to transplant A, and when we stop for conflict resolution, the user added some renames at that point. - There were renames in A^..A. In the first case, the presence of conflicts means we drop the cache and this optimization doesn't try to kick in. In the second case, those renames in A' came from A. Even without this optimization, since those renames in A' came from A, doing rename detection on A..A' wouldn't re-detect them and transplanting wouldn't try to reapply them, so they just aren't relevant anymore -- with or without this optimization. > If we assume that the "quite similar" is good enough, then we can > blindly reuse the record of "<path in A^> correspnds to <path in > O>" as if it were "<path in A^> corresponds to <path in A'>". Again, B^ rather than A^ on the last line. I disagree with the use of the term "blindly" here. As spelled out in the third commit message, the transplant of A involved a three-way content merge of the form: A^:oldfile O:newfile A:oldfile and produce a new result: A':newfile The point of rename detection is to determine what files are similar enough to use in a three-way content merge. In particular, we'd use rename detection when transplanting B to notice the oldfile -> newfile rename so that we can do a three-way content merge of the form: A:oldfile A':newfile B:oldfile and produce a new result: B':newfile But, instead of asking rename detection whether A:oldfile and A':newfile are similar enough to use together in a three-way content merge, we could ask ourselves -- do we have any _other_ reason to believe these files are similar enough to be used in a three-way content merge? And the answer that comes back is: these files were *already* involved in the same three-way content merge -- the one that A':newfile came from. It was a three-way content merge with no conflicts. (Because when conflicts are triggered we turn this optimization off.) > - Do the same for C, pretending that renames discovered between A^ > and O is identical to the renames between A^ and B' (i.e. the > result of cherry-picking A--B on top of O). Now you've changed your off-by-one mistake to an off-by-two mistake; the rename detection is between C^ and B', not A^ and B'. I think this error might be critical to why you used terms like "pretend" and "blindly" and "lucky". I agree that it would require luck/blindness/pretending to assume that the renames between A^ and O are identical to those between A^ and B', but that's not what the original algorithm would have been using for computing renames; it would be using C^ and B'. It's actually quite difficult to generate a case where this optimization gets a possibly different result. It requires there were changes to the content on both sides of history that merge cleanly, and in particular that need a significant size reduction of the file by the unrenamed side of history. If you take the changes on the *renamed* side of history, which represent <50% changes since it was detected as a rename, those same changes need to represent a >50% change when applied to the smaller file. This is discussed in the third commit message, as noted in the cover letter: >> [2] Well, almost no changes. There's technically a very narrow way that this >> could change the behavior; see the really long "Technically," bullet point >> in patch 3 for discussion of this.
Elijah Newren <newren@gmail.com> writes: >> And each step in this "rebase" is a 3-way merge of commits A, B and >> C onto HEAD, using the parent of the commit being cherrk-picked as a >> virtual common ancestor. Which means > > You generated nearly the same description and diagram I used in the > commit message (the one in 3/7) describing this. :-) > >> - To transplant A (i.e. the first step), we'd compare the diff of >> A^..O (i.e. what our side did, including the renames done at X) >> and diff of A^..A (i.e. what the first commit did in the range), >> and the former does quite a lot of rename detection. >> >> - After transplanting B (i.e. the second step), then we'd compare >> the diff of A^..A' (where A' is A cherry-picked on O, i.e. the > > Close, but for transplanting B we do the diff of B^..A', not A^...A'. > (And in this diagram, B^ is A.) That's critical below... Yes, I upfront said "pretend that the parent of the commit being picked is the common ancestor and run 3-way merge", but then got confused by the ancestry graph myself, forgetting that the reason why A^ is used in the first "pick" is *not* because the it is the fork point of our history and the side branch, but it is because it is A's parent. And if the renames in B^..A' and A^..A' are different that must have come only from the difference between A..B (which is B^..B), but that comparison is what we do when cherry-picking B on top of A', so it is easy to take into account to reuse the renames precisely without "assuming they are the same". Thanks.
On Thu, Mar 25, 2021 at 12:00 PM Junio C Hamano <gitster@pobox.com> wrote: > > Elijah Newren <newren@gmail.com> writes: > > >> And each step in this "rebase" is a 3-way merge of commits A, B and > >> C onto HEAD, using the parent of the commit being cherrk-picked as a > >> virtual common ancestor. Which means > > > > You generated nearly the same description and diagram I used in the > > commit message (the one in 3/7) describing this. :-) > > > >> - To transplant A (i.e. the first step), we'd compare the diff of > >> A^..O (i.e. what our side did, including the renames done at X) > >> and diff of A^..A (i.e. what the first commit did in the range), > >> and the former does quite a lot of rename detection. > >> > >> - After transplanting B (i.e. the second step), then we'd compare > >> the diff of A^..A' (where A' is A cherry-picked on O, i.e. the > > > > Close, but for transplanting B we do the diff of B^..A', not A^...A'. > > (And in this diagram, B^ is A.) That's critical below... > > Yes, I upfront said "pretend that the parent of the commit being > picked is the common ancestor and run 3-way merge", but then got > confused by the ancestry graph myself, forgetting that the reason > why A^ is used in the first "pick" is *not* because the it is the > fork point of our history and the side branch, but it is because it > is A's parent. > > And if the renames in B^..A' and A^..A' are different that must have > come only from the difference between A..B (which is B^..B), but > that comparison is what we do when cherry-picking B on top of A', > so it is easy to take into account to reuse the renames precisely > without "assuming they are the same". > > Thanks. After sending the initial series, I decided to type up a more thorough document that * spelled out in more detail how the sequence of cherry-picks work * proved why the renames in one pick are always a superset of the renames in the next * proved why the renames in one pick are _almost_ always also a rename in the next * discussed the counterexample cases in more detail, and why the optimization is still reasonable I figured the more extended document would be useful in case people decide to change how things work in the future (e.g. what if someone wants to turn on break detection?), and wants to be able to check whether all the conditions and cases still hold. I then also added details about how things work with directory renames, in the case that merge.directoryRenames is not the default of "conflict" (which is trivially handled by stopping and dropping the cache) but is set to true...and found a case that needed more care due to interactions with some of the earlier optimizations. (The earlier optimizations could result in bypassing directory rename detection in one merge because there was no file added to the old directory, but the no-directory-rename would be cached for subsequent rebases.) So I need to get that fixed up and resubmit this series.
On 3/29/2021 6:34 PM, Elijah Newren wrote:... > After sending the initial series, I decided to type up a more thorough > document that > * spelled out in more detail how the sequence of cherry-picks work > * proved why the renames in one pick are always a superset of the > renames in the next > * proved why the renames in one pick are _almost_ always also a > rename in the next > * discussed the counterexample cases in more detail, and why the > optimization is still reasonable > I figured the more extended document would be useful in case people > decide to change how things work in the future (e.g. what if someone > wants to turn on break detection?), and wants to be able to check > whether all the conditions and cases still hold. > > I then also added details about how things work with directory > renames, in the case that merge.directoryRenames is not the default of > "conflict" (which is trivially handled by stopping and dropping the > cache) but is set to true...and found a case that needed more care due > to interactions with some of the earlier optimizations. (The earlier > optimizations could result in bypassing directory rename detection in > one merge because there was no file added to the old directory, but > the no-directory-rename would be cached for subsequent rebases.) > > So I need to get that fixed up and resubmit this series. I look forward to that document. I attempted reading this series yesterday, but did not have the mental energy to convince myself of the correctness (because of things like not knowing this logic that you plan to document). Instead, I'll promise to give round 2 a quicker response. Thanks, -Stolee