[linux] 06/08: README.source: Document how to update the changelog for a new upstream version

[debian-kernel at lists.debian.org]

This is an automated email from the git hooks/post-receive script.

benh pushed a commit to branch sid
in repository linux.

commit 316fdb166af6751e9c5fdee779d507cd1a68b34a
Author: Ben Hutchings <ben at decadent.org.uk>
Date:   Tue Mar 15 01:17:42 2016 +0000

    README.source: Document how to update the changelog for a new upstream version
---
 debian/README.source | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/debian/README.source b/debian/README.source
index 39894e0..98569e0 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -53,6 +53,36 @@ unifdef packages installed.
    will usually fail due to conflicts with upstream changes.  You need
    to resolve those by dropping or refreshing patches.
 
+Recording updates in the changelog
+----------------------------------
+
+Upstream commits that we already cherry-picked and included in a
+previous package upload should not be mentioned, since they don't make
+any difference to the package.  Any other commits that fix a Debian
+bug report and/or a security issue with a CVE ID should always be
+listed, along with the (Closes: #nnnnnn) and/or (CVE-yyyy-nnnn)
+reference.
+
+Aside from those general rules:
+
+* For an upstream release candidate, don't attempt to list the changes
+
+* For a stable release by Linus, refer to the summary at
+  kernelnewbies.org, e.g. http://kernelnewbies.org/Linux_4.5
+
+* For a stable update, refer to the changelog on kernel.org, e.g.
+  https://www.kernel.org/pub/linux/kernel/v4.x/ChangeLog-4.5.1, and
+  list all changes that are relevant to our package and that fix bugs
+  that we would consider 'important' or higher severity
+
+  - The script debian/bin/stable-update.sh updates the changelog
+    version and inserts the list of changes (but it doesn't always
+    put it in the right place!).  It doesn't attempt to filter out
+    irrelevant or unimportant changes.
+
+  - The script debian/bin/ckt-stable-update.sh does the same for
+    stable updates by the Canonical Kernel Team.
+
 Applying patches to the Debian kernel tree
 ==========================================
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/kernel/linux.git