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>&lt;package&gt;</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>&lt;username&gt;</emphasis>, you have
                                                        write 
permission:<programlisting>
-<command>svn co</command> <filename 
class="directory">svn+ssh://[email protected]/svn/debian-med/trunk/...</filename>
-<command>git clone</command> <filename 
class="directory">git+ssh://[email protected]/git/debian-med/&lt;package&gt;.git</filename></programlisting>
+<command>debcheckout</command> 
<option>--user</option><replaceable>&lt;username&gt;</replaceable> 
<replaceable>&lt;package&gt;</replaceable>   # When the package is already in 
the archive
+<command>debcheckout</command> <option>--user</option> 
<replaceable>&lt;username&gt;</replaceable> 
<replaceable>ssh://svn.debian.org/debian-med/trunk/packages/&lt;package&gt;/trunk</replaceable>
 <replaceable>&lt;package&gt;</replaceable>
+<command>debcheckout</command> <option>--user</option> 
<replaceable>&lt;username&gt;</replaceable> 
<replaceable>git://git.debian.org/debian-med/&lt;package&gt;.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/&lt;package&gt;.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>


_______________________________________________
debian-med-commit mailing list
[email protected]
http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/debian-med-commit

Reply via email to