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

[Charles Plessy]

Author: plessy
Date: 2010-11-26 01:18:25 +0000 (Fri, 26 Nov 2010)
New Revision: 5518

Modified:
   trunk/community/website/docs/policy.xml
Log:
Mention git-import-orig.

This is way easier to use this than to update the upstream and pristine-tar branches by hand.


Modified: trunk/community/website/docs/policy.xml
===================================================================
--- trunk/community/website/docs/policy.xml	2010-11-26 01:02:08 UTC (rev 5517)
+++ trunk/community/website/docs/policy.xml	2010-11-26 01:18:25 UTC (rev 5518)
@@ -210,6 +210,11 @@
 		    </itemizedlist>
 		      <para>It is also possible to prepare a Git repository containing some of the package's history using the command <command>git-import-dscs --debsnap</command> from the helper toolkit <command>git-buildpackage</command>. This will download all the versions of a package available in <ulink url="http://snapshot.debian.org">snapshots.debian.org</ulink> and create tags for each of them. Note that as this paragraph is written, the tool is not aware that <emphasis>backports</emphasis> should be a different branch</para>
 		</sect2>
+		<sect2>
+		  <title>Updating a source package managed with Git</title>
+		  <para>Most source packages maintained as Git repositories in Debian Med are using the <command>git-buildpackage</command> helper toolkit. In doubt, try this one first.</para>
+		  <para><command>git-buildpackage</command>'s command <command>git-import-orig</command> allows very easy update of the <emphasis>upstream</emphasis> branch when the original sources are distributed as a compressed archive. Its option <command>--pristine-tar</command> is useful for stablizing the MD5 sum of the “<filename>orig.tar.gz</filename>” produced when building a source package from the repository alone (not doing so results in archive rejection of package updates). With recent versions of git-buildpackage, it is often unnecessary to rename the freshly downloaded original upstream archive.</para>
+		</sect2>
 	</sect1>
 	<sect1>
 		<title>Packaging</title>