changeset 19:a6a6640500ae

Move master index content out to another file and clean up remaining index.html.
author Rob Landley <rob@landley.net>
date Thu, 09 Aug 2007 15:50:05 -0500
parents 31787234d021
children 8e9357f5cb1b
files index.html
diffstat 1 files changed, 16 insertions(+), 112 deletions(-) [+]
line wrap: on
line diff
--- a/index.html	Thu Aug 09 15:05:22 2007 -0500
+++ b/index.html	Thu Aug 09 15:50:05 2007 -0500
@@ -1,6 +1,16 @@
 <title>Linux Kernel Documentation</title>
 
-<h2>Sources of documentation</h2>
+<h1>todo</h1>
+<ul>
+<li><a href=master.html>Master index of linux kernel documentation</a> (Very much a work in progress)</a>
+<li><a href=local>Some locally produced docs</a></li>
+</ul>
+
+
+<h1>Sources of documentation</h1>
+
+<p>These are various upstream sources of documentation, most of which should
+be linked from the master index (above) once that's it's actually worth using.</p>
 
 <ul>
 <li><a href=Documentation>Text files in the kernel's Documentation directory.</a></li>
@@ -10,18 +20,19 @@
 <li>Linux Device Drivers book (<a href=http://lwn.net/Kernel/LDD3/>third edition</a>) (<a href=http://www.xml.com/ldd/chapter/book/>second edition</a>)</li>
 <li><a href=ols>Ottawa Linux Symposium papers</li>
 <li><a href=http://www.linuxjournal.com/xstatic/magazine/archives>Linux Journal archives</a></li>
-<li><a href=http://www.ibm.com/developerworks/views/linux/library.jsp>IBM Developerworks Linux Library</a></li>
+<li><a href=http://www.ibm.com/developerworks/views/linux/library.jsp>IBM Developerworks Linux Library</a> (also <a href=http://www.ibm.com/developerworks/linux/library/l-linux-kernel/>here</a>)
+</li>
 <li><a href=http://www.tux.org/lkml/>Linux Kernel Mailing List FAQ</a></li>
 <li><a href=http://kernelplanet.org>Kernel Planet (blog aggregator)</a></li>
 </ul>
 
-<p>Standards</p>
+<h1>Standards</h1>
 <ul>
 <li><a href=http://www.opengroup.org/onlinepubs/009695399/>Single Unix Specification v3</a> (Also known as Open Group Base Specifications issue 6, and closely overlapping with Posix.  See especially <a href=http://www.opengroup.org/onlinepubs/009695399/idx/xsh.html>system interfaces</a>)</li>
 <li><a href=http://www.linux-foundation.org/spec/refspecs/>Linux Foundation's specs page</a> (ELF, Dwarf, ABI...)</li>
 </ul>
 
-<h2>Translations</h2>
+<h1>Translations</h1>
 <ul>
 <li><a href=http://tlktp.sourceforge.net/>Linux Kernel Translation Project</a></li>
 <li><a href=http://kernelnewbies.org/RegionalNewbies>Kernel Newbies regional pages</a></li>
@@ -29,112 +40,5 @@
 <li><a href=http://zh-kernel.org/docs>Chinese</a></li>
 </ul>
 
-<p>todo</p>
-<ul>
-<li><a href=local>Index of terms used by the kernel</a></li>
-</ul>
 
-<!--
-http://www.ibm.com/developerworks/linux/library/l-linux-kernel/
--->
-<title>Linux Kernel Documentation</title>
-
-<h1>Topics</h1>
-
-<pre>
-Building from source
-   Configuring, building, Installing, running, debugging
-     User interface
-     infrastructure (kbuild, tmppiggy)
-   Cross compiling, building out of tree, UML, QEMU
-
-Source code layout
-  Following the boot
-  Major subsystems
-  Architectures
-
-Infrastructure
-  Process Scheduler
-    fork, exec, sleep
-  Timers
-    Interrupt handling
-  memory management
-    mmap, DMA
-    <a href=gorman>Understanding the Linux Virtual Memory Manager</a>, by Mel Gorman.
-  vfs
-    Filesystems
-      Types of filesystems
-        Block backed
-        Ram backed
-        Synthetic
-          /proc /sys symfs usbfs devpts
-        Network
-          FUSE
-      Filesystem drivers
-  Drivers:
-    Filesystem
-    Block (block layer, scsi layer)
-      SCSI:
-	<ul>
-	<li><a href=Documentation/scsi>Documentation/scsi</a> scsi.txt scsi_mid_low_api.txt scsi-generic.txt scsi_eh.txt</li>
-        <li><a href=http://sg.torque.net/sg/p/sg_v3_ho.html>SCSI Generic (sg) HOWTO</a></li>
-	<li><a href=xmlman/man4/sd.html>man 4 sd</a></li>
-	</ul>
-    Character (tty, audio, null, random/urandom, zero)
-    DRI
-  Hotplug
-  Input core.
-  Network
-  Modules
-    EXPORT_SYMBOL, EXPORT_SYMBOL_GPL
-  Busses
-  API (how userspace talks to the kernel)
-    Syscalls, ioctls
-    executable file formats
-      a.out, elf, #! flat misc
-        css, bss, 
-    Device nodes
-    Pipes (new pipe infrastructure)
-    Synthetic filesystems
-
-Hardware:
-  Architectures
-    echo include/asm-* | sed 's@include/asm-@@g'
-    generic, uml
-    x86, x86-64 powerpc/ppc arm mips sparc sh 68k/coldfire
-  DMA, IRQ, MMU (mmap), IOMMU, port I/O
-  Busses.
-    PCI, USB
-
-A working Linux root filesystem.
-  Bootloader, kernel
-  finding root
-    initramfs, switch_root vs pivot_root, /dev/console
-  init program and PID 1
-    What does daemonizing mean?
-  C library, Dynamic loader
-  FHS directories
-    <a href=pending/hotplug-sysfs.txt>populating /dev from sysfs</a>.
-
-Submitting Patches
-
-Following Linux development
-  Distros do it for you.
-  CATB
-  http://vger.kernel.org/vger-lists.html
-  http://www.tux.org/lkml/
-  lwn, kernel traffic, kernelplanet.
-  http://www.kernel.org/faq
-    http://www.kernel.org/kdist/rss.xml
-  git/mercurial
-  Documentation/{CodingStyle,SubmitChecklist}
-  The four layer (developer, maintainer, subsystem, linus) model.
-
-  Politics
-    Stable API nonsense
-    Why reiser4 not in.
-
-Glossary
-</pre>
-
-<p>This page maintained by Rob Landley <rob@landley.net>.</p>
+<p>This page maintained by Rob Landley &lt;rob@landley.net&gt;.</p>