[Kernel-handbook-general] [PATCH 2/7] Remove documentation of linux-patch-debian package
Ben Hutchings
ben at decadent.org.uk
Sun Jun 3 17:38:23 UTC 2012
This has been obsoleted by packaging changes and is redundant with
snapshot.debian.org.
---
chapter-common-tasks.sgml | 40 --------------------
chapter-packaging.sgml | 91 +--------------------------------------------
chapter-source.sgml | 13 +------
debian/changelog | 2 +
4 files changed, 4 insertions(+), 142 deletions(-)
diff --git a/chapter-common-tasks.sgml b/chapter-common-tasks.sgml
index 0e7b50c..d69231c 100644
--- a/chapter-common-tasks.sgml
+++ b/chapter-common-tasks.sgml
@@ -12,46 +12,6 @@ $ tar jxf /usr/src/linux-source-2.6.18.tar.bz2
</example>
The unpacked source tree then will be available in <tt>linux-source-2.6.18</tt> directory.
</p>
-
- <p>
- In order to get the Debian kernel source at a patchlevel
- <em>different</em> from the one provided by the current
- <tt>linux-source-<em>version</em></tt> package, one should
- first install and unpack it, then roll back the unneeded
- patch sets using a script from the <tt>linux-patch-debian-<em>version</em></tt>
- package. In the steps mentioned in the previous example we
- assume that version 2.6.18-8 of the
- <tt>linux-source-2.6.18</tt> package was installed and
- unpacked, so that the Debian kernel source at patchlevel 8 is
- available in the <tt>linux-source-2.6.18</tt> directory. It
- can then be rolled back to the desired patchlevel (1 in the
- example below) by running
- <example>
-# apt-get install linux-patch-debian-2.6.18
-$ cd linux-source-2.6.18
-$ /usr/src/kernel-patches/all/2.6.18/apply/debian 2.6.18-1
- </example>
- The last command will <em>unapply</em> the set of patches,
- which lead from patchlevel 1 to patchlevel 8 and the
- resulting tree will appear as if it came from the version
- 2.6.18-1 of the <tt>linux-source-2.6.18</tt> package. This
- system ensures that the source code for any revision of the
- Debian kernel source may be recovered from the latest one,
- without keeping multiple copies of the source in the
- archive.
- </p>
-
- <p>
-
- The <tt>linux-patch-debian-<em>version</em></tt>
- package contains all the individual patches applied to the
- source to achieve any patchlevel up to <tt><em>N</em></tt>
- (e.g. patch level 8 for 2.6.18-8). They are stored in the
- directory
- <tt>/usr/src/kernel-patches/all/<em>version</em>/debian/</tt>.
-
- </p>
-
</sect>
<sect id="common-official">
<heading>Rebuilding official Debian kernel packages</heading>
diff --git a/chapter-packaging.sgml b/chapter-packaging.sgml
index b3b5c7e..92714d8 100644
--- a/chapter-packaging.sgml
+++ b/chapter-packaging.sgml
@@ -31,10 +31,7 @@
version 2.6.26 of the Debian kernel source patched to
patchlevel 2. Once the package is installed, the source
tarball is available at
- <tt>/usr/src/linux-source-<em>version</em>.tar.bz2</tt>. For
- the instructions on obtaining Debian kernel source with
- arbitrary patchlevel, see <ref id="common-getting">.
-
+ <tt>/usr/src/linux-source-<em>version</em>.tar.bz2</tt>.
</item>
<tag><tt>linux-manual-<em>version</em></tt></tag>
<item>
@@ -55,92 +52,6 @@
<tt>/usr/share/doc/linux-doc-<em>version</em></tt>.
</item>
- <tag><tt>linux-patch-debian-<em>version</em></tt></tag>
- <item>
-
- This package contains all patches used to produce the
- Debian kernel source. It also contains the scripts which
- allow application or un-application of patchsets, bringing
- the source to the desired patchlevel. After the
- installation the patches are installed in
- <tt>/usr/src</tt> as follows:
-
- <taglist>
- <tag><tt>/usr/src/kernel-patches/all/<em>version</em>/debian/</tt></tag>
- <item>
-
- This directory contains the hierarchy of subdirectories with individual
- compressed patch files for a given version. Subdirectories indicate
- source or purpose of the patches contained within it, like <tt>bugfix</tt>
- (essential bugfixes), <tt>debian</tt> (Debian-specific patches) or
- <tt>features</tt> (kernel features not yet merged upstream). Within
- these directories patches are further subdivided by architecture.
-
- </item>
- <tag><tt>/usr/src/kernel-patches/all/<em>version</em>/debian/series/</tt></tag>
- <item>
-
- This directory contains the control files, which
- determine which patches need to be applied (or
- unapplied) to move from one patchlevel to another. These
- are text files named <tt><em>N</em></tt>
- (or <tt><em>N</em>-extra</tt>), where <tt><em>N</em></tt>
- is the number specifiying the patchlevel. The file
- <tt><em>N</em></tt> contains a
- list of patches which need to be applied (in case when
- the name of the patch prepended with plus) or unapplied
- (if it is prepended with a minus) to move from
- patchlevel <tt><em>N</em>-1</tt> to patchlevel
- <tt><em>N</em></tt>. For example, the file
- <tt>1</tt> lists the patches which need
- to be applied to go from the original Debian kernel source to
- the patchlevel 1. Files
- named <tt><em>N</em>-extra</tt> list
- the architecture-specific patches, along with the
- architectures they apply to. There is also a special file
- <tt>orig-0</tt>, which lists the patches (scripts) which
- were applied (run) in order to obtain the Debian kernel
- source from upstream kernel source (by removing the parts
- incompatible with DFSG). Invocation of a script is identified
- by <tt>X</tt> in the first column in this file.
-
- </item>
- <tag><tt>/usr/src/kernel-patches/all/<em>version</em>/apply/debian</tt></tag>
- <item>
-
- This script may be used to change the patchlevel of the
- currently available source tree, when run from its
- top-level directory. For usage example see <ref
- id="common-getting">. Current patchlevel of the source tree
- is stored in the <tt>version.Debian</tt> file in the top-level
- directory, and script modifies it appropriately when switching
- from one patchlevel to another. You can specify patchlevel <tt>orig</tt>
- to remove all Debian-specific patches, rolling back to the original
- Debian kernel source (differing from upstream by removal of
- firmware and other problematic files, as well as changes required
- for the resulting kernel to be buildable). Note that there is currently
- a bug in the script, preventing rollbacks of more than one patchlevel.
- For example, if your tree is currently at patchlevel 2, a command
- <example>
-$ /usr/src/kernel-patches/all/2.6.26/apply/debian orig
- </example>
- is likely to fail, so use commands
- <example>
-$ /usr/src/kernel-patches/all/2.6.26/apply/debian 1
-$ /usr/src/kernel-patches/all/2.6.26/apply/debian orig
- </example>
- i.e. switch the levels one by one instead.
-
- <tag><tt>/usr/src/kernel-patches/all/<em>version</em>/unpatch/debian</tt></tag>
- <item>
-
- This script brings the tree to the <tt>orig</tt> patchlevel (equivalent
- to running <tt>/usr/src/kernel-patches/all/<em>version</em>/apply/debian orig</tt>).
- See previous sections for discussion.
-
- </item>
- </taglist>
- </item>
<tag><tt>linux-support-<em>version</em>-<em>abiname</em></tt></tag>
<item>
diff --git a/chapter-source.sgml b/chapter-source.sgml
index 5589b0b..87b33dc 100644
--- a/chapter-source.sgml
+++ b/chapter-source.sgml
@@ -16,9 +16,7 @@
archive. Such removal produces
<tt>linux-2.6_<em>version</em>.orig.tar.gz</tt> tarball, which
serves as the original upstream source. <em>version</em>
- is the actual upstream version. For the details on how the removal
- is implemented, see the description of <tt>linux-patch-debian</tt>
- package in <ref id="arch-indep">.
+ is the actual upstream version.
</p>
@@ -65,15 +63,6 @@
<tt>xen</tt> and <tt>openvz</tt>.
</p>
- <p>
-
- All the patches used in the process of building of the Debian
- official kernel packages are shipped as a part of
- <tt>linux-patch-debian-<em>version</em></tt> package. See its
- description in <ref id="arch-indep"> for more information about
- the patch system.
-
- </p>
</sect>
<sect id="acceptance">
<heading>Policy for patch acceptance</heading>
diff --git a/debian/changelog b/debian/changelog
index ec5c33c..3efc6e5 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,6 +2,8 @@ kernel-handbook (1.0.13) UNRELEASED; urgency=low
* Note that removed firmware is still packaged; suggested by Karl Goetz
* Remove documentation of linux-tree package, removed in squeeze
+ * Remove documentation of linux-patch-debian package, obsoleted by
+ packaging changes and redundant with snapshot.debian.org
-- Ben Hutchings <ben at decadent.org.uk> Fri, 16 Dec 2011 05:26:30 +0000
--
1.7.10
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 828 bytes
Desc: This is a digitally signed message part
URL: <http://lists.alioth.debian.org/pipermail/kernel-handbook-general/attachments/20120603/beb2cac1/attachment.pgp>
More information about the Kernel-handbook-general
mailing list