git-filter-branch

Hi,

What is supposed to be the usage() of git-fetch-branch ?

git-filter-branch itself says: git-filter-branch [-d TEMPDIR] [FILTERS] DESTBRANCH [REV-RANGE]

while the documentation doesn't explicitely talk about DESTBRANCH, expect in the form of an hypothetical /newbranch/, that you obviously don't give to the command line.

And whereas git-filter-branch itself says there is such an argument, it actually doesn't take it, and doesn't seem to be hardwired to create a new branch instead of overwriting the current one.

So what is git-filter-branch supposed to be doing ?

As a side note, if it ever happens that git-filter-branch can create a new branch, it might be nice to have each commit on the branch to have the original commit as parent, as well as its branch parent, so that they are seen as merges.

Cheers,

Mike