View source for Subversion to Git Conversion: Notes on the Details

Main reference: [https://github.com/nirvdrum/svn2git svn2git README file], hereafter referred to as README.

==Preliminaries==

===Install svn2git===

Follow instructions in README.

===Prepare Translation of Author Information===

* Used an "authors" file in /home/marki/.svn2git as described in README.
* Wrote script [https://gist.github.com/markito3/a1865019f9d600f8e897#file-user_list_svn_convert-pl user_list_svn_convert.pl] to extract all usernames in the "halld" group at JLab and put them into the "authors" file. Creates email address by appending "@jlab.org" in '''all''' cases. If any authors are missing in the file, svn2git will exit and report the omission as an error.

==Subversion State at Conversion==

The last revision in the Subversion repository before conversion: Rev 19042 2015-07-15 17:35:06

==The Procedure==
Details of the steps are described in README.
<ol>
	<li>Delete the practice repositories on GitHub.</li>
	<li>Create a blank repository to receive the converted repository on GitHub.</li>
	<li>Make a copy of the complete Subversion repository on the local disk with rsync.</li>
	<li>Use svn2git to do the conversion using the local-disk-resident version of the Subversion repository.</li>
	<li>In the resulting git repository, delete branches and tags not related to the package, as well as all "@revision" branches and tags.</li>
	<li>Clone a bare copy of the repository (--bare option).</li>
	<li>Push the bare copy to the GitHub repository with the --mirror option.</li>
	<li>Add repositories to the list of those owned by the gluex team on GitHub.</li>
</ol>
The sim-recon conversion with svn2git took about 8 hours. Hdds took about 20 hours.

==Command Syntax==

The magic command to convert from subversion to git:

<code>cd /path/to/conversion<br/>
svn2git https://halldsvn.jlab.org/repos --no-minimize-url -v --trunk trunk/sim-recon --branches branches --tags tags</code>

To prepare local repository for import to GitHub:

<code>cd /path/to/clone<br/>
git clone --bare file:///path/to/conversion</code>

To do the import, from the local host:

<code>cd /path/to/clone/conversion.git</code><br/>
<code>git push --mirror https://github.com/jeffersonlab/sim-recon.git</code>