From: lucas <lucas@313b444b-1b9f-4f58-a734-7bb04f332e8d>
Date: Sun, 31 Jul 2011 17:51:46 +0000 (+0000)
Subject: Add instructions how to mark a non-free package as auto-buildable.
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=commitdiff_plain;h=8abcafe67336a07aaea02b8f9504f8d72fdce74e

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 dad0d41..66adb77 100644
--- 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 4adf589..6cf0378 100644
--- 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 55316de..6846e24 100644
--- 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">