Merge branch 'maint'
authorJunio C Hamano <gitster@pobox.com>
Sat, 17 May 2008 05:10:13 +0000 (22:10 -0700)
committerJunio C Hamano <gitster@pobox.com>
Sat, 17 May 2008 05:10:13 +0000 (22:10 -0700)
* maint:
git-filter-branch: Clarify file removal example.

1  2 
Documentation/git-filter-branch.txt
index 8d80f0d074c92fccc2a9746c5f374c1626fdde97,4a530965ec189606638d8ae00fc6eab5cdedf9c6..506c37af7021e2e16caab5ffe72bca9bc2f28927
@@@ -133,16 -133,10 +133,16 @@@ use "--tag-name-filter cat" to simply u
  case, be very careful and make sure you have the old tags
  backed up in case the conversion has run afoul.
  +
 -Note that there is currently no support for proper rewriting of
 -tag objects; in layman terms, if the tag has a message or signature
 -attached, the rewritten tag won't have it.  Sorry.  (It is by
 -definition impossible to preserve signatures at any rate.)
 +Nearly proper rewriting of tag objects is supported. If the tag has
 +a message attached, a new tag object will be created with the same message,
 +author, and timestamp. If the tag has a signature attached, the
 +signature will be stripped. It is by definition impossible to preserve
 +signatures. The reason this is "nearly" proper, is because ideally if
 +the tag did not change (points to the same object, has the same name, etc.)
 +it should retain any signature. That is not the case, signatures will always
 +be removed, buyer beware. There is also no support for changing the
 +author or timestamp (or the tag message for that matter). Tags which point
 +to other tags will be rewritten to point to the underlying commit.
  
  --subdirectory-filter <directory>::
        Only look at the history which touches the given subdirectory.
@@@ -183,6 -177,10 +183,10 @@@ or copyright violation) from all commit
  git filter-branch --tree-filter 'rm filename' HEAD
  -------------------------------------------------------
  
+ However, if the file is absent from the tree of some commit,
+ a simple `rm filename` will fail for that tree and commit.
+ Thus you may instead want to use `rm -f filename` as the script.
  A significantly faster version:
  
  --------------------------------------------------------------------------