X-Git-Url: https://git.decadent.org.uk/gitweb/?p=debian-kernel-talk.git;a=blobdiff_plain;f=index.html;h=87218ad26b85ddcbf6c19df55f1e62a0c25dce9e;hp=9319220f6535b74db62749ed1fdbd62051eee2eb;hb=ffda40203fa56e4f73c98eb7746dfcf1fa53d87a;hpb=16066dcbed2e59e1ea42cdf424e7783b0f5fefaa

diff --git a/index.html b/index.html
index 9319220..87218ad 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,13 +292,16 @@
   <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> -
+      <span class="package">linux-kbuild-2.6</span> builds
+      <span class="package">linux-kbuild-<var>upstream</var></span> -
       code used for building OOT modules
     </li>
   </ul>
@@ -317,28 +327,94 @@
   </p>
   <ul class="incremental">
     <li>
-      <tt>make && make install</tt>
+      <span class="package">make && make install</span>
     </li>
     <li>
-      <tt>make deb-pkg</tt> - build packages
+      <span class="package">make deb-pkg</span> - build packages
     </li>
     <li>
-      <tt>make-kpkg</tt> - build packages with more customisation;
-      requires kernel-package
+      <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">