Fill in documentation references

[debian-kernel-talk.git] / index.html

diff --git a/index.html b/index.html
index ccc8b2734169428919b7d911271078a954dadf3c..c5f243ea59ab84a3c12fcef4ad37c173ac08a2bd 100644 (file)
--- a/index.html
+++ b/index.html
@@ -298,19 +298,110 @@
 </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>
+      <tt>make && make install</tt>
+    </li>
+    <li>
+      <tt>make deb-pkg</tt> - build packages
+    </li>
+    <li>
+      <tt>make-kpkg</tt> - build packages with more customisation;
+      requires kernel-package
+    </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>
+      <tt>dkms</tt> - builds and installs modules automatically.  Can
+      build packages for installation on other systems.  Also
+      supported by Ubuntu and SUSE.
+    </li>
+    <li>
+      <tt>module-assistant</tt> - 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 <tt>firmware-nonfree</tt> 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>
+      <tt>manpages-dev</tt> - the system call API
+    </li>
+    <li>
+      <tt>linux-doc-</tt><var>upstream</var> - miscellaneous upstream
+      documentation
+    </li>
+    <li>
+      <tt>linux-manual-</tt><var>upstream</var> - the internal API,
+      based on structured comments
+    </li>
+    <li>
+      <tt>debian-kernel-handbook</tt> - 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">