From: Manoj Srivastava Date: Thu, 16 Jun 2005 05:41:32 +0000 (+0000) Subject: proper description of the restructuring X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=57910978852f6266557be3429a0eef810edc298e;p=debian%2Fdebian-policy.git proper description of the restructuring Author: joy Date: 2003/07/08 17:32:33 proper description of the restructuring git-archimport-id: srivasta@debian.org--etch/debian-policy--devel--3.0--patch-241 --- diff --git a/debian/changelog b/debian/changelog index a190b2a..0ee6500 100644 --- a/debian/changelog +++ b/debian/changelog @@ -2,7 +2,25 @@ debian-policy (3.6.0) unstable; urgency=low Josip: * Restructured Policy, closes: #189306. - XXX write a better description here XXX + + Many packaging manual appendices that were integrated into policy + sections are now empty, and replaced with links to the Policy. + In particular, the appendices that included the list of control + fields were updated (new fields like Closes, Changed-By were added) + and the list of fields for each of control, .changes and .dsc files + is now in Policy, and they're marked mandatory, recommended or + optional based on the current practice and the behaviour of the + deb-building toolchain. + + Elimination of needlessly deep section levels, primarily in the + chapter Debian Archive, from which two new chapters were split out, + Binary packages and Source packages. What remained was reordered + properly, that is, some sect1s became sects etc. + + Several sections that were redundant, crufty or simply not designed + with any sort of vision, were rearranged according to the formula that + everything should be either in the same place or properly interlinked. + Some things remained split up between different chapters when they + talked about different aspects of files: their content, their syntax, + and their placement in the file system. In particular, see the new + sections about changelog files. Manoj: * Added Games/Simulation to menu subpolicy closes: Bug#194974 * Added Apps/Educational to menu subpolicy closes: Bug#194972 diff --git a/upgrading-checklist.html b/upgrading-checklist.html index 6e717b6..a5fd0c8 100644 --- a/upgrading-checklist.html +++ b/upgrading-checklist.html @@ -55,6 +55,27 @@ picking your way through this list. 
 3.6.0                      Jul 2003
 
+     - Restructuring causing shifts in section numbers and bumping of
+       the minor version number:
+     + Many packaging manual appendices that were integrated into policy
+       sections are now empty, and replaced with links to the Policy.
+       In particular, the appendices that included the list of control
+       fields were updated (new fields like Closes, Changed-By were added)
+       and the list of fields for each of control, .changes and .dsc files
+       is now in Policy, and they're marked mandatory, recommended or
+       optional based on the current practice and the behaviour of the
+       deb-building toolchain.
+     + Elimination of needlessly deep section levels, primarily in the
+       chapter Debian Archive, from which two new chapters were split out,
+       Binary packages and Source packages. What remained was reordered
+       properly, that is, some sect1s became sects etc.
+     + Several sections that were redundant, crufty or simply not designed
+       with any sort of vision, were rearranged according to the formula that
+       everything should be either in the same place or properly interlinked.
+       Some things remained split up between different chapters when they
+       talked about different aspects of files: their content, their syntax,
+       and their placement in the file system. In particular, see the new
+       sections about changelog files.
      - Added Games/Simulation and Apps/Education to menu subpolicy
        [menu policy]
      - Debian changelogs should be UTF-8 encoded. [C.2.2]