git-annex-filter-branch(1)  General Commands Manual git-annex-filter-branch(1)

<?><?><?> (NAME)
       git-annex-filter-branch - <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?>-<?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       git annex filter-branch [...]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> git-annex
       <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?> <?> <?><?> (hash) <?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> "foo/git-annex" <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> git-annex <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?> git-annex <?><?><?> <?><?><?><?><?> (merge)
       <?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> git-annex <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       git-annex <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> git-annex-forget(1)<?> <?><?><?><?><?><?><?><?> <?><?><?>
       annex.private <?> <?><?><?><?><?> --private <?><?>
       git-annex-initremote(1) <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> git-annex
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>. <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> (<?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> annex.private <?><?> <?><?><?><?><?><?><?> <?><?>
       git-annex initremote --private)<?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?>
       git-annex <?><?><?> <?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?> git annex
       initremote --sameas=foo <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> foo
       <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?> <?><?> foo
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?>
       importtree=yes <?><?> exporttree=yes <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?>
       git-annex <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> git gc
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> (garbage collect)
       <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> git-annex
       <?><?><?><?><?><?><?> *<?><?><?><?><?><?><?><?>*. <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       path

              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> (file matching
       options)
              <?><?><?><?><?><?><?> <?><?> git-annex-matching-options(1)
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?>.

       --branch=ref
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
              (treeish).

       --key=key
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?> <?><?><?><?>.

       --all

              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?>.

       --include-key-information-for=repo
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> uuid <?><?> <?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?>. <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>.

       --include-all-key-information
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> --exclude-key-information-for <?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       --exclude-key-information-for=repo
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?>. <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?> uuid <?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?>. <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>.

       --include-repo-config-for=repo
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?>. <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> uuid <?><?> <?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?>.

              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?> (special remotes)
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              (credentials) <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> (trust settings)<?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> (preferred content) <?>
              <?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> git-annex
              <?><?><?><?><?><?><?>. <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>.

       --include-all-repo-config
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              --exclude-repo-config-for <?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       --exclude-repo-config-for=repo
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?>. <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> uuid <?><?> <?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?>. <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       --include-global-config
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?>.

              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              git-annex-numcopies(1)<?> git-annex-config(1) <?> <?><?><?><?>
              <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?> git-annex <?><?><?><?><?>
       <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> "foo"
       <?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> git-annex <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?>:

       git-annex filter-branch foo --include-all-key-information \
            --include-all-repo-config --include-global-config

       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> "foo"
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> "1.0"<?>
       <?><?><?><?><?> --branch=1.0:foo <?><?> <?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?> "bar" <?><?><?> <?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>:

       git-annex filter-branch --all --include-all-key-information \
            --include-all-repo-config --exclude-repo-config-for=bar \
            --include-global-config

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       git-annex(1)

       git-annex-forget(1)

<?><?><?><?><?><?><?> (AUTHOR)
       Joey Hess <id@joeyh.name>

                                                    git-annex-filter-branch(1)