{"thread":{"id":"13955","subject":"[PATCH] Add SVN->Git conversion example to documentation","startedAt":"2008-06-14T18:03:34Z","lastAt":"2008-06-15T13:17:42Z","messageCount":2,"participants":["Heikki Orsila","Karl Hasselström"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"79865","messageId":"20080614180334.GA26359@zakalwe.fi","threadId":"13955","inReplyTo":null,"subject":"[PATCH] Add SVN->Git conversion example to documentation","fromName":"Heikki Orsila","fromEmail":"heikki.orsila@iki.fi","sentAt":"2008-06-14T18:03:34Z","receivedAt":"2008-06-14T18:03:34Z","isPatch":true,"sender":{"key":"heikki.orsila@iki.fi","avatar":null},"body":"Signed-off-by: Heikki Orsila <heikki.orsila@iki.fi>\n---\n Documentation/git-svn.txt |   29 ++++++++++++++++++++++++++---\n 1 files changed, 26 insertions(+), 3 deletions(-)\n\ndiff --git a/Documentation/git-svn.txt b/Documentation/git-svn.txt\nindex f4cbd2f..128761e 100644\n--- a/Documentation/git-svn.txt\n+++ b/Documentation/git-svn.txt\n@@ -11,9 +11,12 @@ SYNOPSIS\n \n DESCRIPTION\n -----------\n-git-svn is a simple conduit for changesets between Subversion and git.\n-It is not to be confused with linkgit:git-svnimport[1], which is\n-read-only.\n+git-svn is a simple bidirectional conduit for changesets between\n+Subversion and git. It is used to develop projects with Git tools,\n+but commit changes to a Subversion repository. It can also be used to\n+convert a Subversion repository to a Git repository. It should not to\n+be confused with linkgit:git-svnimport[1], which does Subversion to\n+Git conversion, but not the other direction.\n \n git-svn was originally designed for an individual developer who wants a\n bidirectional flow of changesets between a single branch in Subversion\n@@ -520,6 +523,26 @@ have each person clone that repository with 'git clone':\n \tgit-svn rebase\n ------------------------------------------------------------------------\n \n+CONVERTING A SUBVERSION REPOSITORY TO A GIT REPOSITORY\n+------------------------------------------------------\n+\n+When converting a Subversion repository to a Git repository\n+--no-metadata removes \"git-svn-id:\" comments from the log.\n+-A option is used to convert SVN pseudonyms to real names\n+and email addresses. The whole repository, or a part of it can be\n+converted. Two examples below show how to convert the whole repo\n+with all branches, or only the SVN trunk.\n+\n+------------------------------------------------------------------------\n+# Convert all branches of an SVN repository to a Git repository:\n+\n+\tgit svn clone --no-metadata -A authors.txt SVN_URL foo.git\n+\n+# Convert only the trunk of an SVN repository to a Git repository:\n+\n+\tgit svn clone --no-metadata -A authors.txt SVN_URL/trunk foo.git\n+------------------------------------------------------------------------\n+\n REBASE VS. PULL/MERGE\n ---------------------\n \n-- \n1.5.5.1.1.ga5e5c\n"},{"id":"79928","messageId":"20080615131742.GA316@diana.vm.bytemark.co.uk","threadId":"13955","inReplyTo":"20080614180334.GA26359@zakalwe.fi","subject":"Re: [PATCH] Add SVN->Git conversion example to documentation","fromName":"Karl Hasselström","fromEmail":"kha@treskal.com","sentAt":"2008-06-15T13:17:42Z","receivedAt":"2008-06-15T13:17:42Z","isPatch":true,"sender":{"key":"kha@treskal.com","avatar":"https://gravatar.com/avatar/f0120c734b5279b345075a28521e1ac66acb20c9913ffe9bf6ae97e53f7f3f13?d=mp&s=160"},"body":"On 2008-06-14 21:03:34 +0300, Heikki Orsila wrote:\n\n>  DESCRIPTION\n>  -----------\n> -git-svn is a simple conduit for changesets between Subversion and git.\n> -It is not to be confused with linkgit:git-svnimport[1], which is\n> -read-only.\n> +git-svn is a simple bidirectional conduit for changesets between\n> +Subversion and git. It is used to develop projects with Git tools,\n> +but commit changes to a Subversion repository. It can also be used to\n> +convert a Subversion repository to a Git repository. It should not to\n> +be confused with linkgit:git-svnimport[1], which does Subversion to\n> +Git conversion, but not the other direction.\n\nI don't know if it's such a good idea to mention git-svnimport at all;\nbut if you do, please also mention that it's no longer supported. (But\nreally, since it is no longer supported, I doubt mentioning it is a\ngood idea.)\n\n-- \nKarl Hasselström, kha@treskal.com\n      www.treskal.com/kalle\n"}]}