diff options
author | Junio C Hamano <junio@hera.kernel.org> | 2008-08-10 03:55:58 +0000 |
---|---|---|
committer | Junio C Hamano <junio@hera.kernel.org> | 2008-08-10 03:55:58 +0000 |
commit | faa1e50737bfc349e8315c99a2ed59182fd557b1 (patch) | |
tree | 05ca5456c6a103f7632321128d3a325a68450748 /git-filter-branch.html | |
parent | b53db3ca58a8a65d8de3b9fa048d410757edc38f (diff) | |
download | git-htmldocs-faa1e50737bfc349e8315c99a2ed59182fd557b1.tar.gz |
Autogenerated HTML docs for v1.6.0-rc2-22-g71b9
Diffstat (limited to 'git-filter-branch.html')
-rw-r--r-- | git-filter-branch.html | 21 |
1 files changed, 15 insertions, 6 deletions
diff --git a/git-filter-branch.html b/git-filter-branch.html index 799e37052..1ef716e92 100644 --- a/git-filter-branch.html +++ b/git-filter-branch.html @@ -326,7 +326,7 @@ git-filter-branch(1) Manual Page [--msg-filter <command>] [--commit-filter <command>]
[--tag-name-filter <command>] [--subdirectory-filter <directory>]
[--original <namespace>] [-d <directory>] [-f | --force]
- [<rev-list options>…]</div></div>
+ [--] [<rev-list options>…]</div></div>
</div>
<h2 id="_description">DESCRIPTION</h2>
<div class="sectionbody">
@@ -528,10 +528,10 @@ to other tags will be rewritten to point to the underlying commit.</p></div> </dt>
<dd>
<p>
- When options are given after the new branch name, they will
- be passed to <em>git-rev-list</em>. Only commits in the resulting
- output will be filtered, although the filtered commits can still
- reference parents which are outside of that set.
+ Arguments for <em>git-rev-list</em>. All positive refs included by
+ these options are rewritten. You may also specify options
+ such as <em>--all</em>, but you must use <em>--</em> to separate them from
+ the <em>git-filter-branch</em> options.
</p>
</dd>
</dl></div>
@@ -553,6 +553,15 @@ Thus you may instead want to use <tt>rm -f filename</tt> as the script.</p></div <pre><tt>git filter-branch --index-filter 'git rm --cached filename' HEAD</tt></pre>
</div></div>
<div class="para"><p>Now, you will get the rewritten history saved in HEAD.</p></div>
+<div class="para"><p>To rewrite the repository to look as if <tt>foodir/</tt> had been its project
+root, and discard all other history:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><tt>git filter-branch --subdirectory-filter foodir -- --all</tt></pre>
+</div></div>
+<div class="para"><p>Thus you can, e.g., turn a library subdirectory into a repository of
+its own. Note the <tt>--</tt> that separates <em>filter-branch</em> options from
+revision options, and the <tt>--all</tt> to rewrite all branches and tags.</p></div>
<div class="para"><p>To set a commit (which typically is at the tip of another
history) to be the parent of the current initial commit, in
order to paste the other history behind the current history:</p></div>
@@ -665,7 +674,7 @@ and the git list <git@vger.kernel.org></p></div> </div>
<div id="footer">
<div id="footer-text">
-Last updated 2008-07-31 22:10:18 UTC
+Last updated 2008-08-10 03:55:19 UTC
</div>
</div>
</body>
|