Document debian-installer section and link to section list

Document the special debian-installer section in the list of current
sections and add a link to the list of sections in unstable, which
contains longer descriptions.  (Closes: #577666)

diff --git a/debian/changelog b/debian/changelog
index 7e7fb00ce4c02e5d74ee27e8264bf18f02f54223..5b595e25df4bebecbb354a1623c86c15004e577d 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -38,6 +38,9 @@ debian-policy (3.8.5.0) UNRELEASED; urgency=low
     new feature and not well-known.  (Closes: #563425)
   * Clarify in the Perl Policy that perl-base is essential, not perl, and
     don't imply packages need to depend on perl-base.  (Closes: #576594)
+  * Document the special debian-installer section in the list of current
+    sections and add a link to the list of sections in unstable, which
+    contains longer descriptions.  (Closes: #577666)
 
  -- Bill Allombert <ballombe@debian.org>  Mon, 31 May 2010 20:00:28 +0200
 

diff --git a/policy.sgml b/policy.sgml
index 9cb4d6cc949ea08686dee939b23a19d2b01d62e2..91ae7b08a3ce85334f845a6ca9250ab3d7f65281 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -689,7 +689,15 @@
          <em>ruby</em>, <em>science</em>, <em>shells</em>, <em>sound</em>,
          <em>tex</em>, <em>text</em>, <em>utils</em>, <em>vcs</em>,
          <em>video</em>, <em>web</em>, <em>x11</em>, <em>xfce</em>,
-         <em>zope</em>.
+         <em>zope</em>.  The additional section <em>debian-installer</em>
+         contains special packages used by the installer and is not used
+         for normal Debian packages.
+       </p>
+
+       <p>
+         For more information about the sections and their definitions,
+         see the <url id="http://packages.debian.org/unstable/"
+                      name="list of sections in unstable">.
        </p>
       </sect>