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

[Charles Plessy]

Author: plessy
Date: 2012-01-09 02:50:09 +0000 (Mon, 09 Jan 2012)
New Revision: 9217

Modified:
   trunk/community/website/docs/policy.xml
Log:
Document getting the packages with debcheckout instead of git or svn directly.


Modified: trunk/community/website/docs/policy.xml
===================================================================
--- trunk/community/website/docs/policy.xml	2012-01-08 21:42:53 UTC (rev 9216)
+++ trunk/community/website/docs/policy.xml	2012-01-09 02:50:09 UTC (rev 9217)
@@ -122,39 +122,38 @@
 		<sect2 id="source">
 			<title>Give me the source!</title>
 			<para>
-				To check sources out from our repositories, please do:
+				To check the sources of a package (referred as
+				<emphasis><package></emphasis> below) in our repositories, use the
+				<command>debcheckout</command> command, from the
+				<ulink url="http://packages.debian.org/devscripts">devscripts</ulink>
+				package.
 				<itemizedlist>
 					<listitem>
 						<para>
-							If you are a member of Debian Med or a Debian developer, you have
+							If you are a member of Debian Med or a Debian developer, with
+							account name <emphasis><username></emphasis>, you have
 							write permission:<programlisting>
-<command>svn co</command> <filename class="directory">svn+ssh://user@svn.debian.org/svn/debian-med/trunk/...</filename>
-<command>git clone</command> <filename class="directory">git+ssh://user@git.debian.org/git/debian-med/<package>.git</filename></programlisting>
+<command>debcheckout</command> <option>--user</option><replaceable><username></replaceable> <replaceable><package></replaceable>   # When the package is already in the archive
+<command>debcheckout</command> <option>--user</option> <replaceable><username></replaceable> <replaceable>ssh://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>
 					</listitem>
 					<listitem>
 						<para>
-							For read-only access, the syntax is slightly
-							different:<programlisting>
-<command>svn co</command> <filename class="directory">svn://svn.debian.org/debian-med/trunk/...</filename>
-<command>git clone</command> <filename class="directory">git://git.debian.org/debian-med/<package>.git</filename></programlisting>
+							For read-only access, remove the <option>--user</option> option.
 						</para>
 					</listitem>
 				</itemizedlist>
 			</para>
-			<para>
-				Another way to check the sources is through the use of the
-				<command>debcheckout</command> command, from the
-				<ulink url="http://packages.debian.org/devscripts">devscripts</ulink>
-				package.  Its <option>-a</option> option checks out or clone for write
-				access.
-			</para>
 		</sect2>
 		<sect2 id="ssh-tips">
 			<title>SSH tips</title>
 			<para id="ssh-config">
 				You can avoid specifying your Alioth user name by setting it in
-				<filename>~/.ssh/config</filename>:<programlisting>
+				<filename>~/.ssh/config</filename> as follows.  Note that in that case,
+				with <command>debcheckout</command> you will can replace the
+				<option>--user</option> option by the <option>-a</option> option, for a
+				shorter typing.<programlisting>
 Host *.debian.org
 	User your-user-name</programlisting>
 			</para>