Add instructions how to mark a non-free package as auto-buildable.

Patch from Moritz Muehlenhoff, ACKed by Andreas Barth.
Closes: #602838
git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@8907 313b444b-1b9f-4f58-a734-7bb04f332e8d

diff --git a/common.ent b/common.ent
index dad0d4165208d5e1f74345b26f8e5e62a27b2085..66adb7711a84e2d697d2d1a5cef860fd170235b6 100644 (file)
--- a/common.ent
+++ b/common.ent
@@ -157,6 +157,7 @@
 <!ENTITY email-ftpmaster "<email>ftpmaster@debian.org</email>">
 <!ENTITY email-bts-control "<email>control@&bugs-host;</email>">
 <!ENTITY email-security-team "<email>team@security.debian.org</email>">
+<!ENTITY email-nonfree-release "<email>nonfree@release.debian.org</email>">
 
 <!-- misc Debian info -->
 <!ENTITY file-bts-docs "<filename>/usr/share/doc/debian/bug-*</filename>">

diff --git a/debian/changelog b/debian/changelog
index 4adf589c95f7f3b1338bd7384ec78ed040c259fb..6cf037857f759e013af71b403ed378533e6a95c0 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -10,8 +10,11 @@ developers-reference (3.4.6) UNRELEASED; urgency=low
     Patch from Thijs Kinkhorst. Closes: #610782
   * Document the process of returning after retirement.
     Patch from Serafeim Zanikolas. Closes: #540249
+  * Add instructions how to mark a non-free package as auto-buildable.
+    Patch from Moritz Muehlenhoff, ACKed by Andreas Barth.
+    Closes: #602838
 
- -- Lucas Nussbaum <lucas@debian.org>  Sat, 30 Jul 2011 15:58:53 +0200
+ -- Lucas Nussbaum <lucas@debian.org>  Sun, 31 Jul 2011 19:46:12 +0200
 
 developers-reference (3.4.5) unstable; urgency=low
 

diff --git a/pkgs.dbk b/pkgs.dbk
index 55316de0887253634946fbffa3dbfb1c9e246efc..6846e24c98b53a7ac7735643ad26c7396990a519 100644 (file)
--- a/pkgs.dbk
+++ b/pkgs.dbk
@@ -1871,6 +1871,35 @@ role="package">ftp.debian.org</systemitem>.
 </para>
 </section>
 
+<section id="non-free-buildd">
+<title>Marking non-free packages as auto-buildable</title>
+<para>
+By default packages from non-free are not built by the autobuilder
+network (mostly because the license of the packages could disapprove).
+To enable a package to be build you need to perform the following
+steps:
+</para>
+<orderedlist numeration="arabic">
+<listitem>
+<para>
+Check whether it is legally allowed and technically possible
+to auto-build the package ;
+</para>
+</listitem>
+<listitem>
+<para>
+Add <literal>XS-Autobuild: yes</literal> into the header part
+of <filename>debian/control</filename> ;
+</para>
+</listitem>
+<listitem>
+<para>
+Send an email to &email-nonfree-release; and explain why the
+package can legitimately and technically be auto-built.
+</para>
+</listitem>
+</orderedlist>
+</section>
 </section>
 
 <section id="nmu">