From 1fd08382f2ad89f6bb09d0970912f95a7d3d30d6 Mon Sep 17 00:00:00 2001 From: Michele Locati Date: Fri, 9 Mar 2018 18:09:56 +0100 Subject: Initial version --- README.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..b29b493 --- /dev/null +++ b/README.md @@ -0,0 +1,32 @@ +## Introduction + +[`git filter-branch`](https://git-scm.com/docs/git-filter-branch) is a really nice git feature. +For instance, it allows fancy stuff like subtree-splitting. + +Problems may arise when the repository contains a lot of commits: this operation can take a lot of time. + +Luckily recent versions of git allow us to perform this operation in an incremental way: +the first time `filter-branch` still requires some time, but following calls can be very fast. + + +## Requirements + +- recent bash shell +- git 2.5.0 or newer. + +## Usage + +Get the script, and customize the variables you can find at its beginning. + + +## Legal stuff + +Use at your own risk. +[MIT License](https://github.com/mlocati/incremental-git-filter-branch/blob/master/LICENSE). + + +## Credits + +Special thanks to [Ian Campbell](https://github.com/ijc) for the implementation of the `--state-branch` option of git, +and his hints about how it can be used. +This script works only thanks to him (and if it doesn't work I'm the only person to blame). -- cgit v1.2.3