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 a190b2a3bb72ff3ae1606372a9986aec8b05723e..0ee65004accef09e2ff8358b525318b75533539e 100644 (file)
--- 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 6e717b6e6e6ac62f49aa53aed2ca4a2d3fb636ed..a5fd0c8e21d2925daeebb134ded525378a356552 100644 (file)
--- a/upgrading-checklist.html
+++ b/upgrading-checklist.html
@@ -55,6 +55,27 @@ picking your way through this list.
 <pre>
 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]