sec. override-file: retitle, reword, describe how the Section field specifies both...

[developers-reference.git] / developers-reference.sgml

diff --git a/developers-reference.sgml b/developers-reference.sgml
index ad13458ffb2f7eb1590992fa4df66fee3a82aa8c..585387ba09f26bd96e264d0e03ca32f558e41e8e 100644 (file)
--- a/developers-reference.sgml
+++ b/developers-reference.sgml
@@ -6,7 +6,7 @@
   <!ENTITY % commondata  SYSTEM "common.ent" > %commondata;
 
   <!-- CVS revision of this document -->
-  <!ENTITY cvs-rev "$Revision: 1.223 $">
+  <!ENTITY cvs-rev "$Revision: 1.224 $">
 
   <!-- if you are translating this document, please notate the CVS
        revision of the original developer's reference in cvs-en-rev -->
@@ -745,7 +745,7 @@ for installing the Debian distribution on a specific architecture
 (<file>disks-i386</file>, <file>disks-m68k</file>, etc.).
 
 
-      <sect1>Sections
+      <sect1 id="archive-sections">Sections
        <p>
 The <em>main</em> section of the Debian archive is what makes up the
 <strong>official &debian-formal; distribution</strong>.  The
@@ -1918,7 +1918,7 @@ will receive a separate email notifying you of that.  Read on below.
 Note also that if you upload via queues, the queue daemon software will
 also send you a notification by email.
 
-    <sect id="override-file">Determining section and priority of a package
+    <sect id="override-file">Specifying the package section, subsection and priority
        <p>
 The <file>debian/control</file> file's <tt>Section</tt> and
 <tt>Priority</tt> fields do not actually specify where the file will
@@ -1947,9 +1947,11 @@ For more information about <em>override files</em>, see <manref
 name="dpkg-scanpackages" section="8"> and
 <url id="&url-bts-devel;#maintincorrect">.
        <p>
-Note also that the term "section" is used for the separation of packages
-according to their licensing, e.g. <em>main</em>, <em>contrib</em> and
-<em>non-free</em>. This is described in another section, <ref id="archive">.
+Note that the <tt>Section</tt> field describes both the section as
+well as the subsection, which are described in <ref
+id="archive-sections">.  If the section is "main", it should be
+omitted.  The list of allowable subsections can be found in <url
+id="&url-debian-policy;ch-archive.html#s-subsections">.
 
 
     <sect id="bug-handling">Handling bugs