summaryrefslogtreecommitdiffstats
path: root/git-svn.txt
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.txt
parent0fd857e5bc36d9b8c88686a602c4ae253607487b (diff)
downloadgit-htmldocs-657fd8a8dd93c9d5c7534016aa6601c564fe2601.tar.gz
Autogenerated HTML docs for v1.7.3.1-104-gc752e
Diffstat (limited to 'git-svn.txt')
-rw-r--r--git-svn.txt17
1 files changed, 14 insertions, 3 deletions
diff --git a/git-svn.txt b/git-svn.txt
index 4b84d08fc..be8a51fd0 100644
--- a/git-svn.txt
+++ b/git-svn.txt
@@ -56,6 +56,8 @@ COMMANDS
as well, they take precedence.
--no-metadata;;
Set the 'noMetadata' option in the [svn-remote] config.
+ This option is not recommended, please read the 'svn.noMetadata'
+ section of this manpage before using this option.
--use-svm-props;;
Set the 'useSvmProps' option in the [svn-remote] config.
--use-svnsync-props;;
@@ -597,13 +599,22 @@ svn.noMetadata::
svn-remote.<name>.noMetadata::
This gets rid of the 'git-svn-id:' lines at the end of every commit.
+
-If you lose your .git/svn/git-svn/.rev_db file, 'git svn' will not
-be able to rebuild it and you won't be able to fetch again,
-either. This is fine for one-shot imports.
+This option can only be used for one-shot imports as 'git svn'
+will not be able to fetch again without metadata. Additionally,
+if you lose your .git/svn/**/.rev_map.* files, 'git svn' will not
+be able to rebuild them.
+
The 'git svn log' command will not work on repositories using
this, either. Using this conflicts with the 'useSvmProps'
option for (hopefully) obvious reasons.
++
+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
+linkgit:git-filter-branch[1] instead. filter-branch also allows
+reformating of metadata for ease-of-reading and rewriting authorship
+info for non-"svn.authorsFile" users.
svn.useSvmProps::
svn-remote.<name>.useSvmProps::