X-Git-Url: https://git.decadent.org.uk/gitweb/?p=debian-kernel-talk.git;a=blobdiff_plain;f=index.html;h=f481aea5f4de96a57ba6fc2f08e4129040dc9bd6;hp=ccc8b2734169428919b7d911271078a954dadf3c;hb=e20b6148485476aad06340b609ec888106b17167;hpb=8025c1bbe25c79fc7d940db4df042db019222d5e

diff --git a/index.html b/index.html
index ccc8b27..f481aea 100644
--- a/index.html
+++ b/index.html
@@ -22,6 +22,8 @@
   table { border-collapse: collapse }
   th { border-bottom: 2pt solid black }
   th, td { padding: 0 6pt }
+  .package { font-family: monospace }
+  var { font-family: sans }
 </style>
 <style type="text/css" media="print">
   .slide { page-break-after: always }
@@ -229,31 +231,32 @@
 <div class="slide">
   <h1>Official Linux kernel packages (1)</h1>
   <p>
-    Main source package is linux-2.6 (still!).  Most binary package
-    names change regularly.
+    Main source package is <span class="package">linux-2.6</span>
+    (still!).  Most binary package names change regularly.
   </p>
   <ul class="incremental">
     <li>
-      linux-image-<var>upstream</var>-<var>abi</var>-<var>flavour</var>
+      <span class="package">linux-image-<var>upstream</var>-<var>abi</var>-<var>flavour</var></span>
       - compiled kernel and modules
     </li>
     <li>
-      linux-headers-<var>upstream</var>-<var>abi</var>-<var>flavour</var>
+      <span class="package">linux-headers-<var>upstream</var>-<var>abi</var>-<var>flavour</var></span>
       (and others) - development package for OOT modules
     </li>
     <li>
-      linux-libc-dev - headers for userland
+      <span class="package">linux-libc-dev</span> - headers for userland
     </li>
     <li>
-      linux-source-<var>upstream</var> - for custom kernels
+      <span class="package">linux-source-<var>upstream</var></span> -
+      for custom kernels
     </li>
     <li>
-      linux-doc-<var>upstream</var>, linux-tools-<var>upstream</var>,
-      etc.
+      <span class="package">linux-doc-<var>upstream</var></span>,
+      <span class="package">linux-tools-<var>upstream</var></span>, etc.
     </li>
     <li>
-      linux-support-<var>upstream</var>-<var>abi</var> - scripts and
-      metadata to support linux-latest-2.6
+      <span class="package">linux-support-<var>upstream</var>-<var>abi</var></span> -
+      scripts and metadata to support linux-latest-2.6
     </li>
   </ul>
 </div>
@@ -261,23 +264,27 @@
 <div class="slide">
   <h1>Official Linux kernel packages (2)</h1>
   <p>
-    The linux-latest-2.6 source package builds meta-packages to
-    support automatic upgrades between binaries built from linux-2.6.
+    The <span class="package">linux-latest-2.6</span> source package builds meta-packages
+    to support automatic upgrades between binaries built
+    from <span class="package">linux-2.6</span>.
   </p>
   <ul class="incremental">
     <li>
-      linux-image-<var>flavour</var>
+      <span class="package">linux-image-<var>flavour</var></span>
     </li>
     <li>
-      linux-headers-<var>flavour</var>
+      <span class="package">linux-headers-<var>flavour</var></span>
     </li>
     <li>
-      linux-source, linux-doc, linux-tools, etc.
+      <span class="package">linux-source</span>,
+      <span class="package">linux-doc</span>,
+      <span class="package">linux-tools</span>, etc.
     </li>
   </ul>
   <p class="incremental">
-    The installer will normally install linux-image-<var>flavour</var>
-    (for some appropriate <var>flavour</var>).
+    The installer will normally install
+    <span class="package">linux-image-<var>flavour</var></span> (for
+    some appropriate <var>flavour</var>).
   </p>
 </div>
 
@@ -285,32 +292,129 @@
   <h1>Official Linux kernel packages (3)</h1>
   <ul class="incremental">
     <li>
