svn-all-fast-export/svn2git

How to start the migration on local computer of svn repository?

Opened this issue · 0 comments

I read the README file of this repo and I was able to build the tool, but now I don't get what I have to do. I also read this page from KDE, but it wasn't helpful to me to getting started.

Local configuration

I built the tool and I have the svn-all-fast-export executable.
I have also the checkout of a svn repository (in folder my-project) that I want to migrate to git.

Questions

  1. How can I specify that I want my-project to be converted to a git repository?
  2. Is there a way to provide the remote svn url of the project directly instead of the local folder?
  3. When I run ./svn-all-fast-export --identity-map accounts --rules my-rules (as defined in KDE articole above) where I should tell to the tool what SVN repository it have to migrate?

Unfortunately, the samples folder is only related to rule files and it doesn't help me.

Suggestions

I would suggest to add more details in the README (or a Wiki page) to get started with the tool in a dedicated section, with a complete example which states:

  1. How to specify the svn repo to be migrated, either with reference to a remote repository (i.e. https://my-svn-server/my-project) or a local folder containing the repository checked out (i.e. /path/to/local/repo)
  2. If this information is contained in the rules file, add a basic example of it which tell that information
  3. Given one configuration (remote or local), how to run the command to start the migration

If those information are currently available, I didn't find those already, so I would kindly ask an help to get started with this.
Thank you!