From 0451ed94bdbf665e2f55bc7dbdce438410ab4d97 Mon Sep 17 00:00:00 2001 From: Ben Hutchings Date: Mon, 1 May 2023 23:15:55 +0200 Subject: [PATCH] Remove obsolete text referring to "patchlevels" in source packages Before 2011, kernel udebs were built from separate source packages, and dak didn't support Built-Using. This meant there was no guarantee that the exact source version for the kernel udebs in a suite would be present in the same suite. To ensure that we could comply with the GPL's requirements for source availability, the kernel patch system supported multiple series files that could each add and remove patch files. Each Debian revision based on the same upstream version would add a new series file, and the source could be patched to the current or an older "patchlevel". This became obsolete once we started building kernel udebs directly, and the patch system has since been entirely replaced with quilt. --- chapter-common-tasks.dbk | 8 ++------ chapter-packaging.dbk | 7 ++----- chapter-source.dbk | 9 +-------- debian/changelog | 1 + 4 files changed, 6 insertions(+), 19 deletions(-) diff --git a/chapter-common-tasks.dbk b/chapter-common-tasks.dbk index c64e40f..18bbd77 100644 --- a/chapter-common-tasks.dbk +++ b/chapter-common-tasks.dbk @@ -5,8 +5,7 @@ Common kernel-related tasks
Obtaining the Debian kernel source -To get the Debian kernel source at the current maximum patchlevel, it is -sufficient to install the latest +To get the Debian kernel source, it is sufficient to install the latest linux-source-version package and unpack the source, for example: @@ -293,10 +292,7 @@ This will install the packages required by the kernel build process. This will download and unpack the linux source package, making the tree available in the -linux-version directory. As always, -the revision part of the version of this package (for example, 1 in 3.2.19-1) -will determine its patchlevel with respect to the original upstream kernel -source. +linux-version directory. diff --git a/chapter-packaging.dbk b/chapter-packaging.dbk index 3b77988..1132973 100644 --- a/chapter-packaging.dbk +++ b/chapter-packaging.dbk @@ -22,11 +22,8 @@ of the binary packages built from these source packages. linux-source-version -This package contains the Debian kernel source tarball. The patchlevel of the -source is determined by the Debian revision of the package, for example the -version 4.2.5-1 of the package linux-source-4.2 contains -the version 4.2.5 of the Debian kernel source patched to patchlevel 1. Once -the package is installed, the source tarball is available at +This package contains the Debian kernel source tarball. Once the +package is installed, the source tarball is available at /usr/src/linux-source-version.tar.xz. diff --git a/chapter-source.dbk b/chapter-source.dbk index 4e3bfcd..dcc1242 100644 --- a/chapter-source.dbk +++ b/chapter-source.dbk @@ -41,14 +41,7 @@ the source from linux_version.orig.tar.xz (that is, pristine kernel source with problematic parts removed) and applying a set of Debian patches. These patches typically implement essential fixes for serious -bugs and security holes. The Debian version of the kernel packages has the -form version-revision where -version is the upstream version of the -kernel (like 3.2.20) and revision -determines the patchlevel. For example, the packages with version 3.2.20-1 are -built from the linux_3.2.20.orig.tar.xz source, patched up -to patchlevel 1. Certain packages include extra 'featuresets' not included in -the upstream source, such as rt. +bugs and security holes.
diff --git a/debian/changelog b/debian/changelog index 1da9e5a..4eaf11a 100644 --- a/debian/changelog +++ b/debian/changelog @@ -3,6 +3,7 @@ kernel-handbook (1.0.21) UNRELEASED; urgency=medium * Try to reduce pain points in rebuilding official kernel packages (Closes: #1022061): - Reorder sections in "Common kernel-related tasks" to reduce confusion + * Remove obsolete text referring to "patchlevels" in source packages -- Ben Hutchings Mon, 01 May 2023 22:48:21 +0200