Documentation/git-filter-branch.txt: Fix description of --commit-filter
The old description was misleading and logically impossible. It claimed that the ancestors of the original commit would be re-written to have the multiple emitted ids as parents. Not only would this modify existing objects, but it would create a cycle. What this actually does is pass the multiple emitted ids to the newly-created children to use as parents. Signed-off-by: Kevin Ballard <kevin@sb.org> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Kevin Ballard committed
May 30, 2008 at 14:43 UTC
c5833f6e1373e4e6a2c31a0cb6cd9050dc395643
1 file changed
+1
-1
Documentation/git-filter-branch.txt
+1
-1
@@ -113,7 +113,7 @@ OPTIONS
113
stdin. The commit id is expected on stdout.
114
+
115
As a special extension, the commit filter may emit multiple
116
-commit ids; in that case, ancestors of the original commit will
116
+commit ids; in that case, the rewritten children of the original commit will
117
have all of them as parents.
118
+
119
You can use the 'map' convenience function in this filter, and other