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

[Charles Plessy]

Author: plessy
Date: 2012-01-16 00:46:47 +0000 (Mon, 16 Jan 2012)
New Revision: 9292

Modified:
   trunk/community/website/docs/policy.xml
Log:
Documenting debian/gbp.conf.


Modified: trunk/community/website/docs/policy.xml
===================================================================
--- trunk/community/website/docs/policy.xml	2012-01-14 20:07:44 UTC (rev 9291)
+++ trunk/community/website/docs/policy.xml	2012-01-16 00:46:47 UTC (rev 9292)
@@ -625,6 +625,25 @@
 			<para>Packages hosted in our Subversion repository, that have been modified but not uploaded must use <literal>UNRELEASED</literal> as a distribution name. This can be done automatically by declaring <literal><varname>DEBCHANGE_RELEASE_HEURISTIC</varname>=<replaceable>changelog</replaceable></literal> in <filename>~/.devscripts</filename> and using <command>dch</command>.</para>
 		</sect2>
 		
+		<sect2 id="debian-gbp.conf">
+		  <title><filename>debian/gbp.conf</filename></title>
+			<para>
+			  Packages managed with <command>git-buildpackage</command> may mark this
+			  by including a <filename>debian/gbp.conf</filename> configuration
+			  file.  The following recommended values will make
+			  <command>pristine-tar</command> used by default, and otherwise set a
+			  directory layout similar to the one we use with
+			  <command>svn-buildpackage</command>.<programlisting>
+[DEFAULT]
+pristine-tar = True
+
+[git-buildpackage]
+# use this for more svn-buildpackage like behaviour:
+export-dir = ../build-area/
+tarball-dir = ../tarballs/</programlisting>
+			</para>
+		</sect2>
+		
 		<sect2 id="debian-readme-source">
 			<title><filename>debian/README.source</filename></title>
 			<para>This file is recommended by the Policy (<ulink url="http://www.debian.org/doc/debian-policy/ch-source.html#s-readmesource">§ 4.14</ulink>) from version 3.8.0 for documenting source package handling. Please follow the recommendation. For instance, this file is needed when we use a patch system, when the upstream sources are in another format than gzipped tar archive, when we repack the sources,…</para>