summaryrefslogtreecommitdiffstats
path: root/git-svn.html
diff options
context:
space:
mode:
authorJunio C Hamano <junio@kernel.org>2010-10-07 00:01:24 +0000
committerJunio C Hamano <junio@kernel.org>2010-10-07 00:01:24 +0000
commit657fd8a8dd93c9d5c7534016aa6601c564fe2601 (patch)
tree634630bc99c2a4c8de534924544ac14d34b473ca /git-svn.html
parent0fd857e5bc36d9b8c88686a602c4ae253607487b (diff)
downloadgit-htmldocs-657fd8a8dd93c9d5c7534016aa6601c564fe2601.tar.gz
Autogenerated HTML docs for v1.7.3.1-104-gc752e
Diffstat (limited to 'git-svn.html')
-rw-r--r--git-svn.html18
1 files changed, 14 insertions, 4 deletions
diff --git a/git-svn.html b/git-svn.html
index 7a51be111..37cfc3662 100644
--- a/git-svn.html
+++ b/git-svn.html
@@ -396,6 +396,8 @@ Subversion updated from git by the <em>dcommit</em> command.</p></div>
<dd>
<p>
Set the <em>noMetadata</em> option in the [svn-remote] config.
+ This option is not recommended, please read the <em>svn.noMetadata</em>
+ section of this manpage before using this option.
</p>
</dd>
<dt>
@@ -1337,12 +1339,20 @@ svn-remote.&lt;name&gt;.noMetadata
<p>
This gets rid of the <em>git-svn-id:</em> lines at the end of every commit.
</p>
-<div class="para"><p>If you lose your .git/svn/git-svn/.rev_db file, <em>git svn</em> will not
-be able to rebuild it and you won't be able to fetch again,
-either. This is fine for one-shot imports.</p></div>
+<div class="para"><p>This option can only be used for one-shot imports as <em>git svn</em>
+will not be able to fetch again without metadata. Additionally,
+if you lose your .git/svn/<strong>*/.rev_map.</strong> files, <em>git svn</em> will not
+be able to rebuild them.</p></div>
<div class="para"><p>The <em>git svn log</em> command will not work on repositories using
this, either. Using this conflicts with the <em>useSvmProps</em>
option for (hopefully) obvious reasons.</p></div>
+<div class="para"><p>This option is NOT recommended as it makes it difficult to track down
+old references to SVN revision numbers in existing documentation, bug
+reports and archives. If you plan to eventually migrate from SVN to git
+and are certain about dropping SVN history, consider
+<a href="git-filter-branch.html">git-filter-branch(1)</a> instead. filter-branch also allows
+reformating of metadata for ease-of-reading and rewriting authorship
+info for non-"svn.authorsFile" users.</p></div>
</dd>
<dt>
svn.useSvmProps
@@ -1630,7 +1640,7 @@ reset) branches-maxRev and/or tags-maxRev as appropriate.</p></div>
</div>
<div id="footer">
<div id="footer-text">
-Last updated 2010-09-18 23:56:59 UTC
+Last updated 2010-10-07 00:00:54 UTC
</div>
</div>
</body>