-      firmware-free - separate 'firmware' compliant with DFSG
+      <span class="package">firmware-free</span> - separate 'firmware'
+      compliant with DFSG
     </li>
     <li>
-      linux-base - base package for images and tools
+      <span class="package">linux-base</span> - base package for
+      images and tools
     </li>
     <li>
-      linux-kbuild-2.6 builds linux-kbuild-<var>upstream</var> -
-      code used for building OOT modules
+      <span class="package">linux-kbuild-2.6</span> builds
+      <span class="package">linux-kbuild-<var>upstream</var></span> -
+      kernel build system and tools for building OOT modules
     </li>
   </ul>
 </div>
 
 <div class="slide">
-  <h1>Custom Linux kernel packages</h1>
+  <h1>Custom Linux kernel builds</h1>
+  <p>
+    The official packages work for most users, but not all:
+  </p>
+  <ul class="incremental">
+    <li>
+      Different ARM platforms need incompatible configurations,
+      and we cannot build them all
+    </li>
+    <li>
+      New features are not enabled immediately if we are worried
+      about potential regressions
+    </li>
+  </ul>
+  <p class="incremental">
+    Using either upstream source or Debian linux-source package:
+  </p>
+  <ul class="incremental">
+    <li>
+      <span class="package">make && make install</span>
+    </li>
+    <li>
+      <span class="package">make deb-pkg</span> - build packages
+    </li>
+    <li>
+      <span class="package">make-kpkg</span> - build packages with
+      more customisation; requires
+      <span class="package">kernel-package</span>
+    </li>
+  </ul>
 </div>
 
 <div class="slide">
   <h1>Out-of-tree modules</h1>
+  <p>
+    The kernel team does not encourage the use of out-of-tree modules.
+    However, we support them by providing development packages and by
+    avoiding ABI changes during a stable release.
+  </p>
+  <p class="incremental">
+    Debian has two packages to aid in building out-of-tree modules:
+  </p>
+  <ul class="incremental">
+    <li>
+      <span class="package">dkms</span> - builds and installs modules
+      automatically.  Can build packages for installation on other
+      systems.  Also supported by Ubuntu and SUSE.
+    </li>
+    <li>
+      <span class="package">module-assistant</span> - builds packages
+      as directed.  Uses a separate package name for each kernel ABI.
+    </li>
+  </ul>
 </div>
 
 <div class="slide">
   <h1>Firmware files</h1>
+  <ul class="incremental">
+    <li>
+      Most peripherals have microcontroller running non-free
+      firmware; some require host to load it
+    </li>
+    <li>
+      Several drivers used to include firmware, making kernel
+      non-free.  Fudged with GRs for a while; finally fixed in squeeze
+    </li>
+    <li>
+      Users with these devices - almost any wifi card, some network
+      controllers and Radeon GPUs - will still need the firmware
+      files installed
+    </li>
+    <li>
+      Kernel team maintains
+      <span class="package">firmware-nonfree</span> source package
+      covering most firmware files that are clearly redistributable
+    </li>
+    <li>
+      Also collected in linux-firmware.git repository maintained by
+      David Woodhouse and myself
+    </li>
+  </ul>
 </div>
 
 <div class="slide">
   <h1>Documentation</h1>
+  <ul class="incremental">
+    <li>
+      <span class="package">manpages-dev</span> - the system call API
+    </li>
+    <li>
+      <span class="package">linux-doc-</span><var>upstream</var> -
+      miscellaneous upstream documentation
+    </li>
+    <li>
+      <span class="package">linux-manual-</span><var>upstream</var> -
+      the internal API, based on structured comments
+    </li>
+    <li>
+      <span class="package">debian-kernel-handbook</span> -
+      Debian-specific information; currently also Linux-specific but
+      could cover other kernels
+    </li>
+    <li>
+      <a href="http://wiki.debian.org/DebianKernel">http://wiki.debian.org/DebianKernel</a>
+      - wiki index page
+    </li>
+  </ul>
 </div>
 
 <div class="slide">