Moved the opinion that one should add new changelog items, rather than

Author: srivasta
Date: 2005/02/05 00:55:19
Moved the opinion that one should add new changelog items, rather than
editing old entries, into a footnote.

git-archimport-id: srivasta@debian.org--etch/debian-policy--devel--3.0--patch-281

diff --git a/debian/changelog b/debian/changelog
index d87f764c18f46d17ad51fa6511645844d2764df5..7b91bef87b533bbe4e92bc6e7720cdc36cf59b8a 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -29,6 +29,10 @@ debian-policy (3.6.2.1) unstable; urgency=low
     suggested in the bug report, just use which. which lives in an
     essential package, so can be used in the preinst of packages.
                                                              (Closes: #291026).
+  * Bug fix: "debian-policy: please clarify/loosen the policy on rewriting
+    history", thanks to Frank Küster. Since this was not really a
+    directive, but merely an expression of an opinion, moved it into an
+    informative footnote.                                    (Closes: #290270).
 
  --
 

diff --git a/policy.sgml b/policy.sgml
index 103bf369ad983a46c1e321842e9796315b579ece..b6502d6b9b560c0a6d8dd62dddffad5abb3c7261 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -1496,7 +1496,14 @@
        <p>
          Changes in the Debian version of the package should be
          briefly explained in the Debian changelog file
-         <file>debian/changelog</file>. This includes modifications
+         <file>debian/changelog</file>.<footnote>
+            <p>
+              Mistakes in changelogs are usually best rectified by
+              making a new changelog entry rather than "rewriting
+              history" by editing old changelog entries.
+            </p>
+          </footnote>
+          This includes modifications
          made in the Debian package compared to the upstream one
          as well as other changes and updates to the package.
          <footnote>
@@ -1510,9 +1517,7 @@
        </p>
 
         <p>
-          Mistakes in changelogs are usually best rectified by making
-         a new changelog entry rather than "rewriting history" by
-          editing old changelog entries.
+          
         </p>
 
         <p>