git-svn: allow 'init' to act as multi-init
[gitweb.git] / Documentation / git-svn.txt
index 22dd7b219d60b909bb153f0672c0c254218d9a94..d45283a53f5d2b5c39a0b6d211ffbfdb7ada9ca8 100644 (file)
@@ -301,25 +301,48 @@ section on
 '<<tracking-multiple-repos,Tracking Multiple Repositories or Branches>>'
 for more information on using GIT_SVN_ID.
 
+-R<remote name>::
+--svn-remote <remote name>::
+       Specify the [svn-remote "<remote name>"] section to use,
+       this allows multiple repositories to be tracked.
+       Default: git-svn
+
 --follow-parent::
        This is especially helpful when we're tracking a directory
        that has been moved around within the repository, or if we
        started tracking a branch and never tracked the trunk it was
-       descended from.
+       descended from. This feature is enabled by default, use
+       --no-follow-parent to disable it.
 
 config key: svn.followparent
 
---no-metadata::
+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.
 
-       The 'git-svn log' command will not work on repositories using this,
-       either.
-
-config key: svn.nometadata
+       The 'git-svn log' command will not work on repositories using
+       this, either.  Using this conflicts with the 'useSvmProps'
+       option for (hopefully) obvious reasons.
+
+svn.useSvmProps:
+svn-remote.<name>.useSvmProps:
+       This allows git-svn to re-map repository URLs and UUIDs from
+       mirrors created using SVN::Mirror (or svk) for metadata.
+
+       If an SVN revision has a property, "svm:headrev", it is likely
+       that the revision was created by SVN::Mirror (also used by SVK).
+       The property contains a repository UUID and a revision.  We want
+       to make it look like we are mirroring the original URL, so
+       introduce a helper function that returns the original identity
+       URL and UUID, and use it when generating metadata in commit
+       messages.
+
+       Using this conflicts with the 'noMetadata' option for
+       (hopefully) obvious reasons.
 
 --