[med-svn] r24070 - trunk/community/website/docs

[Andreas Tille]

Author: tille
Date: 2017-09-22 07:58:23 +0000 (Fri, 22 Sep 2017)
New Revision: 24070

Modified:
   trunk/community/website/docs/policy.xml
Log:
Start documenting SVN to Git migration


Modified: trunk/community/website/docs/policy.xml
===================================================================
--- trunk/community/website/docs/policy.xml	2017-09-22 07:23:20 UTC (rev 24069)
+++ trunk/community/website/docs/policy.xml	2017-09-22 07:58:23 UTC (rev 24070)
@@ -115,11 +115,9 @@
 	</sect1>
 	<sect1 id="repositories">
 		<title>Repositories</title>
-		<para>We use Subversion (SVN) and Git repositories, hosted 
+		<para>We use Git repositories, hosted 
 		by Debian. You can have a look at
 		each repository through Alioth's web interfaces: 
-		<ulink url="http://svn.debian.org/viewsvn/debian-med/trunk/">ViewVC</ulink> and
-		<ulink url="http://anonscm.debian.org/gitweb/?a=project_list;pf=debian-med">gitweb</ulink> or
 		<ulink url="http://anonscm.debian.org/cgit/debian-med">cgit</ulink>.</para>
 		<warning id="umask">
 			<para>
@@ -147,7 +145,6 @@
 						</para>
 						<para>
 							For draft packages that are only on Alioth:<programlisting>
-<command>debcheckout</command> <option>--user</option> <replaceable><username></replaceable> <replaceable>svn://svn.debian.org/debian-med/trunk/packages/<package>/trunk</replaceable> <replaceable><package></replaceable>
 <command>debcheckout</command> <option>--user</option> <replaceable><username></replaceable> <replaceable>git://git.debian.org/debian-med/<package>.git</replaceable> <option>--git-track <replaceable>'*'</replaceable></option></programlisting> 
 						</para>
 						<para>
@@ -194,8 +191,9 @@
 			</para>
 		</sect2>
 		<sect2 id="svn-repository-structure">
-			<title>Subversion repository structure</title>
-			<para>The SVN repository is structured as follows:<programlisting>
+			<title>Subversion usage is deprecated</title>
+			<para>The Debian Med team is migrating from SVN to Git to catch up with the close
+			      down of Alith.  The deprecated SVN repository is structured as follows:<programlisting>
 debian-med/
  └ trunk/
     ├ community/
@@ -215,6 +213,25 @@
        │     └ debian/
        …</programlisting>
       </para>
+			<para>
+			If you touch a package in SVN you should do the following to migrate it to Git:
+			<programlisting>
+svn checkout svn://anonscm.debian.org/debian-med/trunk/helper-scripts
+cd helper-scripts
+convert_svn_2_git <package>
+cd <package>  # check that debian/ dir exists - if not check logfile!!
+git branch upstream
+gbp import-orig --pristine-tar <orig.tar.gz_of_last_uploaded_version>
+vi debian/control # replace Vcs-Fields from SVN to Git
+dch "Moved packaging from SVN to Git"
+../inject-into-alioth-git # this should work nicely to inject your package into git.debian.org
+			</programlisting>
+			In case <filename>convert_svn_2_git</filename> might fail for whatever reason your last resort is
+			<programlisting>
+gbp import-dscs --debsnap
+			</programlisting>
+			Please help the Debian Med team with the SVN to Git migration.
+			</para>
 		</sect2>
 		<sect2 id="subversion-tips">
 			<title>Subversion tips</title>