Signed-off-by: Heikki Orsila <heikki.orsila@xxxxxx> --- Documentation/git-svn.txt | 29 ++++++++++++++++++++++++++--- 1 files changed, 26 insertions(+), 3 deletions(-) diff --git a/Documentation/git-svn.txt b/Documentation/git-svn.txt index f4cbd2f..128761e 100644 --- a/Documentation/git-svn.txt +++ b/Documentation/git-svn.txt @@ -11,9 +11,12 @@ SYNOPSIS DESCRIPTION ----------- -git-svn is a simple conduit for changesets between Subversion and git. -It is not to be confused with linkgit:git-svnimport[1], which is -read-only. +git-svn is a simple bidirectional conduit for changesets between +Subversion and git. It is used to develop projects with Git tools, +but commit changes to a Subversion repository. It can also be used to +convert a Subversion repository to a Git repository. It should not to +be confused with linkgit:git-svnimport[1], which does Subversion to +Git conversion, but not the other direction. git-svn was originally designed for an individual developer who wants a bidirectional flow of changesets between a single branch in Subversion @@ -520,6 +523,26 @@ have each person clone that repository with 'git clone': git-svn rebase ------------------------------------------------------------------------ +CONVERTING A SUBVERSION REPOSITORY TO A GIT REPOSITORY +------------------------------------------------------ + +When converting a Subversion repository to a Git repository +--no-metadata removes "git-svn-id:" comments from the log. +-A option is used to convert SVN pseudonyms to real names +and email addresses. The whole repository, or a part of it can be +converted. Two examples below show how to convert the whole repo +with all branches, or only the SVN trunk. + +------------------------------------------------------------------------ +# Convert all branches of an SVN repository to a Git repository: + + git svn clone --no-metadata -A authors.txt SVN_URL foo.git + +# Convert only the trunk of an SVN repository to a Git repository: + + git svn clone --no-metadata -A authors.txt SVN_URL/trunk foo.git +------------------------------------------------------------------------ + REBASE VS. PULL/MERGE --------------------- -- 1.5.5.1.1.ga5e5c -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
