From 5115862c945337cdf63cb4fabdc4835233e48087 Mon Sep 17 00:00:00 2001
From: Russ Allbery <rra@debian.org>
Date: Wed, 2 Jun 2010 10:02:43 -0700
Subject: [PATCH] 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)
---
 debian/changelog |  3 +++
 policy.sgml      | 10 +++++++++-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/debian/changelog b/debian/changelog
index 7e7fb00..5b595e2 100644
--- 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 9cb4d6c..91ae7b0 100644
--- 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>
 
-- 
2.39.2