Git: what is a graftcommit or a graft-id?
On git-filter-branch, it is said:
To set a commit (which typically is at the tip of another history) to be the parent of the current initial commit, in order to paste the other history behind the current history:
- Repeatedly using git-filter-branch to rewrite new commits
- Autofixup consecutive commits of same message and author (of the complete repo)
- Detach (move) subdirectory into separate Git repository
- Completely remove file from all Git repository commit history
- git filter-branch --tree-filter results in 'unknown revision or path not in the working tree'
- Add original hash to commit on git rebase (with new root)
git filter-branch --parent-filter 'sed "s/^\$/-p <graft-id>/"' HEAD
(if the parent string is empty – which happens when we are dealing with the initial commit – add graftcommit as a parent).
This is exactly what I want to, i.e. to set the parent (to commit
A) of some root commit (
B). See here for a related question.
But what exactly is the graft-id in that command? Is that the new parent, i.e.
Further on, an even simpler example is given to achieve the same:
or even simpler:
echo "$commit-id $graft-id" >> .git/info/grafts git filter-branch $graft-id..HEAD
Again, what is
$graft-id supposed to be in this example? And
A, right? Or is it
I also read this but I still don’t really understand why I need such a concept here. Why can’t I just do
git filter-branch A..HEAD or so?
Ok, I think I figured it all out, see my own answer.
To explain why I needed it:
In our project OpenLieroX, we had Google Breakpad included at one point.
We didn’t took it from the official SVN (because it didn’t worked at that time for me) but from the latest LastFM stable instead (it was just random that is was from there — I had it also on my disk and knew that the LastFM people probably took some stable Breakpad version).
Then, when time went on, we applied several patches to our own copy of Google Breakpad.
Now, many months later, we want to clean the histories a bit up, get a good overview of all our patches to Breakpad and maybe also get them upstream. And most importantly (for us), we want to update our copy of Breakpad.
So, I thought that the best thing would be to create a new Git repository, fetch the official source history from somewhere into it and get all the Breakpad specific stuff from our main repository via
git filter-branch into it. I used this Breakpad mirror as a base. The
filter-branch was also a bit more complicated because we moved the whole Breakpad directory at one point inside the OpenLieroX repository.
So I ended up with three branches:
git filter-branch-first-run for the time when Breakpad was in
git filter-branch-second-run for the time when Breakpad was in
official: Copy of
masterfrom the Breakpad mirror.
Then I searched for the commit in
official which was most close to the root in
breakpad-in-mainsrc. I didn’t got any perfect match, so I used the most close one (wrote a small Python script to figure that out). This one is tagged now as
And then I wanted to merge these three histories all together. This went fine the way described above (and given my own answer below).
The result is here: OpenLieroX Google Breakpad on GitHub
2 Solutions collect form web for “Git: what is a graftcommit or a graft-id?”
This is a rather obscure feature.
If you should need this, you better make doubly sure you know exactly how git works behind the scenes and you know what it is you wanted to achieve.
Also, there is a newer, probably more useful (at least it is more flexible) feature called
git replace (man page)
IMHO that same documentation contains ample info should you really need this.
- What are .git/info/grafts for?
Ok, it seems to work the way I expected. To answer my own questions:
- graft-id is really nothing else than a commit-id, i.e. the SHA1 of a commit.
B(it must be a SHA1 though, no tags or so)
A(again, must be a SHA1)
Then the given even simpler way works as expected.