README.source: Document how to update the changelog for a new upstream version

This commit is contained in:
Ben Hutchings 2016-03-15 01:17:42 +00:00
parent 5bb08e7930
commit 316fdb166a
1 changed files with 30 additions and 0 deletions

30
debian/README.source vendored
View File

@ -53,6 +53,36 @@ unifdef packages installed.
will usually fail due to conflicts with upstream changes. You need will usually fail due to conflicts with upstream changes. You need
to resolve those by dropping or refreshing patches. 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 Applying patches to the Debian kernel tree
========================================== ==========================================