From: aph <aph@313b444b-1b9f-4f58-a734-7bb04f332e8d>
Date: Sun, 29 Feb 2004 19:55:08 +0000 (+0000)
Subject: sec. override-file: retitle, reword, describe how the Section field specifies both... 
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=commitdiff_plain;h=e22960e1f9662cd1423a048a8dbfbc2c01e92dcd

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


git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@2503 313b444b-1b9f-4f58-a734-7bb04f332e8d
---

diff --git a/developers-reference.sgml b/developers-reference.sgml
index ad13458..585387b 100644
--- 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