[SCM] Debian Live manual branch, master, updated. d54392473ae2f6b94baf9ab133df1f43a97b4e0c
Chris Lamb
chris at chris-lamb.co.uk
Sun May 11 21:14:43 UTC 2008
The following commit has been merged in the master branch:
commit d54392473ae2f6b94baf9ab133df1f43a97b4e0c
Author: Chris Lamb <chris at chris-lamb.co.uk>
Date: Sun May 11 22:13:50 2008 +0100
Migrate to DocBook XML
Signed-off-by: Chris Lamb <chris at chris-lamb.co.uk>
diff --git a/.gitignore b/.gitignore
index 1fcb152..4e07c37 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,5 @@
-out
+*.html
+*.pdf
+*.txt
+ent/version.ent
+autobuild/
diff --git a/Makefile b/Makefile
index 7277094..dbf4f73 100644
--- a/Makefile
+++ b/Makefile
@@ -1,29 +1,46 @@
-name := debian-live-manual
-version := 0.1
-date := $(shell date)
-out := out/
+PROJECT := live-manual
+FORMATS := html txt pdf
-all: autobuild
+AUTOBUILD := autobuild
+VERSION :=
+PUBDATE :=
-autobuild: distclean build-html build-text build-pdf build-ps clean
- mv $(out)/$(name).html/ $(out)/html
- sed -e 's/NAME/$(name)/g' -e 's/UPDATED/$(date)/' index.html.in > $(out)/index.html
+TARGETS := $(foreach fmt,$(FORMATS),$(PROJECT).$(fmt))
+SOURCES := $(wildcard *.xml) ent/version.ent ent/common.ent
-clean:
- rm -f $(out)/version.ent
- rm -f $(out)/head.tmp
- rm -f $(out)/body.tmp
- rm -f $(out)/$(name).tpt
+XP := xsltproc --nonet --novalid --xinclude
+XL := xmllint --nonet --noout --postvalid --xinclude
+DBLATEX := dblatex --style=db2latex
+
+all: $(TARGETS)
+
+validate: $(SOURCES)
+ $(XL) index.xml
+
+autobuild: clean all
+ set -e; for FORMAT in $(FORMATS); do \
+ mkdir -p $(AUTOBUILD)/$$FORMAT; \
+ cp *.$$FORMAT $(AUTOBUILD)/$$FORMAT; \
+ done
+ sed 's/UPDATED/$(shell LC_ALL=C date)/' index.html.in > $(AUTOBUILD)/index.html
-distclean:
- rm -rf $(out)
+index.html: $(SOURCES)
+ $(XP) xsl/html.xsl index.xml
-out/version.ent:
- mkdir -p $(out)
- echo "<!entity version \"$(version)\">" >> $@
- echo "<!entity date \"$(date)\">" >> $@
+$(PROJECT).html: index.html
-build-%: out/version.ent
- cd $(out) && debiandoc2$* ../$(name).sgml
+$(PROJECT).txt: $(SOURCES)
+ $(XP) xsl/txt.xsl index.xml | w3m -cols 65 -dump -T text/html > $@
+
+$(PROJECT).pdf: $(SOURCES)
+ $(DBLATEX) index.xml -o $@
+
+ent/version.ent:
+ echo '<!ENTITY version "$(VERSION)">' > $@
+ echo '<!ENTITY pubdate "$(PUBDATE)">' >> $@
+
+clean:
+ rm -f *.html *.pdf *.txt
+ rm -f ent/version.ent
-.PHONY: all clean distclean autobuild
+.PHONY: all clean validate $(PROJECT).html
diff --git a/about.html b/about.html
new file mode 100644
index 0000000..d8e0fd6
--- /dev/null
+++ b/about.html
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 2. About the Debian Live Project</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="Debian Live Manual" /><link rel="up" href="index.html" title="Debian Live Manual" /><link rel="prev" href="meta.html" title="Chapter 1. About this manual" /><link rel="next" href="installation.html" title="Chapter 3. Installation" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 2. About the Debian Live Project</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="meta.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="installation.html">Next</a></td></tr></table><hr /></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="about"></a>Chapter 2. About the Debian Live Project</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="about.html#motivation">2.1. Motivation</a></span></dt><dt><span class="section"><a href="about.html#philosophy">2.2. Philosophy</a></span></dt><dt><span class="section"><a href="about.html#contact">2.3. Contact</a></span></dt></dl></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="motivation"></a>2.1. Motivation</h2></div></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id336091"></a>1. What is wrong with current live systems</h2></div></div></div><p>There are already several Debian-based live systems and they are doing a great job. But, from the Debian perspective, most of them have one or more of the following disadvantages:</p><div class="orderedlist"><ol type="1"><li><p>They are unofficial projects, developed outside of Debian.</p></li><li><p>They mix different distributions, e.g. testing and unstable.</p></li><li><p>They support i386 only.</p></li><li><p>They change package's behavior and/or appearance by stripping them down to save space.</p></li><li><p>They include unofficial packages.</p></li><li><p>They ship custom kernels with additional patches not part of Debian.</p></li><li><p>They are large and slow due to their sheer size and thus not suitable for rescue issues.</p></li><li><p>They are not available in different flavours, e.g. CDs, DVDs, USB-stick and netboot images </p></li></ol></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id333877"></a>2. Why create our own live system?</h2></div></div></div><p>Debian is the Universal Operating System: Debian should have an official live system for showing around and to officially represent the true, one and only Debian system with the following main advantages:</p><div class="orderedlist"><ol type="1"><li><p>It would be an official Debian subproject.</p></li><li><p>It reflects the (current) state of one distribution.</p></li><li><p>It runs on as many architectures as possible.</p></li><li><p>It consists of unchanged Debian packages only.</p></li><li><p>It does not contain any unofficial packages.</p></li><li><p>It uses an unaltered Debian kernel-image with no additional patches.</p></li></ol></div></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="philosophy"></a>2.2. Philosophy</h2></div></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id358762"></a>1. Only unchanged, official packages</h2></div></div></div><p>We will only use official packages from the Debian repository, section main or maybe contrib (the use of contrib is not decided yet). The non-free section is not part of Debian and therefore not used at all for the live system.</p><p>We will not change any packages. Whenever we need to change something, we will do that in coordination with its package maintainer in Debian.</p><p>Exception: temporarly, our own packages like live-helper or live-initramfs may be used from our own repository for development reasons (e.g. to create development snapshots). They will be synced into Debian on a regular basis.</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id349223"></a>2. No configuration of the live system</h2></div></div></div><p>In this phase we will not ship or install sample or alternative configurations. All packages are used in their default configuration as they are after a regular installation of Debian.</p><p>Whenever we need a different default configuration, we will do that in coordination with its package maintainer in Debian.</p><p>A system for configuring packages is provided using debconf in lh_config (use --preseed FILE) allowing custom configured packages to be installed in your custom produced Debian Live images, but for official live images only default configuration will be used.</p><p>Exception: There are a few essential changes needed to be make a live system alive (e.g. configuring pam to allow empty passwords). These essential changes have to be kept as minimal as possible and, should be merged within the Debian repository if possible.</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id349252"></a>3. No live system to hardisk installer</h2></div></div></div><p>[ this is no longer valid after etch release, we will work on an installer for lenny ]</p><p>For the moment we will not ship a installer to copy the live system to a partition on the hardisk. Although we keep the changes in the live system as drastically minimal as possible compared to a regular Debian installation, the live system does differ in a few essential points (see exceptions, guideline 2).</p><p>Therefore, we will ship a copy of the regular DebianInstaller (resp. Debian Installer, Graphical Installer) instead, to allow users to perform a regular Debian installation (and, of course, cdebootstrap and debootstrap are on the system too).</p></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="contact"></a>2.3. Contact</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">Mailing list</span></dt><dd><p>The primary contact for the project is the <a class="ulink" href="http://lists.alioth.debian.org/mailman/listinfo/debian-live-devel" target="_top">mailing list</a>. You can email the list directly by addressing your mail to <code class="email"><<a class="email" href="mailto:debian-live-devel at lists.alioth.debian.org">debian-live-devel at lists.alioth.debian.org</a>></code>. The <a class="ulink" href="http://lists.alioth.debian.org/pipermail/debian-live-devel/" target="_top">list archives</a> are also available.</p></dd><dt><span class="term">IRC</span></dt><dd><p>
+A number of users and developers are present in the <a class="ulink" href="irc://irc.debian.org/#debian-live" target="_top">#debian-live</a> channel on <a class="ulink" href="http://oftc.net" target="_top">OFTC</a>. When asking a question on IRC, please be patient for an answer. If no answer is forthcoming, please email the mailing list.
+</p></dd><dt><span class="term">BTS</span></dt><dd><p>
+The Debian Bug Tracking System (BTS) contains details of bugs reported by ysers and developers. Each bug is given a number, and is kept on file until it is marked as having been dealt with. For more information, please see <a class="xref" href="bugs.html" title="Chapter 13. Reporting bugs">Chapter 13, <i>Reporting bugs</i></a>.
+</p></dd><dt><span class="term">Wiki</span></dt><dd><p>
+FIXME. <a class="ulink" href="http://wiki.debian.org/DebianLive" target="_top">our entry on the Debian wiki</a>.
+</p></dd></dl></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="meta.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="installation.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 1. About this manual </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3. Installation</td></tr></table></div></body></html>
diff --git a/appendices/configuration-files.sgml b/appendices/configuration-files.sgml
deleted file mode 100644
index 4e1ca4e..0000000
--- a/appendices/configuration-files.sgml
+++ /dev/null
@@ -1,321 +0,0 @@
-<appendix id="configuration-files">
-<heading>Configuration files</heading>
-
-<sect id="config-binary">
-<heading>The <tt>config/binary</tt> file</heading>
-
-<p><taglist>
-<tag>LH_BINARY_FILESYSTEM</tag>
-<item>Set image filesystem. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_BINARY_IMAGES</tag>
-<item>Set image type. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_BINARY_INDICES</tag>
-<item>Set apt/aptitude generic indices. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_BOOTAPPEND_LIVE</tag>
-<item>Set boot parameters. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_BOOTAPPEND_INSTALL</tag>
-<item>Set boot parameters. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_BOOTLOADER</tag>
-<item>Set bootloader. (See <ref id="bootloaders">)</item>
-
-<tag>LH_CHECKSUMS</tag>
-<item>set checksums. (See <ref id="cheat-codes">)</item>
-
-<tag>LH_CHROOT_BUILD</tag>
-<item>Control if we build binary images chrooted. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_DEBIAN_INSTALLER</tag>
-<item>set debian-installer. (See <ref id="debian-installer">)</item>
-
-<tag>LH_DEBIAN_INSTALLER_DAILY</tag>
-<item>set daily images. (See <ref id="debian-installer">)</item>
-
-<tag>LH_ENCRYPTION</tag>
-<item>set encrytion. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_GRUB_SPLASH</tag>
-<item>set custom grub splash. (See <ref id="splash">)</item>
-
-<tag>LH_HOSTNAME</tag>
-<item>set hostname. (See <ref id="hostname">)</item>
-
-<tag>LH_ISO_APPLICATION</tag>
-<item>set iso author. (See <ref id="iso-metadata">)</item>
-
-<tag>LH_ISO_PREPARER</tag>
-<item>set iso preparer. (See <ref id="iso-metadata">)</item>
-
-<tag>LH_ISO_PUBLISHER</tag>
-<item>set iso publisher. (See <ref id="iso-metadata">)</item>
-
-<tag>LH_ISO_VOLUME</tag>
-<item>set iso volume (max 32 chars). (See <ref id="iso-metadata">)</item>
-
-<tag>LH_JFFS2_ERASEBLOCK</tag>
-<item>set jffs2 eraseblock size. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_MEMTEST</tag>
-<item>set memtest. (See <ref id="memtest">)</item>
-
-<tag>LH_NET_ROOT_FILESYSTEM</tag>
-<item>set netboot filesystem. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_NET_ROOT_MOUNTOPTIONS</tag>
-<item>set nfsopts. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_NET_ROOT_PATH</tag>
-<item>set netboot server directory. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_NET_ROOT_SERVER</tag>
-<item>set netboot server address. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_NET_COW_FILESYSTEM</tag>
-<item>set net client cow filesystem. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_NET_COW_MOUNTOPTIONS</tag>
-<item>set cow mount options. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_NET_COW_PATH</tag>
-<item>set cow directory. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_NET_COW_SERVER</tag>
-<item>set cow server. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_NET_TARBALL</tag>
-<item>set net tarball. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_SYSLINUX_SPLASH</tag>
-<item>set custom syslinux splash. (See <ref id="splash">)</item>
-
-<tag>LH_SYSLINUX_TIMEOUT</tag>
-<item>set custom syslinux timeout in seconds. (See <ref id="syslinux">)</item>
-
-<tag>LH_SYSLINUX_CFG</tag>
-<item>set custom syslinux configuration file. (See <ref id="syslinux">)</item>
-
-<tag>LH_SYSLINUX_MENU</tag>
-<item>set syslinux menu. (See <ref id="syslinux">)</item>
-
-<tag>LH_SYSLINUX_MENU_LIVE_ENTRY</tag>
-<item>set text to be used on the menu for live entries. (See <ref id="syslinux">)</item>
-
-<tag>LH_SYSLINUX_MENU_LIVE_FAILSAFE_ENTRY</tag>
-<item>set text to be used on the menu for live entries (failsafe ones). (See <ref id="syslinux">)</item>
-
-<tag>LH_SYSLINUX_MENU_MEMTEST_ENTRY</tag>
-<item>set text to be used on the menu for memtest entry. (See <ref id="syslinux"> and <ref id="memtest">)</item>
-
-<tag>LH_USERNAME</tag>
-<item>set username. (See <ref id="username">)</item>
-
-</taglist></p>
-</sect>
-
-<sect id="config-bootstrap">
-<heading>The <tt>config/bootstrap</tt> file</heading>
-
-<p><taglist>
-<tag>LH_ARCHITECTURE</tag>
-<item>Select chroot architecture. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_BOOTSTRAP_CONFIG</tag>
-<item>Set distribution config directory. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_BOOTSTRAP_INCLUDE</tag>
-<item>Include packages on base. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_BOOTSTRAP_EXCLUDE</tag>
-<item>Exclude packages on base. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_BOOTSTRAP_FLAVOUR</tag>
-<item>Select flavour to use. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_BOOTSTRAP_KEYRING</tag>
-<item>Set distribution keyring. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_DISTRIBUTION</tag>
-<item>Select distribution to use. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_MIRROR_BOOTSTRAP</tag>
-<item>Set mirror to bootstrap from. (See <ref id="package-sources">)</item>
-
-<tag>LH_MIRROR_CHROOT</tag>
-<item>Set mirror to fetch packages from. (See <ref id="package-sources">)</item>
-
-<tag>LH_MIRROR_CHROOT_SECURITY</tag>
-<item>Set security mirror to fetch packages from. (See <ref id="package-sources">)</item>
-
-<tag>LH_MIRROR_BINARY</tag>
-<item>Set mirror which ends up in the image. (See <ref id="package-sources">)</item>
-
-<tag>LH_MIRROR_BINARY_SECURITY</tag>
-<item>Set security mirror which ends up in the image. (See <ref id="package-sources">)</item>
-
-<tag>LH_SECTIONS</tag>
-<item>select section(s) to use. (See <ref id="package-sources">)</item>
-</taglist></p>
-</sect>
-
-<sect id="config-chroot">
-<heading>The <tt>config/chroot</tt> file</heading>
-
-<p><taglist>
-<tag>LH_CHROOT_FILESYSTEM</tag>
-<item>set chroot filesystem. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_UNION_FILESYSTEM</tag>
-<item>set union filesystem. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_EXPOSED_ROOT</tag>
-<item>expose root as read only. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_HOOKS</tag>
-<item>set hook commands. (See <ref id="hooks">)</item>
-
-<tag>LH_INTERACTIVE</tag>
-<item>set interactive build. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_KEYRING_PACKAGES</tag>
-<item>set keyring packages. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_LANGUAGE</tag>
-<item>set language to use. (See <ref id="language">)</item>
-
-<tag>LH_LINUX_FLAVOURS</tag>
-<item>set kernel flavour to use. (See <ref id="kernel">)</item>
-
-<tag>LH_LINUX_PACKAGES</tag>
-<item>set kernel packages to use. (See <ref id="kernel">)</item>
-
-<tag>LH_PACKAGES</tag>
-<item>set packages to install. (See <ref id="lh-packages">)</item>
-
-<tag>LH_PACKAGES_LISTS</tag>
-<item>set package list to install. (See <ref id="package-lists">)</item>
-
-<tag>LH_TASKS</tag>
-<item>set tasks to install. (See <ref id="tasks">)</item>
-
-<tag>LH_SECURITY</tag>
-<item>enable security updates. (See <ref id="package-sources">)</item>
-
-<tag>LH_SYMLINKS</tag>
-<item>enable symlink convertion. (See <ref id="symlinks">)</item>
-
-<tag>LH_SYSVINIT</tag>
-<item>enable sysvinit. (See <ref id="startup-scripts">)</item>
-
-</taglist></p>
-</sect>
-
-<sect id="config-common">
-<heading>The <tt>config/common</tt> file</heading>
-
-<p><taglist>
-<tag>LH_APT</tag>
-<item>Set package manager. (See <ref id="package-installation">)</item>
-
-<tag>LH_APT_FTP_PROXY</tag>
-<item>Set apt/aptitude ftp proxy. (See <ref id="package-installation">)</item>
-
-<tag>LH_APT_HTTP_PROXY</tag>
-<item>set apt/aptitude http proxy. (See <ref id="package-installation">)</item>
-
-<tag>LH_APT_PDIFFS</tag>
-<item>set apt/aptitude pdiff indices. (See <ref id="package-installation">)</item>
-
-<tag>LH_APT_PIPELINE</tag>
-<item>set apt/aptitude pipeline depth. (See <ref id="package-installation">)</item>
-
-<tag>LH_APT_RECOMMENDS</tag>
-<item>set apt/aptitude recommends. (See <ref id="package-installation">)</item>
-
-<tag>LH_APT_SECURE</tag>
-<item>set apt/aptitude security. (See <ref id="package-installation">)</item>
-
-<tag>LH_BOOTSTRAP</tag>
-<item>set bootstrap program. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_CACHE</tag>
-<item>control cache. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_CACHE_INDICES</tag>
-<item>control if downloaded package indices should be cached. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_CACHE_PACKAGES</tag>
-<item>control if downloaded packages files should be cached. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_CACHE_STAGES</tag>
-<item>control if completed stages should be cached. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_DEBCONF_FRONTEND</tag>
-<item>set debconf(1) frontend to use. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_DEBCONF_NOWARNINGS</tag>
-<item>set debconf(1) warnings. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_DEBCONF_PRIORITY</tag>
-<item>set debconf(1) priority to use. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_INITRAMFS</tag>
-<item>set initramfs hook. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_FDISK</tag>
-<item>set fdisk program. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_LOSETUP</tag>
-<item>set losetup program. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_MODE</tag>
-<item>set distribution mode. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_ROOT_COMMAND</tag>
-<item>use sudo or equivalent. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_USE_FAKEROOT</tag>
-<item>use fakeroot/fakechroot. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_TASKSEL</tag>
-<item>set tasksel program. (See <ref id="tasks">)</item>
-
-<tag>LH_INCLUDES</tag>
-<item>set includes. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_TEMPLATES</tag>
-<item>set templates. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_BREAKPOINTS</tag>
-<item>enable breakpoints. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_DEBUG</tag>
-<item>enable debug. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_FORCE</tag>
-<item>enable force. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_QUIET</tag>
-<item>enable quiet. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_VERBOSE</tag>
-<item>enable verbose. (See <ref id="configuration-layout">)</item>
-</taglist></p>
-</sect>
-
-<sect id="config-source">
-<heading>The <tt>config/source</tt> file</heading>
-
-<p><taglist>
-<tag>LH_SOURCE</tag>
-<item>set source option. (See <ref id="configuration-layout">)</item>
-
-<tag>LH_SOURCE_IMAGES</tag>
-<item>set image type. (See <ref id="configuration-layout">)</item>
-</taglist></p>
-</sect>
-
-</appendix>
diff --git a/appendices/configuration-files.xml b/appendices/configuration-files.xml
new file mode 100644
index 0000000..db7221d
--- /dev/null
+++ b/appendices/configuration-files.xml
@@ -0,0 +1,518 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+
+<appendix id="configuration-files">
+<title>Configuration files</title>
+
+<section id="config-binary">
+<title>The <filename>config/binary</filename> file</title>
+
+<variablelist>
+<varlistentry>
+ <term>LH_BINARY_FILESYSTEM</term>
+ <listitem><para>Set image filesystem. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BINARY_IMAGES</term>
+ <listitem><para>Set image type. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BINARY_INDICES</term>
+ <listitem><para>Set apt/aptitude generic indices. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BOOTAPPEND_LIVE</term>
+ <listitem><para>Set boot parameters. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BOOTAPPEND_INSTALL</term>
+ <listitem><para>Set boot parameters. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BOOTLOADER</term>
+ <listitem><para>Set bootloader. (See <xref linkend="bootloaders"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_CHECKSUMS</term>
+ <listitem><para>Set checksums. (See <xref linkend="cheat-codes"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_CHROOT_BUILD</term>
+ <listitem><para>Control if we build binary images chrooted. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_DEBIAN_INSTALLER</term>
+ <listitem><para>Set debian-installer. (See <xref linkend="debian-installer"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_DEBIAN_INSTALLER_DAILY</term>
+ <listitem><para>Set daily images. (See <xref linkend="debian-installer"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_ENCRYPTION</term>
+ <listitem><para>Set encrytion. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_GRUB_SPLASH</term>
+ <listitem><para>Set custom grub splash. (See <xref linkend="splash"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_HOSTNAME</term>
+ <listitem><para>Set hostname. (See <xref linkend="hostname"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_ISO_APPLICATION</term>
+ <listitem><para>Set iso author. (See <xref linkend="iso-metadata"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_ISO_PREPARER</term>
+ <listitem><para>Set iso preparer. (See <xref linkend="iso-metadata"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_ISO_PUBLISHER</term>
+ <listitem><para>Set iso publisher. (See <xref linkend="iso-metadata"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_ISO_VOLUME</term>
+ <listitem><para>Set iso volume (max 32 chars). (See <xref linkend="iso-metadata"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_JFFS2_ERASEBLOCK</term>
+ <listitem><para>Set jffs2 eraseblock size. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_MEMTEST</term>
+ <listitem><para>Set memtest. (See <xref linkend="memtest"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_NET_ROOT_FILESYSTEM</term>
+ <listitem><para>Set netboot filesystem. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_NET_ROOT_MOUNTOPTIONS</term>
+ <listitem><para>Set nfsopts. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_NET_ROOT_PATH</term>
+ <listitem><para>Set netboot server directory. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_NET_ROOT_SERVER</term>
+ <listitem><para>Set netboot server address. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_NET_COW_FILESYSTEM</term>
+ <listitem><para>Set net client cow filesystem. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_NET_COW_MOUNTOPTIONS</term>
+ <listitem><para>Set cow mount options. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_NET_COW_PATH</term>
+ <listitem><para>Set cow directory. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_NET_COW_SERVER</term>
+ <listitem><para>Set cow server. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_NET_TARBALL</term>
+ <listitem><para>Set net tarball. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SYSLINUX_SPLASH</term>
+ <listitem><para>Set custom syslinux splash. (See <xref linkend="splash"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SYSLINUX_TIMEOUT</term>
+ <listitem><para>Set custom syslinux timeout in seconds. (See <xref linkend="syslinux"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SYSLINUX_CFG</term>
+ <listitem><para>Set custom syslinux configuration file. (See <xref linkend="syslinux"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SYSLINUX_MENU</term>
+ <listitem><para>Set syslinux menu. (See <xref linkend="syslinux"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SYSLINUX_MENU_LIVE_ENTRY</term>
+ <listitem><para>Set text to be used on the menu for live entries. (See <xref linkend="syslinux"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SYSLINUX_MENU_LIVE_FAILSAFE_ENTRY</term>
+ <listitem><para>Set text to be used on the menu for live entries (failsafe ones). (See <xref linkend="syslinux"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SYSLINUX_MENU_MEMTEST_ENTRY</term>
+ <listitem><para>Set text to be used on the menu for memtest entry. (See <xref linkend="syslinux"/> and <xref linkend="memtest"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_USERNAME</term>
+ <listitem><para>Set username. (See <xref linkend="username"/>)</para></listitem>
+</varlistentry>
+
+</variablelist>
+</section>
+
+<section id="config-bootstrap">
+<title>The <filename>config/bootstrap</filename> file</title>
+
+<variablelist>
+<varlistentry>
+ <term>LH_ARCHITECTURE</term>
+ <listitem><para>Select chroot architecture. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BOOTSTRAP_CONFIG</term>
+ <listitem><para>Set distribution config directory. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BOOTSTRAP_INCLUDE</term>
+ <listitem><para>Include packages on base. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BOOTSTRAP_EXCLUDE</term>
+ <listitem><para>Exclude packages on base. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BOOTSTRAP_FLAVOUR</term>
+ <listitem><para>Select flavour to use. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BOOTSTRAP_KEYRING</term>
+ <listitem><para>Set distribution keyring. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_DISTRIBUTION</term>
+ <listitem><para>Select distribution to use. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_MIRROR_BOOTSTRAP</term>
+ <listitem><para>Set mirror to bootstrap from. (See <xref linkend="package-sources"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_MIRROR_CHROOT</term>
+ <listitem><para>Set mirror to fetch packages from. (See <xref linkend="package-sources"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_MIRROR_CHROOT_SECURITY</term>
+ <listitem><para>Set security mirror to fetch packages from. (See <xref linkend="package-sources"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_MIRROR_BINARY</term>
+ <listitem><para>Set mirror which ends up in the image. (See <xref linkend="package-sources"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_MIRROR_BINARY_SECURITY</term>
+ <listitem><para>Set security mirror which ends up in the image. (See <xref linkend="package-sources"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SECTIONS</term>
+ <listitem><para>select section(s) to use. (See <xref linkend="package-sources"/>)</para></listitem>
+</varlistentry>
+</variablelist>
+</section>
+
+<section id="config-chroot">
+<title>The <filename>config/chroot</filename> file</title>
+
+<variablelist>
+<varlistentry>
+ <term>LH_CHROOT_FILESYSTEM</term>
+ <listitem><para>Set chroot filesystem. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_UNION_FILESYSTEM</term>
+ <listitem><para>Set union filesystem. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_EXPOSED_ROOT</term>
+ <listitem><para>expose root as read only. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_HOOKS</term>
+ <listitem><para>Set hook commands. (See <xref linkend="hooks"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_INTERACTIVE</term>
+ <listitem><para>Set interactive build. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_KEYRING_PACKAGES</term>
+ <listitem><para>Set keyring packages. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_LANGUAGE</term>
+ <listitem><para>Set language to use. (See <xref linkend="language"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_LINUX_FLAVOURS</term>
+ <listitem><para>Set kernel flavour to use. (See <xref linkend="kernel"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_LINUX_PACKAGES</term>
+ <listitem><para>Set kernel packages to use. (See <xref linkend="kernel"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_PACKAGES</term>
+ <listitem><para>Set packages to install. (See <xref linkend="lh-packages"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_PACKAGES_LISTS</term>
+ <listitem><para>Set package list to install. (See <xref linkend="package-lists"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_TASKS</term>
+ <listitem><para>Set tasks to install. (See <xref linkend="tasks"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SECURITY</term>
+ <listitem><para>enable security updates. (See <xref linkend="package-sources"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SYMLINKS</term>
+ <listitem><para>enable symlink convertion. (See <xref linkend="symlinks"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SYSVINIT</term>
+ <listitem><para>enable sysvinit. (See <xref linkend="startup-scripts"/>)</para></listitem>
+</varlistentry>
+
+</variablelist>
+</section>
+
+<section id="config-common">
+<title>The <filename>config/common</filename> file</title>
+
+<variablelist>
+<varlistentry>
+ <term>LH_APT</term>
+ <listitem><para>Set package manager. (See <xref linkend="package-installation"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_APT_FTP_PROXY</term>
+ <listitem><para>Set apt/aptitude ftp proxy. (See <xref linkend="package-installation"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_APT_HTTP_PROXY</term>
+ <listitem><para>Set apt/aptitude http proxy. (See <xref linkend="package-installation"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_APT_PDIFFS</term>
+ <listitem><para>Set apt/aptitude pdiff indices. (See <xref linkend="package-installation"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_APT_PIPELINE</term>
+ <listitem><para>Set apt/aptitude pipeline depth. (See <xref linkend="package-installation"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_APT_RECOMMENDS</term>
+ <listitem><para>Set apt/aptitude recommends. (See <xref linkend="package-installation"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_APT_SECURE</term>
+ <listitem><para>Set apt/aptitude security. (See <xref linkend="package-installation"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BOOTSTRAP</term>
+ <listitem><para>Set bootstrap program. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_CACHE</term>
+ <listitem><para>control cache. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_CACHE_INDICES</term>
+ <listitem><para>control if downloaded package indices should be cached. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_CACHE_PACKAGES</term>
+ <listitem><para>control if downloaded packages files should be cached. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_CACHE_STAGES</term>
+ <listitem><para>control if completed stages should be cached. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_DEBCONF_FRONTEND</term>
+ <listitem><para>Set debconf(1) frontend to use. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_DEBCONF_NOWARNINGS</term>
+ <listitem><para>Set debconf(1) warnings. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_DEBCONF_PRIORITY</term>
+ <listitem><para>Set debconf(1) priority to use. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_INITRAMFS</term>
+ <listitem><para>Set initramfs hook. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_FDISK</term>
+ <listitem><para>Set fdisk program. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_LOSETUP</term>
+ <listitem><para>Set losetup program. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_MODE</term>
+ <listitem><para>Set distribution mode. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_ROOT_COMMAND</term>
+ <listitem><para>use sudo or equivalent. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_USE_FAKEROOT</term>
+ <listitem><para>use fakeroot/fakechroot. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_TASKSEL</term>
+ <listitem><para>Set tasksel program. (See <xref linkend="tasks"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_INCLUDES</term>
+ <listitem><para>Set includes. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_TEMPLATES</term>
+ <listitem><para>Set templates. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_BREAKPOINTS</term>
+ <listitem><para>enable breakpoints. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_DEBUG</term>
+ <listitem><para>enable debug. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_FORCE</term>
+ <listitem><para>enable force. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_QUIET</term>
+ <listitem><para>enable quiet. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_VERBOSE</term>
+ <listitem><para>enable verbose. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+</variablelist>
+</section>
+
+<section id="config-source">
+<title>The <filename>config/source</filename> file</title>
+
+<variablelist>
+<varlistentry>
+ <term>LH_SOURCE</term>
+ <listitem><para>Set source option. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term>LH_SOURCE_IMAGES</term>
+ <listitem><para>Set image type. (See <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+
+</variablelist>
+</section>
+
+</appendix>
diff --git a/appendices/configuration-layout.sgml b/appendices/configuration-layout.sgml
deleted file mode 100644
index 671b057..0000000
--- a/appendices/configuration-layout.sgml
+++ /dev/null
@@ -1,29 +0,0 @@
-<appendix id="configuration-layout">
-<heading>Configuration layout</heading>
-
-<p><tt> -- config/</tt></p>
-<p><tt>|-- binary_debian-installer/</tt> (see <ref id="debian-installer">)</p>
-<p><tt>|-- binary_grub/</tt> (see <ref id="bootloaders">)</p>
-<p><tt>|-- binary_local-debs/</tt> (see <ref id="debian-installer">)</p>
-<p><tt>|-- binary_local-hooks/</tt> (see <ref id="binary-local-hooks">)</p>
-<p><tt>|-- binary_local-includes/</tt> (see <ref id="binary-includes">)</p>
-<p><tt>|-- binary_local-packageslists/</tt> (see <ref id="configuration-layout">)</p>
-<p><tt>|-- binary_local-udebs/</tt> (see <ref id="debian-installer">)</p>
-<p><tt>|-- binary_rootfs/</tt> (see <ref id="configuration-layout">)</p>
-<p><tt>|-- binary_syslinux/</tt> (see <ref id="bootloaders">)</p>
-<p><tt>|-- chroot_apt/</tt> (see <ref id="custom-packages-apt">)</p>
-<p><tt>|-- chroot_local-hooks/</tt> (see <ref id="chroot-local-hooks">)</p>
-<p><tt>|-- chroot_local-includes/</tt> (see <ref id="chroot-includes">)</p>
-<p><tt>|-- chroot_local-packages/</tt> (see <ref id="local-packages">)</p>
-<p><tt>|-- chroot_local-packageslists/</tt> (see <ref id="package-lists">)</p>
-<p><tt>|-- chroot_sources/</tt> (see <ref id="custom-apt-repo">)</p>
-<p><tt>|-- includes/</tt> (see <ref id="bootloaders">)</p>
-<p><tt>|-- templates/</tt> (see <ref id="bootloaders">)</p>
-<p> </p>
-<p><tt>|-- bootstrap</tt> (see <ref id="config-bootstrap">)</p>
-<p><tt>|-- binary</tt> (see <ref id="config-binary">)</p>
-<p><tt>|-- chroot</tt> (see <ref id="config-chroot">)</p>
-<p><tt>|-- common</tt> (see <ref id="config-common">)</p>
-<p><tt>`-- source</tt> (see <ref id="config-source">)</p>
-
-</appendix>
diff --git a/appendices/configuration-layout.xml b/appendices/configuration-layout.xml
new file mode 100644
index 0000000..aefc3a9
--- /dev/null
+++ b/appendices/configuration-layout.xml
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+
+<appendix id="configuration-layout">
+<title>Configuration layout</title>
+
+<variablelist>
+<title>Layout of the <filename class="directory">config/</filename> directory</title>
+
+<varlistentry>
+ <term><filename class="directory">binary_debian-installer/</filename></term>
+ <listitem><para>(see <xref linkend="debian-installer"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">binary_grub/</filename></term>
+ <listitem><para>(see <xref linkend="bootloaders"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">binary_local-debs/</filename></term>
+ <listitem><para>(see <xref linkend="debian-installer"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">binary_local-hooks/</filename></term>
+ <listitem><para>(see <xref linkend="binary-local-hooks"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">binary_local-includes/</filename></term>
+ <listitem><para>(see <xref linkend="binary-includes"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">binary_local-packageslists/</filename></term>
+ <listitem><para>(see <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">binary_local-udebs/</filename></term>
+ <listitem><para>(see <xref linkend="debian-installer"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">binary_rootfs/</filename></term>
+ <listitem><para>(see <xref linkend="configuration-layout"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">binary_syslinux/</filename></term>
+ <listitem><para>(see <xref linkend="bootloaders"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">chroot_apt/</filename></term>
+ <listitem><para>(see <xref linkend="custom-packages-apt"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">chroot_local-hooks/</filename></term>
+ <listitem><para>(see <xref linkend="chroot-local-hooks"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">chroot_local-includes/</filename></term>
+ <listitem><para>(see <xref linkend="chroot-includes"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">chroot_local-packages/</filename></term>
+ <listitem><para>(see <xref linkend="local-packages"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">chroot_local-packageslists/</filename></term>
+ <listitem><para>(see <xref linkend="package-lists"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">chroot_sources/</filename></term>
+ <listitem><para>(see <xref linkend="custom-apt-repo"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">includes/</filename></term>
+ <listitem><para>(see <xref linkend="bootloaders"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename class="directory">templates/</filename></term>
+ <listitem><para>(see <xref linkend="bootloaders"/>)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+ <term><filename>bootstrap</filename></term>
+ <listitem><para>(see <xref linkend="config-bootstrap"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename>binary</filename></term>
+ <listitem><para>(see <xref linkend="config-binary"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename>chroot</filename></term>
+ <listitem><para>(see <xref linkend="config-chroot"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename>common</filename></term>
+ <listitem><para>(see <xref linkend="config-common"/>)</para></listitem>
+</varlistentry>
+<varlistentry>
+ <term><filename>source</filename></term>
+ <listitem><para>(see <xref linkend="config-source"/>)</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</appendix>
diff --git a/basics.html b/basics.html
new file mode 100644
index 0000000..556d0d4
--- /dev/null
+++ b/basics.html
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 4. The basics</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="Debian Live Manual" /><link rel="up" href="index.html" title="Debian Live Manual" /><link rel="prev" href="installation.html" title="Chapter 3. Installation" /><link rel="next" href="overview.html" title="Chapter 5. Overview of tools" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 4. The basics</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="installation.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="overview.html">Next</a></td></tr></table><hr /></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="basics"></a>Chapter 4. The basics</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="basics.html#id355428">4.1. First steps: building an ISO image</a></span></dt><dt><span class="section"><a href="basics.html#id324638">4.2. Building an USB/HDD image</a></span></dt><dt><span class="section"><a href="basics.html#id325190">4.3. Building an netboot image</a></span></dt></dl></div><p>This chapter contains a brief overview of the build process as well as containing instructions on how to boot the various binary image types.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id355428"></a>4.1. First steps: building an ISO image</h2></div></div></div><p>The following sequence of commands will create a basic ISO image containing just the Debian standard system without X.org. It is suitable for burning to CD or DVD media.</p><p>First, we must configure our Live system:</p><pre class="screen">
+$ lh_config
+</pre><p>Passing no parameters indicated that we wish to use the default binary image type. You will see that <code class="filename">live-helper</code> created a <code class="filename">"config/"</code> hierarchy in your current directory - this is used by the rest of <code class="filename">live-helper</code> to build your live image.</p><p>We can then build the image with <code class="filename">lh_build</code> as root:</p><pre class="screen">
+# lh_build
+</pre><p>This process can take a while, depending on the speed of your network connection.</p><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id355532"></a>1. Testing an ISO image with Qemu</h2></div></div></div><p>Testing an ISO is simple:</p><pre class="screen">
+# apt-get install qemu
+$ qemu -cdrom binary.iso
+</pre></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id319324"></a>2. Burning an ISO image to physical medium</h2></div></div></div><p>Burning an ISO image is easy:</p><pre class="screen">
+# apt-get install wodim
+$ wodim binary.iso
+</pre></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id324638"></a>4.2. Building an USB/HDD image</h2></div></div></div><p>The following sequence of commands will create a basic USB/HDD image containing just the Debian standard system without X.org. It is suitable for booting from USB sticks, hard drives and various other portable storage devices.</p><p>Note if an iso image had been previously built, you will need to clean live-helper:</p><pre class="screen">
+$ lh_clean --binary
+</pre><p>First, we must configure <code class="filename">live-helper</code> to create a USD/HDD image type:</p><pre class="screen">
+$ lh_config -b usb-hdd
+</pre><p>We can then build the image with <code class="filename">lh_build</code> as root:</p><pre class="screen">
+# lh_build
+</pre><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id325161"></a>1. Copying USB/HDD image to a USB stick</h2></div></div></div><pre class="screen">
+$ dd if=binary.img of=$USBDRV
+</pre></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id325175"></a>2. Testing a USB/HDD image with Qemu</h2></div></div></div><pre class="screen">
+# apt-get install qemu
+$ qemu -hda binary.img
+</pre></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id325190"></a>4.3. Building an netboot image</h2></div></div></div><p>First, we configure our Live system:</p><pre class="screen">
+$ lh_config -b net --net-root-path "/srv/debian-live" --net-root-server "192.168.0.1"
+</pre><p>In contrast with the ISO and USB/HDD image types, netbooting does not support serving a filesystem image with the client so we must serve the files via NFS. The <em class="replaceable"><code>net-root-path</code></em> and <em class="replaceable"><code>net-root-server</code></em> options specify the location and server respectfully of the NFS server on the filesytem image will be located at boot-time.</p><p>We can then build the image with <code class="filename">lh_build</code> as root:</p><pre class="screen">
+# lh_build
+</pre><p>We must now configure three services:</p><div class="variablelist"><dl><dt><span class="term">NFS server</span></dt><dd><p>This contains the Live filesystem image which the system will use at run-time.</p><p>You should install the <code class="computeroutput">nfs-kernel-server</code> server package -- <code class="computeroutput">nfs-user-server</code> does not function correctly with netboot.</p><p>FIXME</p><pre class="screen">
+/srv/debian-live *(rw,sync,no_root_squash)
+</pre></dd><dt><span class="term">TFTPd server</span></dt><dd><p>This serves the kernel and initial ramdisk to the system at run-time.</p><p>You should install the <code class="computeroutput">tftpd-hpa</code> package.
+
+</p><pre class="screen">
+$ ls /var/lib/tftpboot/
+initrd.gz memtest pxelinux.0 pxelinux.cfg vmlinuz
+</pre><p>
+</p></dd><dt><span class="term">DHCP server</span></dt><dd><p>We must configure our network's DHCP server to advertise the location of the PXE server.</p><p>FIXME</p><pre class="screen">
+next-server 192.168.0.78;
+filename "pxelinux.0";
+</pre></dd></dl></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="installation.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="overview.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Installation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 5. Overview of tools</td></tr></table></div></body></html>
diff --git a/binary.html b/binary.html
new file mode 100644
index 0000000..a100032
--- /dev/null
+++ b/binary.html
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 9. Customising the binary image</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="Debian Live Manual" /><link rel="up" href="index.html" title="Debian Live Manual" /><link rel="prev" href="bootup.html" title="Chapter 8. Customising the bootup process" /><link rel="next" href="common-tasks.html" title="Chapter 10. Common tasks" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 9. Customising the binary image</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bootup.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="common-tasks.html">Next</a></td></tr></table><hr /></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="binary"></a>Chapter 9. Customising the binary image</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="binary.html#id324494">9.1. Hooks</a></span></dt><dt><span class="section"><a href="binary.html#iso-metadata">9.2. ISO metadata</a></span></dt></dl></div><p>This chapter discusses FIXME></p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id324494"></a>9.1. Hooks</h2></div></div></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="iso-metadata"></a>9.2. ISO metadata</h2></div></div></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bootup.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="common-tasks.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 8. Customising the bootup process </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 10. Common tasks</td></tr></table></div></body></html>
diff --git a/bootup.html b/bootup.html
new file mode 100644
index 0000000..b20ec2b
--- /dev/null
+++ b/bootup.html
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 8. Customising the bootup process</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="Debian Live Manual" /><link rel="up" href="index.html" title="Debian Live Manual" /><link rel="prev" href="contents.html" title="Chapter 7. Customising contents" /><link rel="next" href="binary.html" title="Chapter 9. Customising the binary image" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 8. Customising the bootup process</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="contents.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="binary.html">Next</a></td></tr></table><hr /></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="bootup"></a>Chapter 8. Customising the bootup process</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="bootup.html#kernel">8.1. Kernel</a></span></dt><dt><span class="section"><a href="bootup.html#bootloaders">8.2. Bootloaders</a></span></dt><dt><span class="section"><a href="bootup.html#splash">8.3. Splash screens</a></span></dt><dt><span class="section"><a href="bootup.html#memtest">8.4. Memtest</a></span></dt><dt><span class="section"><a href="bootup.html#startup-scripts">8.5. Startup scripts</a></span></dt><dt><span class="section"><a href="bootup.html#cheat-codes">8.6. Cheat codes</a></span></dt></dl></div><p>This chapter discusses customisation of bootup process of a live system, including kernel options, modifications to the bootloader, "splash" screens and startup scripts.</p><p>FIXME</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="kernel"></a>8.1. Kernel</h2></div></div></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="bootloaders"></a>8.2. Bootloaders</h2></div></div></div><p>FIXME</p><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id344446"></a>1. Choosing a bootloader</h2></div></div></div><p>FIXME</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="syslinux"></a>2. Syslinux</h2></div></div></div><p>FIXME</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id354970"></a>3. Bootloader templates</h2></div></div></div><p>FIXME</p></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="splash"></a>8.3. Splash screens</h2></div></div></div><p>FIXME</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="memtest"></a>8.4. Memtest</h2></div></div></div><p>FIXME</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="startup-scripts"></a>8.5. Startup scripts</h2></div></div></div><p>FIXME</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="cheat-codes"></a>8.6. Cheat codes</h2></div></div></div><p>FIXME</p><p>Checksums.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="contents.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="binary.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 7. Customising contents </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 9. Customising the binary image</td></tr></table></div></body></html>
diff --git a/bugs.html b/bugs.html
new file mode 100644
index 0000000..1f54948
--- /dev/null
+++ b/bugs.html
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 13. Reporting bugs</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="Debian Live Manual" /><link rel="up" href="index.html" title="Debian Live Manual" /><link rel="prev" href="faq.html" title="Chapter 12. Frequently asked questions (FAQ)" /><link rel="next" href="resources.html" title="Chapter 14. Resources and links" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 13. Reporting bugs</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="faq.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="resources.html">Next</a></td></tr></table><hr /></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="bugs"></a>Chapter 13. Reporting bugs</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="bugs.html#up-to-date">13.1. Use up-to-date packages</a></span></dt><dt><span class="section"><a href="bugs.html#collect-information">13.2. Collect information</a></span></dt><dt><span class="section"><a href="bugs.html#correct-package">13.3. Use the correct package to report the bug against</a></span></dt><dt><span class="section"><a href="bugs.html#research">13.4. Do the research</a></span></dt><dt><span class="section"><a href="bugs.html#where">13.5. Where to report bugs</a></span></dt></dl></div><p>Debian Live is far from being perfect, but we want to make it as close as possible to perfect - with your help. Do not hesitate to report a bug: it is better to fill a report twice than never. However, here are some recommendations how to file good bug reports:</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="up-to-date"></a>13.1. Use up-to-date packages</h2></div></div></div><p>This means</p><p>Using outdated packages can cause significant problems when trying to reproduce (and ultimately fix) your problem. If a relevant package is not available in Debian anymore, please recognize that the resources of the Debian kernel team are limited and will be unlikely to be able to fix the problem.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="collect-information"></a>13.2. Collect information</h2></div></div></div><p>Please provide enough information with your report. At a minimum, it should contain the exact version of live-helper version where the bug is encountered, and steps to reproduce it. Please use common sense and include other relevant information if you think that it might help in solving the problem.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="correct-package"></a>13.3. Use the correct package to report the bug against</h2></div></div></div><p>Where does the bug appear?</p><p>
+</p><div class="variablelist"><dl><dt><span class="term">At build time whilst bootstrapping</span></dt><dd><p>
+</p><p><code class="filename">live-helper</code> first bootstraps a basic Debian system with <code class="computeroutput">debootstrap</code> or <code class="computeroutput">cdebootstrap</code>. Depending on the bootstrapping tool used and the Debian distribution it is bootstrapping, it may fail. If a bug appears here, check if the error is related to a specific Debian package (most likely), or if it is related to cdebootstrap itself.</p><p>
+
+</p><p>In both cases, this is not a bug in Debian Live, but rather in Debian itself which we can not fix this directly. Please report such a bug against <code class="computeroutput">debootstrap</code>, <code class="computeroutput">cdebootstrap</code> or the failing package.</p><p>
+</p></dd><dt><span class="term">At build time whilst installing packages</span></dt><dd><p><code class="filename">live-helper</code> installs additional packages from the Debian archive and depending on the Debian distribution used and the daily archive state, it can fail. If a bug appears here, check if the error is also reproducible on a normal system.</p><p>If this is the case, this is not a bug in Debian Live, but rather in Debian. Report it against the failing package.</p></dd><dt><span class="term">At run-time</span></dt><dd><p>If a package was successfully installed, but fails while actually running the Live system, this is probably a bug in Debian Live. However, </p></dd></dl></div><p>
+</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="research"></a>13.4. Do the research</h2></div></div></div><p>Before filing the bug, please search the web for the particular error message or symptom you are getting. As it is highly unlikely that you are the only person experiencing a particular problem, there is always a chance that it has been discussed elsewhere, and a possible solution, patch, or workaround has been proposed.</p><p>You should pay particular attention to the Debian Live mailing list, as well as the homepage, as these are likely to contain the most up-to-date information. If such information exists, always include the references to it in your bug report.</p><p>In addition, you should check the <a class="ulink" href="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-helper" target="_top">current bug list for live-helper</a> and the <a class="ulink" href="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-initramfs" target="_top">current bug list for live-initramfs</a> to see whether something similar has been reported already.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="where"></a>13.5. Where to report bugs</h2></div></div></div><p>The Debian Live project keeps track of all bugs in the Debian Bug Tracking System (BTS). For information on how to use the system, please see <a class="ulink" href="http://bugs.debian.org" target="_top">http://bugs.debian.org</a>. You can also submit the bugs by using the <code class="computeroutput">reportbug</code> command from the package with the same name.</p><p>In general, you should report build time errors against the <a class="ulink" href="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-helper" target="_top">live-helper</a> package and run time errors against <a class="ulink" href="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-helper" target="_top">live-initramfs</a>. If you are unsure of which package is appropriate or need more help before submitting a bug report, please send a message to the mailing list and we will help you to figure it out.</p><p>Please note that bugs found in distributions derived from Debian (such as Ubuntu, Knoppix, Xandros, etc.) should <span class="emphasis"><em>not</em></span> be reported to the Debian BTS unless they can be also reproduced on a Debian system using official Debian packages.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="faq.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="resources.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 12. Frequently asked questions (FAQ) </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 14. Resources and links</td></tr></table></div></body></html>
diff --git a/chapters/about.sgml b/chapters/about.sgml
deleted file mode 100644
index 4e24c62..0000000
--- a/chapters/about.sgml
+++ /dev/null
@@ -1,104 +0,0 @@
-<chapt id="about">
-<heading>About the Debian Live Project</heading>
-
-<sect id="motivation">
-<heading>Motivation</heading>
-
-<sect1>
-<heading>What is wrong with current live systems</heading>
-
-<p>There are already several Debian-based live systems and they are doing a great job. But, from the Debian perspective, most of them have one or more of the following disadvantages:
-
-<list>
-<item>They are unofficial projects, developed outside of Debian.</item>
-<item>They mix different distributions, e.g. testing and unstable.</item>
-<item>They support i386 only.</item>
-<item>They change package's behavior and/or appearance by stripping them down to save space.</item>
-<item>They include unofficial packages.</item>
-<item>They ship custom kernels with additional patches not part of Debian.</item>
-<item>They are large and slow due to their sheer size and thus not suitable for rescue issues.</item>
-<item>They are not available in different flavours, e.g. CDs, DVDs, USB-stick and netboot images </item>
-</list>
-</sect1>
-
-<sect1>
-<heading>Why create our own live system?</heading>
-
-<p>Debian is the Universal Operating System: Debian should have an official live system for showing around and to officially represent the true, one and only Debian system with the following main advantages:
-
-<list>
-<item>It would be an official Debian subproject.</item>
-<item>It reflects the (current) state of one distribution.</item>
-<item>It runs on as many architectures as possible.</item>
-<item>It consists of unchanged Debian packages only.</item>
-<item>It does not contain any unofficial packages.</item>
-<item>It uses an unaltered Debian kernel-image with no additional patches.</item>
-</list>
-
-</sect>
-
-<sect id="philosophy">
-<heading>Philosophy</heading>
-
-<sect1>
-<heading>Only unchanged, official packages</heading>
-<p>We will only use official packages from the Debian repository, section main or maybe contrib (the use of contrib is not decided yet). The non-free section is not part of Debian and therefore not used at all for the live system.</p>
-
-<p>We will not change any packages. Whenever we need to change something, we will do that in coordination with its package maintainer in Debian.</p>
-
-<p>Exception: temporarly, our own packages like live-helper or live-initramfs may be used from our own repository for development reasons (e.g. to create development snapshots). They will be synced into Debian on a regular basis.</p>
-</sect1>
-
-<sect1>
-<heading>No configuration of the live system</heading>
-<p>In this phase we will not ship or install sample or alternative configurations. All packages are used in their default configuration as they are after a regular installation of Debian.</p>
-
-<p>Whenever we need a different default configuration, we will do that in coordination with its package maintainer in Debian.</p>
-
-<p>A system for configuring packages is provided using debconf in lh_config (use --preseed FILE) allowing custom configured packages to be installed in your custom produced Debian Live images, but for official live images only default configuration will be used.</p>
-
-<p>Exception: There are a few essential changes needed to be make a live system alive (e.g. configuring pam to allow empty passwords). These essential changes have to be kept as minimal as possible and, should be merged within the Debian repository if possible.</p>
-</sect1>
-
-<sect1>
-<heading>No live system to hardisk installer</heading>
-<p>[ this is no longer valid after etch release, we will work on an installer for lenny ]</p>
-
-<p>For the moment we will not ship a installer to copy the live system to a partition on the hardisk. Although we keep the changes in the live system as drastically minimal as possible compared to a regular Debian installation, the live system does differ in a few essential points (see exceptions, guideline 2).</p>
-
-<p>Therefore, we will ship a copy of the regular DebianInstaller (resp. Debian Installer, Graphical Installer) instead, to allow users to perform a regular Debian installation (and, of course, cdebootstrap and debootstrap are on the system too).</p>
-</sect1>
-
-</sect>
-
-<sect id="contact">
-<heading>Contact</heading>
-<p>
-<taglist>
-
-<tag>Mailing list</tag>
-<item>
-The primary contact for the project is the <url id="http://lists.alioth.debian.org/mailman/listinfo/debian-live-devel" name="mailing list">. You can email the list directly by addressing your mail to <email>debian-live-devel at lists.alioth.debian.org</email>. The <url id="http://lists.alioth.debian.org/pipermail/debian-live-devel/" name="list archives"> are also available.
-</item>
-
-<tag>IRC</tag>
-<item>
-A number of users and developers are present in the <url id="irc://irc.debian.org/#debian-live" name="#debian-live"> channel on <url id="http://oftc.net" name="OFTC">. When asking a question on IRC, please be patient for an answer. If no answer is forthcoming, please email the mailing list.
-</item>
-
-<tag>BTS</tag>
-<item>
-The Debian Bug Tracking System (BTS) contains details of bugs reported by ysers and developers. Each bug is given a number, and is kept on file until it is marked as having been dealt with. For more information, please see <ref id="bugs">.
-</item>
-
-<tag>Wiki</tag>
-<item>
-FIXME. <url id="http://wiki.debian.org/DebianLive" name="our entry on the Debian wiki">.
-</item>
-
-</taglist>
-</p>
-
-</sect>
-
-</chapt>
diff --git a/chapters/about.xml b/chapters/about.xml
new file mode 100644
index 0000000..f2ab407
--- /dev/null
+++ b/chapters/about.xml
@@ -0,0 +1,111 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="about">
+<title>About the Debian Live Project</title>
+
+<section id="motivation">
+<title>Motivation</title>
+
+<sect1>
+<title>What is wrong with current live systems</title>
+
+<para>There are already several Debian-based live systems and they are doing a great job. But, from the Debian perspective, most of them have one or more of the following disadvantages:</para>
+
+<orderedlist>
+<listitem><para>They are unofficial projects, developed outside of Debian.</para></listitem>
+<listitem><para>They mix different distributions, e.g. testing and unstable.</para></listitem>
+<listitem><para>They support i386 only.</para></listitem>
+<listitem><para>They change package's behavior and/or appearance by stripping them down to save space.</para></listitem>
+<listitem><para>They include unofficial packages.</para></listitem>
+<listitem><para>They ship custom kernels with additional patches not part of Debian.</para></listitem>
+<listitem><para>They are large and slow due to their sheer size and thus not suitable for rescue issues.</para></listitem>
+<listitem><para>They are not available in different flavours, e.g. CDs, DVDs, USB-stick and netboot images </para></listitem>
+</orderedlist>
+</sect1>
+
+<sect1>
+<title>Why create our own live system?</title>
+
+<para>Debian is the Universal Operating System: Debian should have an official live system for showing around and to officially represent the true, one and only Debian system with the following main advantages:</para>
+
+<orderedlist>
+<listitem><para>It would be an official Debian subproject.</para></listitem>
+<listitem><para>It reflects the (current) state of one distribution.</para></listitem>
+<listitem><para>It runs on as many architectures as possible.</para></listitem>
+<listitem><para>It consists of unchanged Debian packages only.</para></listitem>
+<listitem><para>It does not contain any unofficial packages.</para></listitem>
+<listitem><para>It uses an unaltered Debian kernel-image with no additional patches.</para></listitem>
+</orderedlist>
+
+</sect1>
+
+</section>
+
+<section id="philosophy">
+<title>Philosophy</title>
+
+<sect1>
+<title>Only unchanged, official packages</title>
+<para>We will only use official packages from the Debian repository, section main or maybe contrib (the use of contrib is not decided yet). The non-free section is not part of Debian and therefore not used at all for the live system.</para>
+
+<para>We will not change any packages. Whenever we need to change something, we will do that in coordination with its package maintainer in Debian.</para>
+
+<para>Exception: temporarly, our own packages like live-helper or live-initramfs may be used from our own repository for development reasons (e.g. to create development snapshots). They will be synced into Debian on a regular basis.</para>
+</sect1>
+
+<sect1>
+<title>No configuration of the live system</title>
+<para>In this phase we will not ship or install sample or alternative configurations. All packages are used in their default configuration as they are after a regular installation of Debian.</para>
+
+<para>Whenever we need a different default configuration, we will do that in coordination with its package maintainer in Debian.</para>
+
+<para>A system for configuring packages is provided using debconf in lh_config (use --preseed FILE) allowing custom configured packages to be installed in your custom produced Debian Live images, but for official live images only default configuration will be used.</para>
+
+<para>Exception: There are a few essential changes needed to be make a live system alive (e.g. configuring pam to allow empty passwords). These essential changes have to be kept as minimal as possible and, should be merged within the Debian repository if possible.</para>
+</sect1>
+
+<sect1>
+<title>No live system to hardisk installer</title>
+<para>[ this is no longer valid after etch release, we will work on an installer for lenny ]</para>
+
+<para>For the moment we will not ship a installer to copy the live system to a partition on the hardisk. Although we keep the changes in the live system as drastically minimal as possible compared to a regular Debian installation, the live system does differ in a few essential points (see exceptions, guideline 2).</para>
+
+<para>Therefore, we will ship a copy of the regular DebianInstaller (resp. Debian Installer, Graphical Installer) instead, to allow users to perform a regular Debian installation (and, of course, cdebootstrap and debootstrap are on the system too).</para>
+</sect1>
+
+</section>
+
+<section id="contact">
+<title>Contact</title>
+
+<variablelist>
+ <varlistentry><term>Mailing list</term>
+ <listitem><para>The primary contact for the project is the <ulink url="http://lists.alioth.debian.org/mailman/listinfo/debian-live-devel">mailing list</ulink>. You can email the list directly by addressing your mail to <email>debian-live-devel at lists.alioth.debian.org</email>. The <ulink url="http://lists.alioth.debian.org/pipermail/debian-live-devel/">list archives</ulink> are also available.</para></listitem>
+</varlistentry>
+
+<varlistentry><term>IRC</term>
+<listitem><para>
+A number of users and developers are present in the <ulink url="irc://irc.debian.org/#debian-live">#debian-live</ulink> channel on <ulink url="http://oftc.net">OFTC</ulink>. When asking a question on IRC, please be patient for an answer. If no answer is forthcoming, please email the mailing list.
+</para></listitem>
+</varlistentry>
+
+<varlistentry><term>BTS</term>
+<listitem><para>
+The Debian Bug Tracking System (BTS) contains details of bugs reported by ysers and developers. Each bug is given a number, and is kept on file until it is marked as having been dealt with. For more information, please see <xref linkend="bugs"/>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Wiki</term>
+<listitem><para>
+FIXME. <ulink url="http://wiki.debian.org/DebianLive">our entry on the Debian wiki</ulink>.
+</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</section>
+
+</chapter>
diff --git a/chapters/basics.sgml b/chapters/basics.sgml
deleted file mode 100644
index 15c11a7..0000000
--- a/chapters/basics.sgml
+++ /dev/null
@@ -1,146 +0,0 @@
-<chapt id="basics">
-<heading>The basics</heading>
-
-<p>This chapter contains a brief overview of the build process as well as containing instructions on how to boot the various binary image types.</p>
-
-<sect>
-<heading>First steps: building an ISO image</heading>
-
-<p>The following sequence of commands will create a basic ISO image containing just the Debian standard system without X.org. It is suitable for burning to CD or DVD media.</p>
-
-<p>First, we must configure our Live system:
-
-<example>
-$ lh_config
-</example>
-
-<p>Passing no parameters indicated that we wish to use the default binary image type. You will see that <tt>live-helper</tt> created a <file>"config/"</file> hierarchy in your current directory - this is used by the rest of <tt>live-helper</tt> to build your live image.</p>
-
-<p>We can then build the image with <tt>lh_build</tt> as root:
-
-<example>
-# lh_build
-</example>
-
-<p>This process can take a while, depending on the speed of your network connection.</p>
-
-<sect1>
-<heading>Testing an ISO image with Qemu</heading>
-<p>Testing an ISO is simple:
-
-<example>
-# apt-get install qemu
-$ qemu -cdrom binary.iso
-</example></p>
-</sect1>
-
-<sect1>
-<heading>Burning an ISO image to physical medium</heading>
-<p>Burning an ISO image is easy:
-
-<example>
-# apt-get install wodim
-$ wodim binary.iso
-</example></p>
-</sect1>
-
-</sect>
-
-<sect>
-<heading>Building an USB/HDD image</heading>
-<p>The following sequence of commands will create a basic USB/HDD image containing just the Debian standard system without X.org. It is suitable for booting from USB sticks, hard drives and various other portable storage devices.</p>
-
-<p>Note if an iso image had been previously built, you will need to clean live-helper:<p>
-
-<example>
-$ lh_clean --binary
-</example>
-
-<p>First, we must configure <tt>live-helper</tt> to create a USD/HDD image type:
-
-<example>
-$ lh_config -b usb-hdd
-</example>
-
-<p>We can then build the image with <tt>lh_build</tt> as root:
-
-<example>
-# lh_build
-</example>
-
-<sect1>
-<heading>Copying USB/HDD image to a USB stick</heading>
-<p>
-<example>
-$ dd if=binary.img of=$USBDRV
-</example></p>
-</sect1>
-
-<sect1>
-<heading>Testing a USB/HDD image with Qemu</heading>
-<p>
-<example>
-# apt-get install qemu
-$ qemu -hda binary.img
-</example></p>
-</sect1>
-</sect>
-
-<sect>
-<heading>Building an netboot image</heading>
-
-<p>First, we configure our Live system:
-
-<example>
-$ lh_config -b net --net-root-path "/srv/debian-live" --net-root-server "192.168.0.1"
-</example>
-
-<p>In contrast with the ISO and USB/HDD image types, netbooting does not support serving a filesystem image with the client so we must serve the files via NFS. The <var>net-root-path</var> and <var>net-root-server</var> options specify the location and server respectfully of the NFS server on the filesytem image will be located at boot-time.</p>
-
-<p>We can then build the image with <tt>lh_build</tt> as root:
-
-<example>
-# lh_build
-</example>
-
-<p>We must now configure three services:
-
-<taglist>
-<tag>NFS server</tag>
-<item>
-<p>This contains the Live filesystem image which the system will use at run-time.</p>
-<p>You should install the <tt>nfs-kernel-server</tt> server package -- <tt>nfs-user-server</tt> does not function correctly with netboot.</p>
-<p>FIXME
-
-<example>
-/srv/debian-live *(rw,sync,no_root_squash)
-</example>
-</item>
-
-<tag>TFTPd server</tag>
-<item>
-<p>This serves the kernel and initial ramdisk to the system at run-time.</p>
-<p>You should install the <tt>tftpd-hpa</tt> package.
-
-<example>
-$ ls /var/lib/tftpboot/
-initrd.gz memtest pxelinux.0 pxelinux.cfg vmlinuz
-</example>
-</item>
-
-<tag>DHCP server</tag>
-<item>
-<p>We must configure our network's DHCP server to advertise the location of the PXE server.</p>
-<p>FIXME
-
-<example>
-next-server 192.168.0.78;
-filename "pxelinux.0";
-</example>
-</item>
-
-</taglist>
-
-</sect>
-
-</chapt>
diff --git a/chapters/basics.xml b/chapters/basics.xml
new file mode 100644
index 0000000..b0f68e8
--- /dev/null
+++ b/chapters/basics.xml
@@ -0,0 +1,152 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="basics">
+<title>The basics</title>
+
+<para>This chapter contains a brief overview of the build process as well as containing instructions on how to boot the various binary image types.</para>
+
+<section>
+<title>First steps: building an ISO image</title>
+
+<para>The following sequence of commands will create a basic ISO image containing just the Debian standard system without X.org. It is suitable for burning to CD or DVD media.</para>
+
+<para>First, we must configure our Live system:</para>
+
+<screen>
+$ lh_config
+</screen>
+
+<para>Passing no parameters indicated that we wish to use the default binary image type. You will see that <filename>live-helper</filename> created a <filename>"config/"</filename> hierarchy in your current directory - this is used by the rest of <filename>live-helper</filename> to build your live image.</para>
+
+<para>We can then build the image with <filename>lh_build</filename> as root:</para>
+
+<screen>
+# lh_build
+</screen>
+
+<para>This process can take a while, depending on the speed of your network connection.</para>
+
+<sect1>
+<title>Testing an ISO image with Qemu</title>
+<para>Testing an ISO is simple:</para>
+
+<screen>
+# apt-get install qemu
+$ qemu -cdrom binary.iso
+</screen>
+</sect1>
+
+<sect1>
+<title>Burning an ISO image to physical medium</title>
+<para>Burning an ISO image is easy:</para>
+
+<screen>
+# apt-get install wodim
+$ wodim binary.iso
+</screen>
+</sect1>
+
+</section>
+
+<section>
+<title>Building an USB/HDD image</title>
+<para>The following sequence of commands will create a basic USB/HDD image containing just the Debian standard system without X.org. It is suitable for booting from USB sticks, hard drives and various other portable storage devices.</para>
+
+<para>Note if an iso image had been previously built, you will need to clean live-helper:</para>
+
+<screen>
+$ lh_clean --binary
+</screen>
+
+<para>First, we must configure <filename>live-helper</filename> to create a USD/HDD image type:</para>
+
+<screen>
+$ lh_config -b usb-hdd
+</screen>
+
+<para>We can then build the image with <filename>lh_build</filename> as root:</para>
+
+<screen>
+# lh_build
+</screen>
+
+<sect1>
+<title>Copying USB/HDD image to a USB stick</title>
+<screen>
+$ dd if=binary.img of=$USBDRV
+</screen>
+</sect1>
+
+<sect1>
+<title>Testing a USB/HDD image with Qemu</title>
+<screen>
+# apt-get install qemu
+$ qemu -hda binary.img
+</screen>
+</sect1>
+</section>
+
+<section>
+<title>Building an netboot image</title>
+
+<para>First, we configure our Live system:</para>
+
+<screen>
+$ lh_config -b net --net-root-path "/srv/debian-live" --net-root-server "192.168.0.1"
+</screen>
+
+<para>In contrast with the ISO and USB/HDD image types, netbooting does not support serving a filesystem image with the client so we must serve the files via NFS. The <replaceable>net-root-path</replaceable> and <replaceable>net-root-server</replaceable> options specify the location and server respectfully of the NFS server on the filesytem image will be located at boot-time.</para>
+
+<para>We can then build the image with <filename>lh_build</filename> as root:</para>
+
+<screen>
+# lh_build
+</screen>
+
+<para>We must now configure three services:</para>
+
+<variablelist>
+<varlistentry><term>NFS server</term>
+<listitem>
+<para>This contains the Live filesystem image which the system will use at run-time.</para>
+<para>You should install the <computeroutput>nfs-kernel-server</computeroutput> server package -- <computeroutput>nfs-user-server</computeroutput> does not function correctly with netboot.</para>
+<para>FIXME</para>
+
+<screen>
+/srv/debian-live *(rw,sync,no_root_squash)
+</screen>
+</listitem>
+</varlistentry>
+
+<varlistentry><term>TFTPd server</term>
+<listitem>
+<para>This serves the kernel and initial ramdisk to the system at run-time.</para>
+<para>You should install the <computeroutput>tftpd-hpa</computeroutput> package.
+
+<screen>
+$ ls /var/lib/tftpboot/
+initrd.gz memtest pxelinux.0 pxelinux.cfg vmlinuz
+</screen>
+</para></listitem>
+</varlistentry>
+
+<varlistentry><term>DHCP server</term>
+<listitem>
+<para>We must configure our network's DHCP server to advertise the location of the PXE server.</para>
+<para>FIXME</para>
+
+<screen>
+next-server 192.168.0.78;
+filename "pxelinux.0";
+</screen>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</section>
+
+</chapter>
diff --git a/chapters/bugs.sgml b/chapters/bugs.sgml
deleted file mode 100644
index d2598a6..0000000
--- a/chapters/bugs.sgml
+++ /dev/null
@@ -1,96 +0,0 @@
-<chapt id="bugs">
-<heading>How to report a bug in Debian Live</heading>
-
-<p><i>"No software is perfect... we need your help!"</i></p>
-
-<p>Debian Live is far from being perfect, but we want to make it as close as possible to perfect - with your help.</p>
-
-<p>As such, do not hesitate to report a bug: it is better to fill a report twice or even to report a potential non-bug than no bug at all.</p>
-
-<p>However, here are some recommendations how to file good bug reports so that they are the most effective.</p>
-
-<p>For the impatient:</p>
-
-<ul><li>Do always reproduce with the most current version of live-helper and live-initramfs before submitting a bugreport.</li>
-
-<li>Do always try to give as *specific* as possible information about the bug. This not just includes the version of live-helper and live-initramfs used, the distribution of the live system you are building.</li></ul>
-
-<sect>
-<heading>Where does the bug appear?</heading>
-
-<p>...at build time while bootstrapping?</p>
-
-<p>live-helper first bootstraps a basic Debian system with debootstrap(8) or
-cdebootstrap(1). Depending on both debootstrap/cdebootstrap and the Debian
-distribution it is bootstrapping, it runs sucessful or not. If a bug appears
-here, check if the error is related to a specific Debian package (most likely),
-or if it is related to debootstrap/cdebootstrap itself. Running lh_bootstrap
-with --debug gives you more information.</p>
-
-<p>Also, if you are using a local mirror or any of sort of (package) proxy and
-you are experiencing a problem with bootstrapping, always reproduce it first by
-bootstrapping from an official Debian mirror.</p>
-
-<p>In all cases above, these are not a bug in live-helper, but rather in Debian
-itself. We can not fix this directly. Instead, report such a bug against the
-failing package, or in case of a bug in the bootstrapping tool, against
-debootstrap or cdebootstrap, or the (package) proxy software you are using.</p>
-
-<p>...at build time while installing packages?</p>
-
-<p>live-helper installs additional packages from the Debian archive. Depending
-on the Debian distribution used and the daily archive state, it can fail. If a
-bug appears here, check if the error is also reproducible on a normal installed
-(non-live) system.</p>
-
-<p>Also, if you are including any sort of unofficial package to your live system
-and you are experiencing problems, rebuild without those before filling a bug
-to make sure that they are not the cause of the failure.</p>
-
-<p>In all cases above, these are not a bug in live-helper, but rather in Debian
-again. Report it against the failing package(s).</p>
-
-<p>...at boot time?</p>
-
-<p>If your image does not boot, please report it to the mailing list together
-with the information requested in 2. Do not forget to mention, how/when the
-image failed, in qemu, vmware or real hardware. If you are using a
-virtualization technology of any kind, do always run it on real hardware before
-reporting a bug. Nevertheless, providing a screenshot of the failure is also
-very helpful.</p>
-
-<p>...at run time?</p>
-
-<p>If a package was successfully installed, but fails while actually running the
-Live system, this is probably a bug in Debian Live and you are welcome to report
-it to us.</p>
-</sect>
-
-<sect>
-<heading>Where to send the bug report?</heading>
-
-<p>Report error logs of build time errors to live-helper and run time errors to
-live-initramfs in the Debian Bug Tracking System. If you are unsure or need more
-help before submitting a bug report, you can always send a message to
-<debian-devel-live at lists.alioth.debian.org>. We will help you to figure it out.</p>
-
-<p>To make the most out of your bug report, we require at least the following
-information:</p>
-
-<ul><li>Architecture of the host system</li>
-<li>Version of live-helper on the host system</li>
-<li>Version of live-initramfs on the live system</li>
-<li>Version of debootstrap and/or cdebootstrap on the host system</li></ul>
-
-<ul><li>Architecture of the live system</li>
-<li>Distribution of the live system</li>
-<li>Version of the kernel on the live system</li></ul>
-
-<p>Additionally, to rule out other errors, it is always a good idea to tar up
-your config directory and upload it somewhere (do *not* send it as an attachment
-to the mailinglist), so that we can try to reproduce the errors you
-encountered.</p>
-
-</sect>
-
-</chapt>
diff --git a/chapters/bugs.xml b/chapters/bugs.xml
new file mode 100644
index 0000000..41dfc65
--- /dev/null
+++ b/chapters/bugs.xml
@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="bugs">
+<title>How to report a bug in Debian Live</title>
+
+<para><i>"No software is perfect... we need your help!"</i></para>
+
+<para>Debian Live is far from being perfect, but we want to make it as close as possible to perfect - with your help.</para>
+
+<para>As such, do not hesitate to report a bug:</para> it is better to fill a report twice or even to report a potential non-bug than no bug at all.</para>
+
+<para>However, here are some recommendations how to file good bug reports so that they are the most effective.</para>
+
+<para>For the impatient:</para>
+
+<ul><li>Do always reproduce with the most current version of live-helper and live-initramfs before submitting a bugreport.</li>
+
+<li>Do always try to give as *specific* as possible information about the bug. This not just includes the version of live-helper and live-initramfs used, the distribution of the live system you are building.</li></ul>
+
+<section>
+<title>Where does the bug appear?</title>
+
+<para>...at build time while bootstrapping?</para>
+
+<para>live-helper first bootstraps a basic Debian system with debootstrap(8) or
+cdebootstrap(1). Depending on both debootstrap/cdebootstrap and the Debian
+distribution it is bootstrapping, it runs sucessful or not. If a bug appears
+here, check if the error is related to a specific Debian package (most likely),
+or if it is related to debootstrap/cdebootstrap itself. Running lh_bootstrap
+with --debug gives you more information.</para>
+
+<para>Also, if you are using a local mirror or any of sort of (package) proxy and
+you are experiencing a problem with bootstrapping, always reproduce it first by
+bootstrapping from an official Debian mirror.</para>
+
+<para>In all cases above, these are not a bug in live-helper, but rather in Debian
+itself. We can not fix this directly. Instead, report such a bug against the
+failing package, or in case of a bug in the bootstrapping tool, against
+debootstrap or cdebootstrap, or the (package) proxy software you are using.</para>
+
+<para>...at build time while installing packages?</para>
+
+<para>live-helper installs additional packages from the Debian archive. Depending
+on the Debian distribution used and the daily archive state, it can fail. If a
+bug appears here, check if the error is also reproducible on a normal installed
+(non-live) system.</para>
+
+<para>Also, if you are including any sort of unofficial package to your live system
+and you are experiencing problems, rebuild without those before filling a bug
+to make sure that they are not the cause of the failure.</para>
+
+<para>In all cases above, these are not a bug in live-helper, but rather in Debian
+again. Report it against the failing package(s).</para>
+
+<para>...at boot time?</para>
+
+<para>If your image does not boot, please report it to the mailing list together
+with the information requested in 2. Do not forget to mention, how/when the
+image failed, in qemu, vmware or real hardware. If you are using a
+virtualization technology of any kind, do always run it on real hardware before
+reporting a bug. Nevertheless, providing a screenshot of the failure is also
+very helpful.</para>
+
+<para>...at run time?</para>
+
+<para>If a package was successfully installed, but fails while actually running the
+Live system, this is probably a bug in Debian Live and you are welcome to report
+it to us.</para>
+</section>
+
+<section>
+<title>Where to send the bug report?</title>
+
+<para>Report error logs of build time errors to live-helper and run time errors to
+live-initramfs in the Debian Bug Tracking System. If you are unsure or need more
+help before submitting a bug report, you can always send a message to
+<debian-devel-live at lists.alioth.debian.org>. We will help you to figure it out.</para>
+
+<para>To make the most out of your bug report, we require at least the following
+information:</para>
+
+<ul><li>Architecture of the host system</li>
+<li>Version of live-helper on the host system</li>
+<li>Version of live-initramfs on the live system</li>
+<li>Version of debootstrap and/or cdebootstrap on the host system</li></ul>
+
+<ul><li>Architecture of the live system</li>
+<li>Distribution of the live system</li>
+<li>Version of the kernel on the live system</li></ul>
+
+<para>Additionally, to rule out other errors, it is always a good idea to tar up
+your config directory and upload it somewhere (do *not* send it as an attachment
+to the mailinglist), so that we can try to reproduce the errors you
+encountered.</para>
+
+</section>
+
+</chapter>
diff --git a/chapters/common-tasks.sgml b/chapters/common-tasks.sgml
deleted file mode 100644
index e4a1439..0000000
--- a/chapters/common-tasks.sgml
+++ /dev/null
@@ -1,9 +0,0 @@
-<chapt id="common-tasks">
-<heading>Common tasks</heading>
-
-<sect id="debian-installer">
-<heading>The Debian Installer</heading>
-<p>FIXME.</p>
-</sect>
-
-</chapt>
diff --git a/chapters/common-tasks.xml b/chapters/common-tasks.xml
new file mode 100644
index 0000000..d9b7ade
--- /dev/null
+++ b/chapters/common-tasks.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="common-tasks">
+<title>Common tasks</title>
+
+<section id="debian-installer">
+<title>The Debian Installer</title>
+<para>FIXME.</para>
+</section>
+
+</chapter>
diff --git a/chapters/customisation-binary.sgml b/chapters/customisation-binary.sgml
deleted file mode 100644
index 9a0ebd7..0000000
--- a/chapters/customisation-binary.sgml
+++ /dev/null
@@ -1,14 +0,0 @@
-<chapt id="binary">
-<heading>Customising the binary image</heading>
-
-<p>This chapter discusses FIXME></p>
-
-<sect>
-<heading>Hooks</heading>
-</sect>
-
-<sect id="iso-metadata">
-<heading>ISO metadata</heading>
-</sect>
-
-</chapt>
diff --git a/chapters/customisation-binary.xml b/chapters/customisation-binary.xml
new file mode 100644
index 0000000..7d70c30
--- /dev/null
+++ b/chapters/customisation-binary.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="binary">
+<title>Customising the binary image</title>
+
+<para>This chapter discusses FIXME></para>
+
+<section>
+<title>Hooks</title>
+</section>
+
+<section id="iso-metadata">
+<title>ISO metadata</title>
+</section>
+
+</chapter>
diff --git a/chapters/customisation-bootup.sgml b/chapters/customisation-bootup.sgml
deleted file mode 100644
index 26e6261..0000000
--- a/chapters/customisation-bootup.sgml
+++ /dev/null
@@ -1,53 +0,0 @@
-<chapt id="bootup">
-<heading>Customising the bootup process</heading>
-
-<p>This chapter discusses customisation of bootup process of a live system, including kernel options, modifications to the bootloader, "splash" screens and startup scripts.</p>
-
-<p>FIXME</p>
-
-<sect id="kernel">
-<heading>Kernel</heading>
-</sect>
-
-<sect id="bootloaders">
-<heading>Bootloaders</heading>
-<p>FIXME</p>
-
-<sect1>
-<heading>Choosing a bootloader</heading>
-<p>FIXME</p>
-</sect1>
-
-<sect1 id="syslinux">
-<heading>Syslinux</heading>
-<p>FIXME</p>
-</sect1>
-
-<sect1>
-<heading>Bootloader templates</heading>
-<p>FIXME</p>
-</sect1>
-</sect>
-
-<sect id="splash">
-<heading>Splash screens</heading>
-<p>FIXME</p>
-</sect>
-
-<sect id="memtest">
-<heading>Memtest</heading>
-<p>FIXME</p>
-</sect>
-
-<sect id="startup-scripts">
-<heading>Startup scripts</heading>
-<p>FIXME</p>
-</sect>
-
-<sect id="cheat-codes">
-<heading>Cheat codes</heading>
-<p>FIXME</p>
-<p>Checksums.</p>
-</sect>
-
-</chapt>
diff --git a/chapters/customisation-bootup.xml b/chapters/customisation-bootup.xml
new file mode 100644
index 0000000..179c9ad
--- /dev/null
+++ b/chapters/customisation-bootup.xml
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="bootup">
+<title>Customising the bootup process</title>
+
+<para>This chapter discusses customisation of bootup process of a live system, including kernel options, modifications to the bootloader, "splash" screens and startup scripts.</para>
+
+<para>FIXME</para>
+
+<section id="kernel">
+<title>Kernel</title>
+</section>
+
+<section id="bootloaders">
+<title>Bootloaders</title>
+<para>FIXME</para>
+
+<sect1>
+<title>Choosing a bootloader</title>
+<para>FIXME</para>
+</sect1>
+
+<sect1 id="syslinux">
+<title>Syslinux</title>
+<para>FIXME</para>
+</sect1>
+
+<sect1>
+<title>Bootloader templates</title>
+<para>FIXME</para>
+</sect1>
+</section>
+
+<section id="splash">
+<title>Splash screens</title>
+<para>FIXME</para>
+</section>
+
+<section id="memtest">
+<title>Memtest</title>
+<para>FIXME</para>
+</section>
+
+<section id="startup-scripts">
+<title>Startup scripts</title>
+<para>FIXME</para>
+</section>
+
+<section id="cheat-codes">
+<title>Cheat codes</title>
+<para>FIXME</para>
+<para>Checksums.</para>
+</section>
+
+</chapter>
diff --git a/chapters/customisation-contents.sgml b/chapters/customisation-contents.sgml
deleted file mode 100644
index 561bedd..0000000
--- a/chapters/customisation-contents.sgml
+++ /dev/null
@@ -1,42 +0,0 @@
-<chapt id="contents">
-<heading>Customising contents</heading>
-
-<p>This chapter discusses further customisation of the live system.</p>
-
-<sect id="hooks">
-<heading>Hooks</heading>
-
-<p>FIXME.</p>
-<p>Enabling hooks</p>
-
-<sect1 id="chroot-local-hooks">
-<heading>Live/chroot local hooks</heading>
-<p>FIXME.</p>
-</sect1>
-
-<sect1 id="binary-local-hooks">
-<heading>Binary local hooks</heading>
-<p>FIXME.</p>
-</sect1>
-
-</sect>
-
-<sect>
-<heading>Includes</heading>
-
-<sect1 id="chroot-includes">
-<heading>Live/chroot includes</heading>
-<p>FIXME.</p>
-</sect1>
-
-<sect1 id="binary-includes">
-<heading>Binary includes</heading>
-<p>FIXME.</p>
-</sect1>
-</sect>
-
-<sect id="symlinks">
-<heading>Symlink conversion</heading>
-<p>FIXME. (This is probably in the wrong section)</p>
-</sect>
-</chapt>
diff --git a/chapters/customisation-contents.xml b/chapters/customisation-contents.xml
new file mode 100644
index 0000000..5acf83a
--- /dev/null
+++ b/chapters/customisation-contents.xml
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="contents">
+<title>Customising contents</title>
+
+<para>This chapter discusses further customisation of the live system.</para>
+
+<section id="hooks">
+<title>Hooks</title>
+
+<para>FIXME.</para>
+<para>Enabling hooks</para>
+
+<sect1 id="chroot-local-hooks">
+<title>Live/chroot local hooks</title>
+<para>FIXME.</para>
+</sect1>
+
+<sect1 id="binary-local-hooks">
+<title>Binary local hooks</title>
+<para>FIXME.</para>
+</sect1>
+
+</section>
+
+<section>
+<title>Includes</title>
+
+<sect1 id="chroot-includes">
+<title>Live/chroot includes</title>
+<para>FIXME.</para>
+</sect1>
+
+<sect1 id="binary-includes">
+<title>Binary includes</title>
+<para>FIXME.</para>
+</sect1>
+</section>
+
+<section id="symlinks">
+<title>Symlink conversion</title>
+<para>FIXME. (This is probably in the wrong section)</para>
+</section>
+</chapter>
diff --git a/chapters/customisation-packages.sgml b/chapters/customisation-packages.sgml
deleted file mode 100644
index ab6d284..0000000
--- a/chapters/customisation-packages.sgml
+++ /dev/null
@@ -1,200 +0,0 @@
-<chapt id="packages">
-<heading>Customising package installation</heading>
-
-<p>This chapter discusses the customisation of package installation. This involves:
-
-<list>
-<item>Selecting additional packages to be installed</item>
-<item>Installing modified packages</item>
-</list></p>
-
-<sect id="package-sources">
-<heading>Package sources</heading>
-<p>FIXME</p>
-</sect>
-
-<sect id="package-installation">
-<heading>Package installation</heading>
-<p>You can elect to use either <tt>apt</tt> or <tt>aptitude</tt> when installing packages. Which utility is used is governed by the <tt>LH_APT</tt> varaible in <file>config/chroot</file> or by the <tt>--apt</tt> argument to <tt>lh_config</tt>:
-
-<taglist>
-<tag><tt>apt</tt></tag>
-<item>
-<p>Specifying a missing package causes package installation to fail, which may not be the desired behaviour.</p>
-<p>This is the default setting for building images for Lenny or later.</p>
-</item>
-
-<tag><tt>aptitude</tt></tag>
-<item>
-<p>Specifying a missing package causes package installation to succeed, which may not be the desired behaviour.</p>
-<p>This is the default setting for building images for Etch.</p>
-</item>
-</taglist>
-</p>
-
-</sect>
-
-<sect>
-<heading>Installing additional packages</heading>
-
-<p><tt>live-helper</tt> has a number of mechanisms for indicating that additional packages should be installed, including:
-
-<list>
-<item>The <tt>LH_PACKAGES</tt> variable</item>
-<item>Package lists</item>
-<item>Local packages (<tt>chroot_local-packages/</tt>)</item>
-<item>Tasks</item>
-</list></p>
-
-<sect1 id="lh-packages">
-<heading>The <tt>LH_PACKAGES</tt> variable</heading>
-<p>To install additional packages, simply add them to the <tt>LH_PACKAGES</tt> variable in <file>config/chroot</file>. For example:
-
-<example>
-LH_PACKAGES="package1 package2 package3 ... "
-</example>
-
-You can also specify an initial values on the command line:
-
-<example>
-% lh_config --packages "package1 package2 package3"
-</example>
-</p>
-
-<p>The behaviour of <tt>live-helper</tt> when specifying a package that does not exist is determined by your choice of APT utility. See <ref id="package-installation"> for more details.</p>
-
-<p>If you need to specify a large number of packages to be installed or you need flexibility regarding which packages to install, you should probably be using package lists. See <ref id="package-lists"> for more information.
-</sect1>
-
-<sect1 id="package-lists">
-<heading>Package lists</heading>
-<p>Package lists are a powerful way of expressing which packages should be installed. <tt>live-helper</tt> ships with a number of predefined package lists which provide sensible default package selections for the GNOME and KDE desktop environments, as well as standard systems.</p>
-
-<p>To specify a package list, add the name of the list to the <tt>LH_PACKAGES_LISTS</tt> variable in <file>config/chroot</file>. For example:
-
-<example>
-LH_PACKAGES_LISTS="gnome"
-</example>
-
-<p>Packages lists that a distributed with <tt>live-helper</tt> reside in view in the <tt>/usr/share/live-helper/lists</tt> directory.</p>
-
-<sect2>
-<heading>Local packages lists</heading>
-<p>You may supplement the supplied lists using local package lists stored in <tt>config/chroot_local-packageslists</tt>.</p>
-<p>Package lists that exist in this directory always override package lists distributed with <tt>live-helper</tt>. This can cause undesired effects when
-
-<sect2>
-<heading>Extending a provided package list using includes</heading>
-<p>FIXME.
-
-<example>
-#include <gnome>
-iceweasel
-</example>
-
-<p>The package lists that are included with <tt>live-helper</tt> make extensive use of includes. They are available to view in the <tt>/usr/share/live-helper/lists</tt> directory.</p>
-</sect2>
-
-<sect2>
-<heading>Using conditionals inside packages lists</heading>
-<p>FIXME
-
-<example>
-#if ARCHITECTURE amd64
-ia32-libs
-#endif
-</example>
-
-or if <tt>LH_ARCHITECTURE</tt> is set to <tt>i386</tt> or <tt>amd64</tt>:
-
-<example>
-#if ARCHITECTURE i386 amd64
-memtest86+
-#endif
-</example>
-
-or if <tt>LH_SECTIONS</tt> contains either <tt>contrib</tt> or <tt>non-free</tt>:
-
-<example>
-#if SECTIONS contrib non-free
-vrms
-#endif
-</example>
-
-A conditional may surround an <tt>#include</tt> directive:
-
-<example>
-#if ARCHITECTURE amd64
-#include <gnome-full>
-#endif
-</example>
-
-<p>Any <tt>live-helper</tt> configuration variable that begins with <tt>LH_</tt> can be tested in this way.</p>
-<p>The nesting of conditionals is not supported.</p>
-
-</sect2>
-
-</sect1>
-
-<sect1 id="tasks">
-<heading>Tasks</heading>
-<p>FIXME</p>
-</sect1>
-
-</sect>
-
-<sect id="custom-packages">
-<heading>Installing modified or third-party packages</heading>
-
-<p>Whilst it is against the philosophy of Debian Live, it may sometimes be necessary to build a Live system with modified versions of packages that are in the Debian repository. This may be to modify or support additional features, languages and branding, or even to remove elements of existing packages that are undesirable. Similarly, "third-party" packages may be used to add bespoke and/or proprietary functionality.</p>
-
-<p>This section does not cover advice regarding building or maintaining modified packages. Joachim Breitner's <url id="http://www.joachim-breitner.de/blog/archives/282-How-to-fork-privately.html" name="'How to fork privately'"> may be of interest, however. The creation of bespoke packages is covered in the <url id="http://www.debian.org/doc/maint-guide/" name="Debian New Maintainers' Guide"> and elsewhere.</p>
-
-<p>There are two ways of installing modified custom packages:
-<list>
-<item><tt>chroot_local-packages</tt></item>
-<item>Using a custom APT repository</item>
-</list>
-</p>
-
-<p>The <tt>chroot_local-packages</tt> is simpler to achieve and useful for "one-off" customisations but has a number of drawbacks, whilst using a custom APT repository is more time-consuming to setup.</p>
-
-<sect1 id="local-packages">
-<heading>Using <tt>chroot_local-packages</tt> to install custom packages</heading>
-<p>To install a custom package, simply copy it to the <tt>config/chroot_local-packages</tt> directory. Packages that are inside this directory will be automatically installed into the live system during build - you do not need to specify them elsewhere.</p>
-
-<p>Packages <strong>must</strong> be named in the prescribed way. One simple way to is to use <tt>dpkg-name</tt>. FIXME</p>
-
-<p>Using <tt>chroot_local-packages</tt> for installation of custom packages has two disadvantages:
-<list>
-<item>It is not possible to use secure APT</item>
-<item>You must install all appropriate packages in the <tt>config/chroot_local-packages</tt> directory</item>
-<item>Does not lend itself to storing Debian Live configurations in revision control</item>
-</list>
-</sect1>
-
-<sect1 id="custom-apt-repo">
-<heading>Using an APT repository to install custom packages</heading>
-<p>FIXME</p>
-<p>Unlike You must ensure that you specify the package elsewhere, see (FIXME)</p>
-<p>Whilst it may seem unnecessary effort to create an APT repository to install custom packages, the infrastructure can be easily re-used at a later date to offer updates of the modified package.</p>
-</sect1>
-
-<sect1 id="custom-packages-apt">
-<heading>Custom packages and APT</heading>
-<p><tt>live-helper</tt> uses APT to install all packages into the live system so will therefore inherit behaviours from this program. One relevant example is that (assuming a default configuration) given a package is available in two different repositories, APT will elect to install the package with a higher version number over one with the lower.</p>
-
-<p>Because of this. you may wish to increment the version number in your custom packages' <tt>debian/changelog</tt> files to ensure that your modified version is installed over one in the official Debian repositories. This may also be achieved by altering the live system's APT pinning preferences - see <ref id="apt-preferences"> for more information.</p>
-
-</sect1>
-
-<sect1 id="apt-preferences">
-<heading>Altering APT preferences during Live system</heading>
-<p>FIXME</p>
-<p>Whilst it may seem unnecessary effort to create an APT repository to install custom packages, the infrastructure can be easily re-used at a later date to offer updates of the modified package.</p>
-</sect1>
-
-</sect>
-
-
-</chapt>
diff --git a/chapters/customisation-packages.xml b/chapters/customisation-packages.xml
new file mode 100644
index 0000000..c6864a0
--- /dev/null
+++ b/chapters/customisation-packages.xml
@@ -0,0 +1,206 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="packages">
+<title>Customising package installation</title>
+
+<para>This chapter discusses the customisation of package installation. This involves:</para>
+
+<orderedlist>
+<listitem><para>Selecting additional packages to be installed</para></listitem>
+<listitem><para>Installing modified packages</para></listitem>
+</orderedlist>
+
+<section id="package-sources">
+<title>Package sources</title>
+<para>FIXME</para>
+</section>
+
+<section id="package-installation">
+<title>Package installation</title>
+<para>You can elect to use either <computeroutput>apt</computeroutput> or <computeroutput>aptitude</computeroutput> when installing packages. Which utility is used is governed by the <computeroutput>LH_APT</computeroutput> varaible in <filename>config/chroot</filename> or by the <computeroutput>--apt</computeroutput> argument to <filename>lh_config</filename>:</para>
+
+<variablelist>
+
+<varlistentry><term><computeroutput>apt</computeroutput></term>
+<listitem>
+<para>Specifying a missing package causes package installation to fail, which may not be the desired behaviour.</para>
+<para>This is the default setting for building images for Lenny or later.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry><term><computeroutput>aptitude</computeroutput></term>
+<listitem>
+<para>Specifying a missing package causes package installation to succeed, which may not be the desired behaviour.</para>
+<para>This is the default setting for building images for Etch.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</section>
+
+<section>
+<title>Installing additional packages</title>
+
+<para><filename>live-helper</filename> has a number of mechanisms for indicating that additional packages should be installed, including:</para>
+
+<orderedlist>
+<listitem><para>The <computeroutput>LH_PACKAGES</computeroutput> variable</para></listitem>
+<listitem><para>Package lists</para></listitem>
+<listitem><para>Local packages (<filename>chroot_local-packages/</filename>)</para></listitem>
+<listitem><para>Tasks</para></listitem>
+</orderedlist>
+
+<sect1 id="lh-packages">
+<title>The <computeroutput>LH_PACKAGES</computeroutput> variable</title>
+<para>To install additional packages, simply add them to the <computeroutput>LH_PACKAGES</computeroutput> variable in <filename>config/chroot</filename>. For example:</para>
+
+<screen>
+LH_PACKAGES="package1 package2 package3 ... "
+</screen>
+
+<para>You can also specify an initial values on the command line:</para>
+
+<screen>
+% lh_config --packages "package1 package2 package3"
+</screen>
+
+<para>The behaviour of <filename>live-helper</filename> when specifying a package that does not exist is determined by your choice of APT utility. See <xref linkend="package-installation"/> for more details.</para>
+
+<para>If you need to specify a large number of packages to be installed or you need flexibility regarding which packages to install, you should probably be using package lists. See <xref linkend="package-lists"/> for more information.</para>
+</sect1>
+
+<sect1 id="package-lists">
+<title>Package lists</title>
+<para>Package lists are a powerful way of expressing which packages should be installed. <filename>live-helper</filename> ships with a number of predefined package lists which provide sensible default package selections for the GNOME and KDE desktop environments, as well as standard systems.</para>
+
+<para>To specify a package list, add the name of the list to the <computeroutput>LH_PACKAGES_LISTS</computeroutput> variable in <filename>config/chroot</filename>. For example:</para>
+
+<screen>
+LH_PACKAGES_LISTS="gnome"
+</screen>
+
+<para>Packages lists that a distributed with <filename>live-helper</filename> reside in view in the <computeroutput>/usr/share/live-helper/lists</computeroutput> directory.</para>
+
+<sect2>
+<title>Local packages lists</title>
+<para>You may supplement the supplied lists using local package lists stored in <computeroutput>config/chroot_local-packageslists</computeroutput>.</para>
+<para>Package lists that exist in this directory always override package lists distributed with <filename>live-helper</filename>. This can cause undesired effects when..</para>
+
+</sect2>
+
+<sect2>
+<title>Extending a provided package list using includes</title>
+<para>FIXME.</para>
+
+<screen>
+#include <gnome>
+iceweasel
+</screen>
+
+<para>The package lists that are included with <filename>live-helper</filename> make extensive use of includes. They are available to view in the <computeroutput>/usr/share/live-helper/lists</computeroutput> directory.</para>
+</sect2>
+
+<sect2>
+<title>Using conditionals inside packages lists</title>
+<para>FIXME</para>
+
+<screen>
+#if ARCHITECTURE amd64
+ia32-libs
+#endif
+</screen>
+
+<para>or if <computeroutput>LH_ARCHITECTURE</computeroutput> is set to <computeroutput>i386</computeroutput> or <computeroutput>amd64</computeroutput>:</para>
+
+<screen>
+#if ARCHITECTURE i386 amd64
+memtest86+
+#endif
+</screen>
+
+<para>or if <computeroutput>LH_SECTIONS</computeroutput> contains either <computeroutput>contrib</computeroutput> or <computeroutput>non-free</computeroutput>:</para>
+
+<screen>
+#if SECTIONS contrib non-free
+vrms
+#endif
+</screen>
+
+<para>A conditional may surround an <computeroutput>#include</computeroutput> directive:</para>
+
+<screen>
+#if ARCHITECTURE amd64
+#include <gnome-full>
+#endif
+</screen>
+
+<para>Any <filename>live-helper</filename> configuration variable that begins with <computeroutput>LH_</computeroutput> can be tested in this way.</para>
+<para>The nesting of conditionals is not supported.</para>
+
+</sect2>
+
+</sect1>
+
+<sect1 id="tasks">
+<title>Tasks</title>
+<para>FIXME</para>
+</sect1>
+
+</section>
+
+<section id="custom-packages">
+<title>Installing modified or third-party packages</title>
+
+<para>Whilst it is against the philosophy of Debian Live, it may sometimes be necessary to build a Live system with modified versions of packages that are in the Debian repository. This may be to modify or support additional features, languages and branding, or even to remove elements of existing packages that are undesirable. Similarly, "third-party" packages may be used to add bespoke and/or proprietary functionality.</para>
+
+<para>This section does not cover advice regarding building or maintaining modified packages. Joachim Breitner's <ulink url="http://www.joachim-breitner.de/blog/archives/282-How-to-fork-privately.html">'How to fork privately'</ulink> may be of interest, however. The creation of bespoke packages is covered in the <ulink url="http://www.debian.org/doc/maint-guide/">Debian New Maintainers' Guide</ulink> and elsewhere.</para>
+
+<para>There are two ways of installing modified custom packages:</para>
+<orderedlist>
+<listitem><para><filename>chroot_local-packages</filename></para></listitem>
+<listitem><para>Using a custom APT repository</para></listitem>
+</orderedlist>
+
+<para>The <filename>chroot_local-packages</filename> is simpler to achieve and useful for "one-off" customisations but has a number of drawbacks, whilst using a custom APT repository is more time-consuming to setup.</para>
+
+<sect1 id="local-packages">
+<title>Using <filename>chroot_local-packages</filename> to install custom packages</title>
+<para>To install a custom package, simply copy it to the <computeroutput>config/chroot_local-packages</computeroutput> directory. Packages that are inside this directory will be automatically installed into the live system during build - you do not need to specify them elsewhere.</para>
+
+<para>Packages <emphasis>must</emphasis> be named in the prescribed way. One simple way to is to use <computeroutput>dpkg-name</computeroutput>. FIXME</para>
+
+<para>Using <filename>chroot_local-packages</filename> for installation of custom packages has two disadvantages:</para>
+<orderedlist>
+<listitem><para>It is not possible to use secure APT</para></listitem>
+<listitem><para>You must install all appropriate packages in the <computeroutput>config/chroot_local-packages</computeroutput> directory</para></listitem>
+<listitem><para>Does not lend itself to storing Debian Live configurations in revision control</para></listitem>
+</orderedlist>
+</sect1>
+
+<sect1 id="custom-apt-repo">
+<title>Using an APT repository to install custom packages</title>
+<para>FIXME</para>
+<para>Unlike You must ensure that you specify the package elsewhere, see (FIXME)</para>
+<para>Whilst it may seem unnecessary effort to create an APT repository to install custom packages, the infrastructure can be easily re-used at a later date to offer updates of the modified package.</para>
+</sect1>
+
+<sect1 id="custom-packages-apt">
+<title>Custom packages and APT</title>
+<para><filename>live-helper</filename> uses APT to install all packages into the live system so will therefore inherit behaviours from this program. One relevant example is that (assuming a default configuration) given a package is available in two different repositories, APT will elect to install the package with a higher version number over one with the lower.</para>
+
+<para>Because of this. you may wish to increment the version number in your custom packages' <computeroutput>debian/changelog</computeroutput> files to ensure that your modified version is installed over one in the official Debian repositories. This may also be achieved by altering the live system's APT pinning preferences - see <xref linkend="apt-preferences"/> for more information.</para>
+
+</sect1>
+
+<sect1 id="apt-preferences">
+<title>Altering APT preferences during Live system</title>
+<para>FIXME</para>
+<para>Whilst it may seem unnecessary effort to create an APT repository to install custom packages, the infrastructure can be easily re-used at a later date to offer updates of the modified package.</para>
+</sect1>
+
+</section>
+
+</chapter>
diff --git a/chapters/faq.sgml b/chapters/faq.sgml
deleted file mode 100644
index 046167a..0000000
--- a/chapters/faq.sgml
+++ /dev/null
@@ -1,4 +0,0 @@
-<chapt id="faq">
-<heading>Frequently asked questions (FAQ)</heading>
-
-</chapt>
diff --git a/chapters/faq.xml b/chapters/faq.xml
new file mode 100644
index 0000000..89585bf
--- /dev/null
+++ b/chapters/faq.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="faq">
+<title>Frequently asked questions (FAQ)</title>
+
+</chapter>
diff --git a/chapters/installation.sgml b/chapters/installation.sgml
deleted file mode 100644
index 812cf90..0000000
--- a/chapters/installation.sgml
+++ /dev/null
@@ -1,151 +0,0 @@
-<chapt id="installation">
-<heading>Installation</heading>
-
-<sect>
-<heading>Requirements</heading>
-
-<p>Building Debian Live images has very few system requirements:
-<list>
-<item>An up-to-date version of <tt>live-helper</tt></item>
-<item>A POSIX-compliant shell, such as <tt>bash</tt> or <tt>dash</tt>.</item>
-<item><tt>debootstrap</tt> or <tt>cdebootstrap</tt></item>
-<item>Linux 2.6.x</item>
-</list></p>
-</sect>
-
-<sect>
-<heading>Installing <tt>live-helper</tt></heading>
-
-<p>You may install <tt>live-helper</tt> in a number of different ways:
-<list>
-<item>From the Debian repository</item>
-<item>From source</item>
-<item>From snapshots</item>
-<item>From backports.org</item>
-</list>
-
-</p>
-
-<p>If you are using <em>lenny</em> or <em>sid</em> the recommended way is to install <tt>live-helper</tt> is via APT.</p>
-
-<sect1>
-<heading>From the Debian repository</heading>
-
-<p>
-<example>
-# apt-get install live-helper
-</example>
-
-or
-
-<example>
-# aptitude install live-helper
-</example>
-
-</sect1>
-
-<sect1>
-<heading>From source</heading>
-</sect1>
-
-<sect1>
-<heading>From 'snapshots'</heading>
-<p>If you do not wish to build or install <tt>live-helper</tt> from source, you can use snapshots. These are built automatically from the latest version in Git.</p>
-</sect1>
-
-<sect1>
-<heading>From Backports.org</heading>
-
-<p>Whilst <tt>live-helper</tt> and friends are currently not a part of Debian stable relase, they will work on <em>etch</em> as well. You will need the following programs:
-
-<list>
-<item>An <em>etch</em> backport of <tt>cdebootstrap</tt> from backports.org</item>
-<item>The <em>lenny</em> or <em>sid</em> version of <tt>live-helper</tt></item>
-</list>
-
-<sect2>
-<heading>Installing cdebootstrap from backports.org</heading>
-<p><list>
-
-<item>Put this in your /etc/apt/sources.list:
-
-<example>
-deb http://www.backports.org/debian etch-backports main
-</example></item>
-
-<item>Update the package indices
-
-<example>
-apt-get update
-</example></item>
-
-<item>Install <tt>cdebootstrap</tt>:
-
-<example>
-apt-get install -t etch-backports cdebootstrap
-</example></item>
-
-</list></p>
-</sect2>
-
-<sect2>
-<heading>Installing <tt>live-helper</tt> on etch</heading>
-
-<p>It is not recommended that you use <tt>live-helper</tt> from backports.org as it is likely to be out of date.
-
-The live-helper package from Lenny or Sid can be installed on Etch (without upgrading other packages, such as libc6; it's just shell scripts).
-
-1. install cdebootstrap from backports.org (as indicated above)
-
-apt-get install -t etch-backports cdebootstrap
-
-2. install live-helper from testing or unstable
-
-apt-get install -t unstable live-helper
-
-Of course you need the testing or unstable sources in /etc/apt/sources.list for this.</p>
-
-</sect2>
-</sect1>
-
-<sect>
-<heading><tt>live-initramfs</tt></heading>
-<p><strong>N.B. You do not need to install on your host system to create customised Debian Live systems. However, doing so will do no harm.</strong></p>
-
-<sect1>
-<heading>Using a customised <tt>live-initramfs</tt></heading>
-
-<p>To modify the code you can follow the process below. Please ensure you are familiar with the terms mentioned in <ref id="terms">.</p>
-
-<p><enumlist>
-
-<item>Checkout the <tt>live-initramfs</tt> source
-
-<example>
-$ git clone git://git.debian.org/git/users/daniel/live-initramfs.git
-</example>
-
-<item>Make changes to your local copy</item>
-
-<item>
-<p>Build a <tt>live-initramfs</tt> <tt>.deb</tt></p>
-<p>You must build either on your target distribution or in a chroot containing your target platform: this means if your target is lenny then you should build against lenny. You can use a personal builder such <tt>pbuilder</tt> to automate building packages in chroot. To build directly on the target platform, use <tt>debuild</tt> (provided by the <tt>devscripts</tt> package):</p>
-
-<p><example>
-$ cd live-initramfs
-$ debuild -us -uc -b
-</example></p>
-
-<item>
-<p>Use the generated <tt>live-initramfs</tt> <tt>.deb</tt></p>
-
-<p>As <tt>live-initramfs</tt> is installed by the build system, installing the package in the host system is not sufficient: you should treat the generated <tt>.deb</tt> like another custom package. Please see <ref id="custom-packages"> for more information. You should pay particular attention to <ref id="custom-packages-apt">.</p>
-
-</item>
-
-</enumlist></p>
-</sect1>
-
-</sect>
-
-</chapt>
diff --git a/chapters/installation.xml b/chapters/installation.xml
new file mode 100644
index 0000000..f4ef066
--- /dev/null
+++ b/chapters/installation.xml
@@ -0,0 +1,156 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="installation">
+<title>Installation</title>
+
+<section>
+<title>Requirements</title>
+
+<para>Building Debian Live images has very few system requirements:</para>
+<orderedlist>
+<listitem><para>An up-to-date version of <filename>live-helper</filename></para></listitem>
+<listitem><para>A POSIX-compliant shell, such as <computeroutput>bash</computeroutput> or <computeroutput>dash</computeroutput>.</para></listitem>
+<listitem><para><computeroutput>debootstrap</computeroutput> or <computeroutput>cdebootstrap</computeroutput></para></listitem>
+<listitem><para>Linux 2.6.x</para></listitem>
+</orderedlist>
+</section>
+
+<section>
+<title>Installing <filename>live-helper</filename></title>
+
+<para>You may install <filename>live-helper</filename> in a number of different ways:</para>
+
+<orderedlist>
+<listitem><para>From the Debian repository</para></listitem>
+<listitem><para>From source</para></listitem>
+<listitem><para>From snapshots</para></listitem>
+<listitem><para>From backports.org</para></listitem>
+</orderedlist>
+
+<para>If you are using <emphasis>lenny</emphasis> or <emphasis>sid</emphasis> the recommended way is to install <filename>live-helper</filename> is via APT.</para>
+
+<sect1>
+<title>From the Debian repository</title>
+
+<screen>
+# apt-get install live-helper
+</screen>
+
+<para>or</para>
+
+<screen>
+# aptitude install live-helper
+</screen>
+
+</sect1>
+
+<sect1>
+<title>From source</title>
+</sect1>
+
+<sect1>
+<title>From 'snapshots'</title>
+<para>If you do not wish to build or install <filename>live-helper</filename> from source, you can use snapshots. These are built automatically from the latest version in Git.</para>
+</sect1>
+
+<sect1>
+<title>From Backports.org</title>
+
+<para>Whilst <filename>live-helper</filename> and friends are currently not a part of Debian stable relase, they will work on <emphasis>etch</emphasis> as well. You will need the following programs:</para>
+
+<orderedlist>
+<listitem><para>An <emphasis>etch</emphasis> backport of <computeroutput>cdebootstrap</computeroutput> from backports.org</para></listitem>
+<listitem><para>The <emphasis>lenny</emphasis> or <emphasis>sid</emphasis> version of <filename>live-helper</filename></para></listitem>
+</orderedlist>
+
+<sect2>
+<title>Installing cdebootstrap from backports.org</title>
+<orderedlist>
+
+<listitem><para>Put this in your /etc/apt/sources.list:</para>
+
+<screen>
+deb http://www.backports.org/debian etch-backports main
+</screen></listitem>
+
+<listitem><para>Update the package indices</para>
+
+<screen>
+apt-get update
+</screen></listitem>
+
+<listitem><para>Install <computeroutput>cdebootstrap</computeroutput>:</para>
+
+<screen>
+apt-get install -t etch-backports cdebootstrap
+</screen></listitem>
+
+</orderedlist>
+</sect2>
+
+<sect2>
+<title>Installing <filename>live-helper</filename> on etch</title>
+
+<para>It is not recommended that you use <filename>live-helper</filename> from backports.org as it is likely to be out of date.
+
+The live-helper package from Lenny or Sid can be installed on Etch (without upgrading other packages, such as libc6; it's just shell scripts).
+
+1. install cdebootstrap from backports.org (as indicated above)
+
+apt-get install -t etch-backports cdebootstrap
+
+2. install live-helper from testing or unstable
+
+apt-get install -t unstable live-helper
+
+Of course you need the testing or unstable sources in /etc/apt/sources.list for this.</para>
+
+</sect2>
+</sect1>
+
+</section>
+<section>
+<title><filename>live-initramfs</filename></title>
+<para><emphasis>N.B. You do not need to install on your host system to create customised Debian Live systems. However, doing so will do no harm.</emphasis></para>
+
+<sect1>
+<title>Using a customised <filename>live-initramfs</filename></title>
+
+<para>To modify the code you can follow the process below. Please ensure you are familiar with the terms mentioned in <xref linkend="terms"/>.</para>
+
+<orderedlist>
+
+<listitem><para>Checkout the <filename>live-initramfs</filename> source</para>
+
+<screen>
+$ git clone git://git.debian.org/git/users/daniel/live-initramfs.git
+</screen>
+</listitem>
+
+<listitem><para>Make changes to your local copy</para></listitem>
+
+<listitem>
+<para>Build a <filename>live-initramfs</filename> <computeroutput>.deb</computeroutput></para>
+<para>You must build either on your target distribution or in a chroot containing your target platform: this means if your target is lenny then you should build against lenny. You can use a personal builder such <computeroutput>pbuilder</computeroutput> to automate building packages in chroot. To build directly on the target platform, use <computeroutput>debuild</computeroutput> (provided by the <computeroutput>devscripts</computeroutput> package):</para>
+
+<screen>
+$ cd live-initramfs
+$ debuild -us -uc -b
+</screen>
+</listitem>
+
+<listitem>
+<para>Use the generated <filename>live-initramfs</filename> <computeroutput>.deb</computeroutput></para>
+
+<para>As <filename>live-initramfs</filename> is installed by the build system, installing the package in the host system is not sufficient: you should treat the generated <computeroutput>.deb</computeroutput> like another custom package. Please see <xref linkend="custom-packages"/> for more information. You should pay particular attention to <xref linkend="custom-packages-apt"/>.</para>
+</listitem>
+
+</orderedlist>
+</sect1>
+
+</section>
+
+</chapter>
diff --git a/chapters/live-environment.sgml b/chapters/live-environment.sgml
deleted file mode 100644
index e104481..0000000
--- a/chapters/live-environment.sgml
+++ /dev/null
@@ -1,29 +0,0 @@
-<chapt id="live-environment">
-<heading>The Live environment</heading>
-
-<sect>
-<heading>Swap space</heading>
-<p>FIXME</p>
-</sect>
-
-<sect id="hostname">
-<heading>Hostname</heading>
-<p>FIXME</p>
-</sect>
-
-<sect id="username">
-<heading>Username</heading>
-<p>FIXME</p>
-</sect>
-
-<sect id="language">
-<heading>Language</heading>
-<p>FIXME</p>
-</sect>
-
-<sect>
-<heading>Persistence</heading>
-<p>FIXME</p>
-</sect>
-
-</chapt>
diff --git a/chapters/live-environment.xml b/chapters/live-environment.xml
new file mode 100644
index 0000000..bd290f5
--- /dev/null
+++ b/chapters/live-environment.xml
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="live-environment">
+<title>The Live environment</title>
+
+<section>
+<title>Swap space</title>
+<para>FIXME</para>
+</section>
+
+<section id="hostname">
+<title>Hostname</title>
+<para>FIXME</para>
+</section>
+
+<section id="username">
+<title>Username</title>
+<para>FIXME</para>
+</section>
+
+<section id="language">
+<title>Language</title>
+<para>FIXME</para>
+</section>
+
+<section>
+<title>Persistence</title>
+<para>FIXME</para>
+</section>
+
+</chapter>
diff --git a/chapters/meta.sgml b/chapters/meta.sgml
deleted file mode 100644
index 199de8b..0000000
--- a/chapters/meta.sgml
+++ /dev/null
@@ -1,88 +0,0 @@
-<chapt id="meta">
-<heading>About this manual</heading>
-
-<p>
-The main goal of this manul is to serve as a single access point to all documentation related to the Debian Live project. It does not include end-user documentation for using a Debian Live system.</p>
-
-<p>Some of the commands mentioned in the text must be executed with superuser privileges, either by becoming the <tt>root</tt> user or by using <tt>sudo</tt>. To distinguish between commands which may be executed by an unprivileged user and those requiring superuser privileges, commands are prepended by <tt>$</tt> or <tt>#</tt> respectively. This symbol is not a part of the command.</p>
-
-<sect id="terms">
-<heading>Terms</heading>
-
-<p><taglist>
-<tag>Live system</tag>
-<item>An operating system that can boot without installation to a hard drive. Live systems does not alter operating systems or files already installed on the computer hard drive unless instructed to do so. Live systems are typically booted from CD or DVD media as well as USB sticks and via netboot.</item>
-
-<tag>Debian Live</tag>
-<item>The Debian sub-project which maintains the <tt>live-helper</tt> and <tt>live-initramfs</tt> utilities.</item>
-
-<tag>Debian Live system</tag>
-<item>A Debian Live system is a live system that uses software from the Debian operating system.</item>
-
-<tag>Build system / host system</tag>
-<item>The environment used to create the live system.</item>
-
-<tag><tt>live-helper</tt></tag>
-<item>A collection of scripts used to build customised Debian Live systems.</item>
-
-<tag><tt>live-initramfs</tt></tag>
-<item>A collection of scripts used to boot live systems. <tt>live-initramfs</tt> is a fork of <tt>casper</tt> by Canonical, Ltd.</item>
-
-<tag><tt>live-package</tt></tag>
-<item>The former name of <tt>live-initramfs</tt>.</item>
-
-<tag>Debian Installer / (d-i)</tag>
-<item>FIXME</item>
-
-<tag>Cheat codes</tag>
-<item>FIXME</item>
-
-<tag>chroot</tag>
-<item>FIXME</item>
-
-<tag>binary image</tag>
-<item>FIXME</item>
-
-<tag>Target distribution</tag>
-<item>FIXME</item>
-
-<tag>etch/lenny/sid stable/testing/unstable</tag>
-<item>FIXME</item>
-
-</taglist>
-
-</sect>
-
-<sect id="authors">
-<heading>Authors</heading>
-<p>A list of authors (in alphabetical order):
-<list>
-<item>Ben Armstrong</item>
-<item>Brendan Sleight</item>
-<item>Chris Lamb</item>
-<item>Daniel Baumann</item>
-<item>Franklin Piat</item>
-<item>Kai Hendy</item>
-<item>Marco Amadori</item>
-<item>Mathieu Geli</item>
-<item>Matthias Kirschner</item>
-</list>
-</p>
-
-</sect>
-
-<sect id="contributing">
-<heading>Contributing to this document</heading>
-<p>This manual is intended as a community project and all proposals for improvements and contributions are extremely welcome. The preferred way to submit a contribution is to send it to the mailing list. Please see <ref id="contact"> for more information.</p>
-
-<p>When submitting a contribution please clearly identify its copyright holder and include the licensing statement. Note that to be accepted the contribution must be licensed under the same license as the rest of the document, namely GPL version 3 or later.</p>
-
-<p>The sources for this manual are maintained using the Git version control system. You can checkout the latest copy by executing:
-<example>
-% git clone git://git.debian.org/git/debian-live/live-manual.git
-</example>
-</p>
-
-</sect>
-
-</chapt>
diff --git a/chapters/meta.xml b/chapters/meta.xml
new file mode 100644
index 0000000..93f3b6f
--- /dev/null
+++ b/chapters/meta.xml
@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="meta">
+<title>About this manual</title>
+
+<para>
+The main goal of this manul is to serve as a single access point to all documentation related to the Debian Live project. It does not include end-user documentation for using a Debian Live system.</para>
+
+<para>Some of the commands mentioned in the text must be executed with superuser privileges, either by becoming the the rootuser or by using <filename>sudo</filename>. To distinguish between commands which may be executed by an unprivileged user and those requiring superuser privileges, commands are prepended by <computeroutput>$</computeroutput> or <computeroutput>#</computeroutput> respectively. This symbol is not a part of the command.</para>
+
+<section id="terms">
+<title>Terms</title>
+
+<variablelist>
+<varlistentry><term>Live system</term>
+<listitem><para>An operating system that can boot without installation to a hard drive. Live systems does not alter operating systems or files already installed on the computer hard drive unless instructed to do so. Live systems are typically booted from CD or DVD media as well as USB sticks and via netboot.</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Debian Live</term>
+<listitem><para>The Debian sub-project which maintains the <filename>live-helper</filename> and <filename>live-initramfs</filename> utilities.</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Debian Live system</term>
+<listitem><para>A Debian Live system is a live system that uses software from the Debian operating system.</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Build system / host system</term>
+<listitem><para>The environment used to create the live system.</para></listitem>
+</varlistentry>
+
+<varlistentry><term><filename>live-helper</filename></term>
+<listitem><para>A collection of scripts used to build customised Debian Live systems.</para></listitem>
+</varlistentry>
+
+<varlistentry><term><filename>live-initramfs</filename></term>
+<listitem><para>A collection of scripts used to boot live systems. <filename>live-initramfs</filename> is a fork of <filename>casper</filename> by Canonical, Ltd.</para></listitem>
+</varlistentry>
+
+<varlistentry><term><filename>live-package</filename></term>
+<listitem><para>The former name of <filename>live-initramfs</filename>.</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Debian Installer / (d-i)</term>
+<listitem><para>FIXME</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Cheat codes</term>
+<listitem><para>FIXME</para></listitem>
+</varlistentry>
+
+<varlistentry><term>chroot</term>
+<listitem><para>FIXME</para></listitem>
+</varlistentry>
+
+<varlistentry><term>binary image</term>
+<listitem><para>FIXME</para></listitem>
+</varlistentry>
+
+<varlistentry><term>Target distribution</term>
+<listitem><para>FIXME</para></listitem>
+</varlistentry>
+
+<varlistentry><term>etch/lenny/sid stable/testing/unstable</term>
+<listitem><para>FIXME</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</section>
+
+<section id="authors">
+<title>Authors</title>
+<para>A list of authors (in alphabetical order):</para>
+
+<itemizedlist>
+ <listitem><para>Ben Armstrong</para></listitem>
+ <listitem><para>Brendan Sleight</para></listitem>
+ <listitem><para>Chris Lamb</para></listitem>
+ <listitem><para>Daniel Baumann</para></listitem>
+ <listitem><para>Franklin Piat</para></listitem>
+ <listitem><para>Kai Hendy</para></listitem>
+ <listitem><para>Marco Amadori</para></listitem>
+ <listitem><para>Mathieu Geli</para></listitem>
+ <listitem><para>Matthias Kirschner</para></listitem>
+</itemizedlist>
+
+</section>
+
+<section id="contributing">
+<title>Contributing to this document</title>
+<para>This manual is intended as a community project and all proposals for improvements and contributions are extremely welcome. The preferred way to submit a contribution is to send it to the mailing list. Please see <xref linkend="contact"/> for more information.</para>
+
+<para>When submitting a contribution please clearly identify its copyright holder and include the licensing statement. Note that to be accepted the contribution must be licensed under the same license as the rest of the document, namely GPL version 3 or later.</para>
+
+<para>The sources for this manual are maintained using the Git version control system. You can checkout the latest copy by executing:</para>
+
+<screen>
+% git clone git://git.debian.org/git/debian-live/live-manual.git
+</screen>
+
+</section>
+
+</chapter>
diff --git a/chapters/overview.sgml b/chapters/overview.sgml
deleted file mode 100644
index fed8352..0000000
--- a/chapters/overview.sgml
+++ /dev/null
@@ -1,124 +0,0 @@
-<chapt id="overview">
-<heading>Overview of tools</heading>
-
-<p>This chapter contains an overview of the two main tools used in building Debian Live systems.</p>
-
-<sect id="live-helper">
-<heading><tt>live-helper</tt></heading>
-<p><tt>live-helper</tt> is a collection of scripts that build Debian Live systems.</p>
-
-<p>The idea behind live-helper is a framework that uses a configuration directory to completely automate and customize all aspects of building a Live image.</p>
-
-<p>Many concepts are similar with the <tt>debhelper</tt> Debian package tools written by Joey Hess:
-
-<list>
-<item>
-<p>The scripts have a central location for configuring their operation.</p>
-<p>In <tt>debhelper</tt>, this is the <file>debian/</file> subdirectory of a package tree. For example, <tt>dh_install</tt> will look for file called <file>debian/<packagename>.install</file> to determine which files should exist in a particular binary package. In much the same way, <tt>live-helper</tt> stores its configuration entirely under a <file>config/</file> subdirectory.</p>
-
-</item>
-<item>The scripts are indepodent - that is to say, it is always safe to run each command.</item>
-</list>
-</p>
-
-<p>Unlike <tt>debhelper</tt>, <tt>live-helper</tt> contains a tool to generate a skeleton configuration directory, <tt>lh_config</tt>. This could be considered to be similar to tools such as <tt>dh-make</tt>. For more information about <tt>lh_config</tt>, please see <ref id="lh_config">.</p>
-
-<p>Besides the common <file>config/common</file>, which is used by all <tt>live-helper</tt> commands, some additional files can be used to configure the behavior of specific helpers. These files are typically named <tt>config/foo</tt> or <tt>config/stage</tt> (where "stage", of course, is replaced with the name of the stage that they belong to, and "helper" with the name of the helper).</p>
-
-<p>For example, <tt>lh_bootstrap_debootstrap</tt> uses files named <file>config/bootstrap</file> and <file>config/bootstrap_debootstrap</file> to read the options it will use. Generally, these files contain variables with values assigned, one variable per line. Some programs in <tt>live-helper</tt> use pairs of values or slightly more complicated variable assignments.</p>
-
-<p><tt>live-helper</tt> respects environment variables which are present in the context of the shell it is running. If variables can be read from config files, then they override environment variables, and if command line options are used, they override values from config files. If no value for a given variable can be found (and is thus unset), <tt>live-helper</tt> will automatically set it to a default value.</p>
-
-<p>All config files are shell scripts which are sourced by a live-helper program. That means they have to follow the normal shell syntax. You can also put comments in these files; lines beginning with "#" are ignored.</p>
-
-<p>In some rare cases, you may want to have different versions of these files for different architectures or distributions. If files named <tt>config/stage.arch</tt> or <tt>config/stage_helper.arch</tt>, and <tt>config/stage.dist</tt> or <tt>config/stage_helper.dist</tt> exist (where "arch" is the same as the output of <tt>dpkg --print-architecture</tt> and "dist" is the same as the codename of the target distribution), then they will be used in preference to the other, more general files.</p>
-
-<p>Please see <ref id="installation"> for information on how to install <tt>live-helper</tt>.
-
-<p>The remainder of this section discusses the three most important helpers:
-<taglist>
-<tag><tt>lh_config</tt></tag>
-<item>Responsible for initialising a Live system configuration directory. See <ref id="lh_config"> for more information.</item>
-
-<tag><tt>lh_build</tt></tag>
-<item>Responsible for starting a Live system build. See <ref id="lh_build"> for more information.</item>
-
-<tag><tt>lh_clean</tt></tag>
-<item>Responsible for removing parts of a Live system build. <ref id="lh_clean"> for more information.</item>
-</taglist>
-</p>
-
-<sect1 id="lh_config">
-<heading>The <tt>lh_config</tt> helper</heading>
-<p>As discussed in <ref id="live-helper">, the scripts that make up <tt>live-helper</tt> source their configuration from a single directory named <tt>config/</tt>. As constructing this directory by hand would be time-consuming and error-prone, the <tt>lh_config</tt> helper can be used to create skeleton configuration folders.</p>
-
-<p>Issuing <tt>lh_config</tt> without any arguments creates a <tt>config</tt> subdirectory which it populates with some default settings:
-<example>
-% lh_config
-% ls -l
-total 4.1k
-drwxr-xr-x 19 user group 4.1k 2008-05-09 21:37 config
-% ls -l config/
-total 91k
--rw-r--r-- 1 user group 4.0k 2008-05-09 21:37 binary
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_debian-installer
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_grub
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_local-debs
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_local-hooks
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_local-includes
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_local-packageslists
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_local-udebs
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_rootfs
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_syslinux
--rw-r--r-- 1 user group 1.7k 2008-05-09 21:37 bootstrap
--rw-r--r-- 1 user group 1.5k 2008-05-09 21:37 chroot
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_apt
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_local-hooks
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_local-includes
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_local-packages
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_local-packageslists
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_sources
--rw-r--r-- 1 user group 2.9k 2008-05-09 21:37 common
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 includes
--rw-r--r-- 1 user group 212 2008-05-09 21:37 source
-drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 templates
-</example>
-</p>
-
-<p>Using <tt>lh_config</tt> without any arguments would be suitable for users who are either happy editing the generated files, or are simply happy with the defaults it creates.</p>
-
-<p>You can ask <tt>lh_config</tt> to generate <file>config/</file> directory "preseeded" with various options. This might be suitable if you do not require the default settings but do not need to change a large number of options. For example:
-
-<example>
-% lh_config -p gnome
-</example>
-
-will build a <file>config/</file> directory configured to include the '<tt>gnome</tt>' package list. It is possible to specify many options:
-
-<example>
-% lh_config --apt aptitude --binary-images net --hostname live-machine --username live-user ...
-</example>
-</p>
-
-<p>A full list of options is available FIXME. Most options have a parallel with an "<tt>LH_</tt>" prefixed variable.</p>
-
-</sect1>
-
-<sect1 id="lh_build">
-<heading>The <tt>lh_build</tt> helper</heading>
-<p>FIXME</p>
-</sect1>
-
-<sect1 id="lh_clean">
-<heading>The <tt>lh_clean</tt> helpe/heading>
-<p>It is the job of the <tt>lh_clean</tt> helper to remove various parts of a Live helper build.</p>
-</sect1>
-</sect>
-
-<sect id="live-initramfs">
-<heading>The <tt>live-initramfs</tt> package</heading>
-<p><tt>live-initramfs</tt> is a collection of scripts.</p>
-<p>FIXME link to Kernel Handbook</p>
-</sect>
-
-</chapt>
diff --git a/chapters/overview.xml b/chapters/overview.xml
new file mode 100644
index 0000000..173f64e
--- /dev/null
+++ b/chapters/overview.xml
@@ -0,0 +1,130 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="overview">
+<title>Overview of tools</title>
+
+<para>This chapter contains an overview of the two main tools used in building Debian Live systems.</para>
+
+<section id="live-helper">
+<title><filename>live-helper</filename></title>
+<para><filename>live-helper</filename> is a collection of scripts that build Debian Live systems.</para>
+
+<para>The idea behind live-helper is a framework that uses a configuration directory to completely automate and customize all aspects of building a Live image.</para>
+
+<para>Many concepts are similar with the <computeroutput>debhelper</computeroutput> Debian package tools written by Joey Hess:</para>
+
+<orderedlist>
+<listitem>
+<para>The scripts have a central location for configuring their operation.</para>
+<para>In <computeroutput>debhelper</computeroutput>, this is the <filename class="directory">debian</filename> subdirectory of a package tree. For example, <computeroutput>dh_install</computeroutput> will look for file called <filename>debian/<packagename>.install</filename> to determine which files should exist in a particular binary package. In much the same way, <filename>live-helper</filename> stores its configuration entirely under a <filename class="directory">config/</filename> subdirectory.</para>
+</listitem>
+
+<listitem><para>The scripts are indepodent - that is to say, it is always safe to run each command.</para></listitem>
+
+</orderedlist>
+
+<para>Unlike <computeroutput>debhelper</computeroutput>, <filename>live-helper</filename> contains a tool to generate a skeleton configuration directory, <filename>lh_config</filename>. This could be considered to be similar to tools such as <computeroutput>dh-make</computeroutput>. For more information about <filename>lh_config</filename>, please see <xref linkend="lh_config"/>.</para>
+
+<para>Besides the common <filename>config/common</filename>, which is used by all <filename>live-helper</filename> commands, some additional files can be used to configure the behavior of specific helpers. These files are typically named <computeroutput>config/foo</computeroutput> or <computeroutput>config/stage</computeroutput> (where "stage", of course, is replaced with the name of the stage that they belong to, and "helper" with the name of the helper).</para>
+
+<para>For example, <computeroutput>lh_bootstrap_debootstrap</computeroutput> uses files named <filename>config/bootstrap</filename> and <filename>config/bootstrap_debootstrap</filename> to read the options it will use. Generally, these files contain variables with values assigned, one variable per line. Some programs in <filename>live-helper</filename> use pairs of values or slightly more complicated variable assignments.</para>
+
+<para><filename>live-helper</filename> respects environment variables which are present in the context of the shell it is running. If variables can be read from config files, then they override environment variables, and if command line options are used, they override values from config files. If no value for a given variable can be found (and is thus unset), <filename>live-helper</filename> will automatically set it to a default value.</para>
+
+<para>All config files are shell scripts which are sourced by a live-helper program. That means they have to follow the normal shell syntax. You can also put comments in these files; lines beginning with "#" are ignored.</para>
+
+<para>In some rare cases, you may want to have different versions of these files for different architectures or distributions. If files named <computeroutput>config/stage.arch</computeroutput> or <computeroutput>config/stage_helper.arch</computeroutput>, and <computeroutput>config/stage.dist</computeroutput> or <computeroutput>config/stage_helper.dist</computeroutput> exist (where "arch" is the same as the output of <computeroutput>dpkg --print-architecture</computeroutput> and "dist" is the same as the codename of the target distribution), then they will be used in preference to the other, more general files.</para>
+
+<para>Please see <xref linkend="installation"/> for information on how to install <filename>live-helper</filename>.
+
+<para>The remainder of this section discusses the three most important helpers:</para>
+<variablelist>
+<varlistentry><term><filename>lh_config</filename></term>
+<listitem><para>Responsible for initialising a Live system configuration directory. See <xref linkend="lh_config"/> for more information.</para></listitem>
+</varlistentry>
+
+<varlistentry><term><filename>lh_build</filename></term>
+<listitem><para>Responsible for starting a Live system build. See <xref linkend="lh_build"/> for more information.</para></listitem>
+</varlistentry>
+
+<varlistentry><term><filename>lh_clean</filename></term>
+<listitem><para>Responsible for removing parts of a Live system build. <xref linkend="lh_clean"/> for more information.</para></listitem>
+</varlistentry>
+</variablelist>
+</para>
+
+<sect1 id="lh_config">
+<title>The <filename>lh_config</filename> helper</title>
+<para>As discussed in <xref linkend="live-helper"/>, the scripts that make up <filename>live-helper</filename> source their configuration from a single directory named <computeroutput>config/</computeroutput>. As constructing this directory by hand would be time-consuming and error-prone, the <filename>lh_config</filename> helper can be used to create skeleton configuration folders.</para>
+
+<para>Issuing <filename>lh_config</filename> without any arguments creates a <computeroutput>config</computeroutput> subdirectory which it populates with some default settings:</para>
+<screen>
+% lh_config
+% ls -l
+total 4.1k
+drwxr-xr-x 19 user group 4.1k 2008-05-09 21:37 config
+% ls -l config/
+total 91k
+-rw-r--r-- 1 user group 4.0k 2008-05-09 21:37 binary
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_debian-installer
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_grub
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_local-debs
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_local-hooks
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_local-includes
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_local-packageslists
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_local-udebs
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_rootfs
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 binary_syslinux
+-rw-r--r-- 1 user group 1.7k 2008-05-09 21:37 bootstrap
+-rw-r--r-- 1 user group 1.5k 2008-05-09 21:37 chroot
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_apt
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_local-hooks
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_local-includes
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_local-packages
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_local-packageslists
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 chroot_sources
+-rw-r--r-- 1 user group 2.9k 2008-05-09 21:37 common
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 includes
+-rw-r--r-- 1 user group 212 2008-05-09 21:37 source
+drwxr-xr-x 2 user group 4.1k 2008-05-09 21:37 templates
+</screen>
+
+<para>Using <filename>lh_config</filename> without any arguments would be suitable for users who are either happy editing the generated files, or are simply happy with the defaults it creates.</para>
+
+<para>You can ask <filename>lh_config</filename> to generate <filename class="directory">config/</filename> directory "preseeded" with various options. This might be suitable if you do not require the default settings but do not need to change a large number of options. For example:</para>
+
+<screen>
+% lh_config -p gnome
+</screen>
+
+<para>will build a <filename class="directory">config/</filename> directory configured to include the '<computeroutput>gnome</computeroutput>' package list. It is possible to specify many options:</para>
+
+<screen>
+% lh_config --apt aptitude --binary-images net --hostname live-machine --username live-user ...
+</screen>
+
+<para>A full list of options is available FIXME. Most options have a parallel with an "<computeroutput>LH_</computeroutput>" prefixed variable.</para>
+
+</sect1>
+
+<sect1 id="lh_build">
+<title>The <filename>lh_build</filename> helper</title>
+<para>FIXME</para>
+</sect1>
+
+<sect1 id="lh_clean">
+<title>The <filename>lh_clean</filename> helper</title>
+<para>It is the job of the <filename>lh_clean</filename> helper to remove various parts of a Live helper build.</para>
+</sect1>
+</section>
+
+<section id="live-initramfs">
+<title>The <filename>live-initramfs</filename> package</title>
+<para><filename>live-initramfs</filename> is a collection of scripts.</para>
+<para>FIXME link to Kernel Handbook</para>
+</section>
+
+</chapter>
diff --git a/chapters/reporting-bugs.sgml b/chapters/reporting-bugs.sgml
deleted file mode 100644
index e64d33a..0000000
--- a/chapters/reporting-bugs.sgml
+++ /dev/null
@@ -1,71 +0,0 @@
-<chapt id="bugs">
-<heading>Reporting bugs</heading>
-
-<p>Debian Live is far from being perfect, but we want to make it as close as possible to perfect - with your help. Do not hesitate to report a bug: it is better to fill a report twice than never. However, here are some recommendations how to file good bug reports:</p>
-
-<sect id="up-to-date">
-<heading>Use up-to-date packages</heading>
-<p>This means</p>
-
-<p>Using outdated packages can cause significant problems when trying to reproduce (and ultimately fix) your problem. If a relevant package is not available in Debian anymore, please recognize that the resources of the Debian kernel team are limited and will be unlikely to be able to fix the problem.</p>
-</sect>
-
-
-<sect id="collect-information">
-<heading>Collect information</heading>
-
-<p>Please provide enough information with your report. At a minimum, it should contain the exact version of live-helper version where the bug is encountered, and steps to reproduce it. Please use common sense and include other relevant information if you think that it might help in solving the problem.</p>
-</sect>
-
-<sect id="correct-package">
-<heading>Use the correct package to report the bug against</heading>
-
-<p>Where does the bug appear?</p>
-
-<p>
-<taglist>
-
-<tag>At build time whilst bootstrapping</tag>
-
-<item>
-<p><tt>live-helper</tt> first bootstraps a basic Debian system with <tt>debootstrap</tt> or <tt>cdebootstrap</tt>. Depending on the bootstrapping tool used and the Debian distribution it is bootstrapping, it may fail. If a bug appears here, check if the error is related to a specific Debian package (most likely), or if it is related to cdebootstrap itself.</p>
-
-<p>In both cases, this is not a bug in Debian Live, but rather in Debian itself which we can not fix this directly. Please report such a bug against <tt>debootstrap</tt>, <tt>cdebootstrap</tt> or the failing package.</p>
-</item>
-
-<tag>At build time whilst installing packages</tag>
-
-<item><p><tt>live-helper</tt> installs additional packages from the Debian archive and depending on the Debian distribution used and the daily archive state, it can fail. If a bug appears here, check if the error is also reproducible on a normal system.</p>
-
-<p>If this is the case, this is not a bug in Debian Live, but rather in Debian. Report it against the failing package.</p></item>
-
-<tag>At run-time</tag>
-
-<item>If a package was successfully installed, but fails while actually running the Live system, this is probably a bug in Debian Live. However, </item>
-
-</taglist>
-</p>
-
-</sect>
-
-<sect id="research">
-<heading>Do the research</heading>
-<p>Before filing the bug, please search the web for the particular error message or symptom you are getting. As it is highly unlikely that you are the only person experiencing a particular problem, there is always a chance that it has been discussed elsewhere, and a possible solution, patch, or workaround has been proposed.</p>
-
-<p>You should pay particular attention to the Debian Live mailing list, as well as the homepage, as these are likely to contain the most up-to-date information. If such information exists, always include the references to it in your bug report.</p>
-
-<p>In addition, you should check the <url id="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-helper" name="current bug list for live-helper"> and the <url id="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-initramfs" name="current bug list for live-initramfs"> to see whether something similar has been reported already.</p>
-</sect>
-
-<sect id="where">
-<heading>Where to report bugs</heading>
-
-<p>The Debian Live project keeps track of all bugs in the Debian Bug Tracking System (BTS). For information on how to use the system, please see <url id="http://bugs.debian.org" name="http://bugs.debian.org">. You can also submit the bugs by using the <tt>reportbug</tt> command from the package with the same name.</p>
-
-<p>In general, you should report build time errors against the <tt><url id="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-helper" name="live-helper"></tt> package and run time errors against <tt><url id="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-helper" name="live-initramfs"></tt>. If you are unsure of which package is appropriate or need more help before submitting a bug report, please send a message to the mailing list and we will help you to figure it out.</p>
-
-<p>Please note that bugs found in distributions derived from Debian (such as Ubuntu, Knoppix, Xandros, etc.) should <em>not</em> be reported to the Debian BTS unless they can be also reproduced on a Debian system using official Debian packages.</p>
-
-</sect>
-
-</chapt>
diff --git a/chapters/reporting-bugs.xml b/chapters/reporting-bugs.xml
new file mode 100644
index 0000000..1eabbe3
--- /dev/null
+++ b/chapters/reporting-bugs.xml
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="bugs">
+<title>Reporting bugs</title>
+
+<para>Debian Live is far from being perfect, but we want to make it as close as possible to perfect - with your help. Do not hesitate to report a bug: it is better to fill a report twice than never. However, here are some recommendations how to file good bug reports:</para>
+
+<section id="up-to-date">
+<title>Use up-to-date packages</title>
+<para>This means</para>
+
+<para>Using outdated packages can cause significant problems when trying to reproduce (and ultimately fix) your problem. If a relevant package is not available in Debian anymore, please recognize that the resources of the Debian kernel team are limited and will be unlikely to be able to fix the problem.</para>
+</section>
+
+
+<section id="collect-information">
+<title>Collect information</title>
+
+<para>Please provide enough information with your report. At a minimum, it should contain the exact version of live-helper version where the bug is encountered, and steps to reproduce it. Please use common sense and include other relevant information if you think that it might help in solving the problem.</para>
+</section>
+
+<section id="correct-package">
+<title>Use the correct package to report the bug against</title>
+
+<para>Where does the bug appear?</para>
+
+<para>
+<variablelist>
+
+<varlistentry><term>At build time whilst bootstrapping</term>
+
+<listitem><para>
+<para><filename>live-helper</filename> first bootstraps a basic Debian system with <computeroutput>debootstrap</computeroutput> or <computeroutput>cdebootstrap</computeroutput>. Depending on the bootstrapping tool used and the Debian distribution it is bootstrapping, it may fail. If a bug appears here, check if the error is related to a specific Debian package (most likely), or if it is related to cdebootstrap itself.</para>
+
+<para>In both cases, this is not a bug in Debian Live, but rather in Debian itself which we can not fix this directly. Please report such a bug against <computeroutput>debootstrap</computeroutput>, <computeroutput>cdebootstrap</computeroutput> or the failing package.</para>
+</para></listitem>
+</varlistentry>
+
+<varlistentry><term>At build time whilst installing packages</term>
+
+<listitem><para><filename>live-helper</filename> installs additional packages from the Debian archive and depending on the Debian distribution used and the daily archive state, it can fail. If a bug appears here, check if the error is also reproducible on a normal system.</para>
+
+<para>If this is the case, this is not a bug in Debian Live, but rather in Debian. Report it against the failing package.</para></listitem>
+</varlistentry>
+
+<varlistentry><term>At run-time</term>
+
+<listitem><para>If a package was successfully installed, but fails while actually running the Live system, this is probably a bug in Debian Live. However, </para></listitem>
+</varlistentry>
+
+</variablelist>
+</para>
+
+</section>
+
+<section id="research">
+<title>Do the research</title>
+<para>Before filing the bug, please search the web for the particular error message or symptom you are getting. As it is highly unlikely that you are the only person experiencing a particular problem, there is always a chance that it has been discussed elsewhere, and a possible solution, patch, or workaround has been proposed.</para>
+
+<para>You should pay particular attention to the Debian Live mailing list, as well as the homepage, as these are likely to contain the most up-to-date information. If such information exists, always include the references to it in your bug report.</para>
+
+<para>In addition, you should check the <ulink url="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-helper">current bug list for live-helper</ulink> and the <ulink url="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-initramfs">current bug list for live-initramfs</ulink> to see whether something similar has been reported already.</para>
+</section>
+
+<section id="where">
+<title>Where to report bugs</title>
+
+<para>The Debian Live project keeps track of all bugs in the Debian Bug Tracking System (BTS). For information on how to use the system, please see <ulink url="http://bugs.debian.org">http://bugs.debian.org</ulink>. You can also submit the bugs by using the <computeroutput>reportbug</computeroutput> command from the package with the same name.</para>
+
+<para>In general, you should report build time errors against the <ulink url="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-helper">live-helper</ulink> package and run time errors against <ulink url="http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=live-helper">live-initramfs</ulink>. If you are unsure of which package is appropriate or need more help before submitting a bug report, please send a message to the mailing list and we will help you to figure it out.</para>
+
+<para>Please note that bugs found in distributions derived from Debian (such as Ubuntu, Knoppix, Xandros, etc.) should <emphasis>not</emphasis> be reported to the Debian BTS unless they can be also reproduced on a Debian system using official Debian packages.</para>
+
+</section>
+
+</chapter>
diff --git a/chapters/resources.sgml b/chapters/resources.sgml
deleted file mode 100644
index 9eef2cc..0000000
--- a/chapters/resources.sgml
+++ /dev/null
@@ -1,33 +0,0 @@
-<chapt id="resources">
-<heading>Resources and links</heading>
-
-<sect>
-<heading>Links</heading>
-<p>FIXME</p>
-
-<p><list>
-<item><url id="http://www.debian.org/" name="Debian homepage"></item>
-</list></p>
-
-</sect>
-
-<sect>
-<heading>Who is using Debian Live?</heading>
-
-<p>A number of projects are using Debian Live:
-
-<list>
-<item><url id="http://pkg-kde.alioth.debian.org/kde4livecd.html" name="Debian KDE4 livecd"></item>
-<item><url id="http://www.gnewsense.org/" name="gNewSense"> "forked" a very early live-package</item>
-<item><url id="http://livecd.gnustep.org/" name ="GNUSTEP Live CD"> using live-package</item>
-<item><url id="http://www.keshi.org/moin/moin.cgi/PS3/Debian/Live" name="PlayStation 3 Live CD"> using live-package</item>
-<item><url id="http://www.sidux.org/" name="Sidux Live CD"> "forked" an early live-package</item>
-<item><url id="http://vamosproject.org" name="Vamos"></item>
-<item><url id="http://clonezilla.sourceforge.net/" name="Clonezilla"> (system image distributer)</item>
-<item><url id="http://www.webconverger.com/" name="Webconverger"></item>
-<item><url id="http://updates.xorcom.com/iso/" name="Xorcom Rapid live cd"> - Asterisk-based live CD</item>
-<item>IES S'Arenal, Llucmajor (Secondary school located near to Palma de Mallorca), Spain.</item>
-</list>
-
-</sect>
-</chapt>
diff --git a/chapters/resources.xml b/chapters/resources.xml
new file mode 100644
index 0000000..8086515
--- /dev/null
+++ b/chapters/resources.xml
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "../ent/common.ent" > %commondata;
+]>
+<chapter id="resources">
+<title>Resources and links</title>
+
+<section>
+<title>Links</title>
+<para>FIXME</para>
+
+<orderedlist>
+<listitem><para><ulink url="http://www.debian.org/">Debian homepage</ulink></para></listitem>
+</orderedlist>
+
+</section>
+
+<section>
+<title>Who is using Debian Live?</title>
+
+<para>A number of projects are using Debian Live:</para>
+
+<itemizedlist>
+<listitem><para><ulink url="http://pkg-kde.alioth.debian.org/kde4livecd.html">Debian KDE4 livecd</ulink></para></listitem>
+<listitem><para><ulink url="http://www.gnewsense.org/">gNewSense</ulink> "forked" a very early live-package</para></listitem>
+<listitem><para><ulink url="http://livecd.gnustep.org/">GNUSTEP Live CD</ulink> using live-package</para></listitem>
+<listitem><para><ulink url="http://www.keshi.org/moin/moin.cgi/PS3/Debian/Live">PlayStation 3 Live CD</ulink> using live-package</para></listitem>
+<listitem><para><ulink url="http://www.sidux.org/">Sidux Live CD</ulink> "forked" an early live-package</para></listitem>
+<listitem><para><ulink url="http://vamosproject.org">Vamos</ulink></para></listitem>
+<listitem><para><ulink url="http://clonezilla.sourceforge.net/">Clonezilla</ulink> (system image distributer)</para></listitem>
+<listitem><para><ulink url="http://www.webconverger.com/">Webconverger</ulink></para></listitem>
+<listitem><para><ulink url="http://updates.xorcom.com/iso/">Xorcom Rapid live cd</ulink> - Asterisk-based live CD</para></listitem>
+<listitem><para>IES S'Arenal, Llucmajor (Secondary school located near to Palma de Mallorca), Spain.</para></listitem>
+</itemizedlist>
+
+</section>
+</chapter>
diff --git a/common-tasks.html b/common-tasks.html
new file mode 100644
index 0000000..e9de66c
--- /dev/null
+++ b/common-tasks.html
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 10. Common tasks</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="Debian Live Manual" /><link rel="up" href="index.html" title="Debian Live Manual" /><link rel="prev" href="binary.html" title="Chapter 9. Customising the binary image" /><link rel="next" href="live-environment.html" title="Chapter 11. The Live environment" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 10. Common tasks</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="binary.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="live-environment.html">Next</a></td></tr></table><hr /></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="common-tasks"></a>Chapter 10. Common tasks</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="common-tasks.html#debian-installer">10.1. The Debian Installer</a></span></dt></dl></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="debian-installer"></a>10.1. The Debian Installer</h2></div></div></div><p>FIXME.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="binary.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="live-environment.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 9. Customising the binary image </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 11. The Live environment</td></tr></table></div></body></html>
diff --git a/configuration-files.html b/configuration-files.html
new file mode 100644
index 0000000..9f15d57
--- /dev/null
+++ b/configuration-files.html
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Appendix B. Configuration files</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="Debian Live Manual" /><link rel="up" href="index.html" title="Debian Live Manual" /><link rel="prev" href="configuration-layout.html" title="Appendix A. Configuration layout" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix B. Configuration files</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="configuration-layout.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> </td></tr></table><hr /></div><div class="appendix" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="configuration-files"></a>Appendix B. Configuration files</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="configuration-files.html#config-binary">B.1. The <code class="filename">config/binary</code> file</a></span></dt><dt><span class="section"><a href="configuration-files.html#config-bootstrap">B.2. The <code class="filename">config/bootstrap</code> file</a></span></dt><dt><span class="section"><a href="configuration-files.html#config-chroot">B.3. The <code class="filename">config/chroot</code> file</a></span></dt><dt><span class="section"><a href="configuration-files.html#config-common">B.4. The <code class="filename">config/common</code> file</a></span></dt><dt><span class="section"><a href="configuration-files.html#config-source">B.5. The <code class="filename">config/source</code> file</a></span></dt></dl></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="config-binary"></a>B.1. The <code class="filename">config/binary</code> file</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">LH_BINARY_FILESYSTEM</span></dt><dd><p>Set image filesystem. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_BINARY_IMAGES</span></dt><dd><p>Set image type. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_BINARY_INDICES</span></dt><dd><p>Set apt/aptitude generic indices. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_BOOTAPPEND_LIVE</span></dt><dd><p>Set boot parameters. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_BOOTAPPEND_INSTALL</span></dt><dd><p>Set boot parameters. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_BOOTLOADER</span></dt><dd><p>Set bootloader. (See <a class="xref" href="bootup.html#bootloaders" title="8.2. Bootloaders">Section 8.2, “Bootloaders”</a>)</p></dd><dt><span class="term">LH_CHECKSUMS</span></dt><dd><p>Set checksums. (See <a class="xref" href="bootup.html#cheat-codes" title="8.6. Cheat codes">Section 8.6, “Cheat codes”</a>)</p></dd><dt><span class="term">LH_CHROOT_BUILD</span></dt><dd><p>Control if we build binary images chrooted. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_DEBIAN_INSTALLER</span></dt><dd><p>Set debian-installer. (See <a class="xref" href="common-tasks.html#debian-installer" title="10.1. The Debian Installer">Section 10.1, “The Debian Installer”</a>)</p></dd><dt><span class="term">LH_DEBIAN_INSTALLER_DAILY</span></dt><dd><p>Set daily images. (See <a class="xref" href="common-tasks.html#debian-installer" title="10.1. The Debian Installer">Section 10.1, “The Debian Installer”</a>)</p></dd><dt><span class="term">LH_ENCRYPTION</span></dt><dd><p>Set encrytion. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_GRUB_SPLASH</span></dt><dd><p>Set custom grub splash. (See <a class="xref" href="bootup.html#splash" title="8.3. Splash screens">Section 8.3, “Splash screens”</a>)</p></dd><dt><span class="term">LH_HOSTNAME</span></dt><dd><p>Set hostname. (See <a class="xref" href="live-environment.html#hostname" title="11.2. Hostname">Section 11.2, “Hostname”</a>)</p></dd><dt><span class="term">LH_ISO_APPLICATION</span></dt><dd><p>Set iso author. (See <a class="xref" href="binary.html#iso-metadata" title="9.2. ISO metadata">Section 9.2, “ISO metadata”</a>)</p></dd><dt><span class="term">LH_ISO_PREPARER</span></dt><dd><p>Set iso preparer. (See <a class="xref" href="binary.html#iso-metadata" title="9.2. ISO metadata">Section 9.2, “ISO metadata”</a>)</p></dd><dt><span class="term">LH_ISO_PUBLISHER</span></dt><dd><p>Set iso publisher. (See <a class="xref" href="binary.html#iso-metadata" title="9.2. ISO metadata">Section 9.2, “ISO metadata”</a>)</p></dd><dt><span class="term">LH_ISO_VOLUME</span></dt><dd><p>Set iso volume (max 32 chars). (See <a class="xref" href="binary.html#iso-metadata" title="9.2. ISO metadata">Section 9.2, “ISO metadata”</a>)</p></dd><dt><span class="term">LH_JFFS2_ERASEBLOCK</span></dt><dd><p>Set jffs2 eraseblock size. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_MEMTEST</span></dt><dd><p>Set memtest. (See <a class="xref" href="bootup.html#memtest" title="8.4. Memtest">Section 8.4, “Memtest”</a>)</p></dd><dt><span class="term">LH_NET_ROOT_FILESYSTEM</span></dt><dd><p>Set netboot filesystem. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_NET_ROOT_MOUNTOPTIONS</span></dt><dd><p>Set nfsopts. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_NET_ROOT_PATH</span></dt><dd><p>Set netboot server directory. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_NET_ROOT_SERVER</span></dt><dd><p>Set netboot server address. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_NET_COW_FILESYSTEM</span></dt><dd><p>Set net client cow filesystem. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_NET_COW_MOUNTOPTIONS</span></dt><dd><p>Set cow mount options. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_NET_COW_PATH</span></dt><dd><p>Set cow directory. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_NET_COW_SERVER</span></dt><dd><p>Set cow server. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_NET_TARBALL</span></dt><dd><p>Set net tarball. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_SYSLINUX_SPLASH</span></dt><dd><p>Set custom syslinux splash. (See <a class="xref" href="bootup.html#splash" title="8.3. Splash screens">Section 8.3, “Splash screens”</a>)</p></dd><dt><span class="term">LH_SYSLINUX_TIMEOUT</span></dt><dd><p>Set custom syslinux timeout in seconds. (See <a class="xref" href="bootup.html#syslinux" title="2. Syslinux">Section 2, “Syslinux”</a>)</p></dd><dt><span class="term">LH_SYSLINUX_CFG</span></dt><dd><p>Set custom syslinux configuration file. (See <a class="xref" href="bootup.html#syslinux" title="2. Syslinux">Section 2, “Syslinux”</a>)</p></dd><dt><span class="term">LH_SYSLINUX_MENU</span></dt><dd><p>Set syslinux menu. (See <a class="xref" href="bootup.html#syslinux" title="2. Syslinux">Section 2, “Syslinux”</a>)</p></dd><dt><span class="term">LH_SYSLINUX_MENU_LIVE_ENTRY</span></dt><dd><p>Set text to be used on the menu for live entries. (See <a class="xref" href="bootup.html#syslinux" title="2. Syslinux">Section 2, “Syslinux”</a>)</p></dd><dt><span class="term">LH_SYSLINUX_MENU_LIVE_FAILSAFE_ENTRY</span></dt><dd><p>Set text to be used on the menu for live entries (failsafe ones). (See <a class="xref" href="bootup.html#syslinux" title="2. Syslinux">Section 2, “Syslinux”</a>)</p></dd><dt><span class="term">LH_SYSLINUX_MENU_MEMTEST_ENTRY</span></dt><dd><p>Set text to be used on the menu for memtest entry. (See <a class="xref" href="bootup.html#syslinux" title="2. Syslinux">Section 2, “Syslinux”</a> and <a class="xref" href="bootup.html#memtest" title="8.4. Memtest">Section 8.4, “Memtest”</a>)</p></dd><dt><span class="term">LH_USERNAME</span></dt><dd><p>Set username. (See <a class="xref" href="live-environment.html#username" title="11.3. Username">Section 11.3, “Username”</a>)</p></dd></dl></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="config-bootstrap"></a>B.2. The <code class="filename">config/bootstrap</code> file</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">LH_ARCHITECTURE</span></dt><dd><p>Select chroot architecture. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_BOOTSTRAP_CONFIG</span></dt><dd><p>Set distribution config directory. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_BOOTSTRAP_INCLUDE</span></dt><dd><p>Include packages on base. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_BOOTSTRAP_EXCLUDE</span></dt><dd><p>Exclude packages on base. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_BOOTSTRAP_FLAVOUR</span></dt><dd><p>Select flavour to use. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_BOOTSTRAP_KEYRING</span></dt><dd><p>Set distribution keyring. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_DISTRIBUTION</span></dt><dd><p>Select distribution to use. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_MIRROR_BOOTSTRAP</span></dt><dd><p>Set mirror to bootstrap from. (See <a class="xref" href="packages.html#package-sources" title="6.1. Package sources">Section 6.1, “Package sources”</a>)</p></dd><dt><span class="term">LH_MIRROR_CHROOT</span></dt><dd><p>Set mirror to fetch packages from. (See <a class="xref" href="packages.html#package-sources" title="6.1. Package sources">Section 6.1, “Package sources”</a>)</p></dd><dt><span class="term">LH_MIRROR_CHROOT_SECURITY</span></dt><dd><p>Set security mirror to fetch packages from. (See <a class="xref" href="packages.html#package-sources" title="6.1. Package sources">Section 6.1, “Package sources”</a>)</p></dd><dt><span class="term">LH_MIRROR_BINARY</span></dt><dd><p>Set mirror which ends up in the image. (See <a class="xref" href="packages.html#package-sources" title="6.1. Package sources">Section 6.1, “Package sources”</a>)</p></dd><dt><span class="term">LH_MIRROR_BINARY_SECURITY</span></dt><dd><p>Set security mirror which ends up in the image. (See <a class="xref" href="packages.html#package-sources" title="6.1. Package sources">Section 6.1, “Package sources”</a>)</p></dd><dt><span class="term">LH_SECTIONS</span></dt><dd><p>select section(s) to use. (See <a class="xref" href="packages.html#package-sources" title="6.1. Package sources">Section 6.1, “Package sources”</a>)</p></dd></dl></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="config-chroot"></a>B.3. The <code class="filename">config/chroot</code> file</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">LH_CHROOT_FILESYSTEM</span></dt><dd><p>Set chroot filesystem. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_UNION_FILESYSTEM</span></dt><dd><p>Set union filesystem. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_EXPOSED_ROOT</span></dt><dd><p>expose root as read only. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_HOOKS</span></dt><dd><p>Set hook commands. (See <a class="xref" href="contents.html#hooks" title="7.1. Hooks">Section 7.1, “Hooks”</a>)</p></dd><dt><span class="term">LH_INTERACTIVE</span></dt><dd><p>Set interactive build. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_KEYRING_PACKAGES</span></dt><dd><p>Set keyring packages. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_LANGUAGE</span></dt><dd><p>Set language to use. (See <a class="xref" href="live-environment.html#language" title="11.4. Language">Section 11.4, “Language”</a>)</p></dd><dt><span class="term">LH_LINUX_FLAVOURS</span></dt><dd><p>Set kernel flavour to use. (See <a class="xref" href="bootup.html#kernel" title="8.1. Kernel">Section 8.1, “Kernel”</a>)</p></dd><dt><span class="term">LH_LINUX_PACKAGES</span></dt><dd><p>Set kernel packages to use. (See <a class="xref" href="bootup.html#kernel" title="8.1. Kernel">Section 8.1, “Kernel”</a>)</p></dd><dt><span class="term">LH_PACKAGES</span></dt><dd><p>Set packages to install. (See <a class="xref" href="packages.html#lh-packages" title="1. The LH_PACKAGES variable">Section 1, “The <code class="computeroutput">LH_PACKAGES</code> variable”</a>)</p></dd><dt><span class="term">LH_PACKAGES_LISTS</span></dt><dd><p>Set package list to install. (See <a class="xref" href="packages.html#package-lists" title="2. Package lists">Section 2, “Package lists”</a>)</p></dd><dt><span class="term">LH_TASKS</span></dt><dd><p>Set tasks to install. (See <a class="xref" href="packages.html#tasks" title="3. Tasks">Section 3, “Tasks”</a>)</p></dd><dt><span class="term">LH_SECURITY</span></dt><dd><p>enable security updates. (See <a class="xref" href="packages.html#package-sources" title="6.1. Package sources">Section 6.1, “Package sources”</a>)</p></dd><dt><span class="term">LH_SYMLINKS</span></dt><dd><p>enable symlink convertion. (See <a class="xref" href="contents.html#symlinks" title="7.3. Symlink conversion">Section 7.3, “Symlink conversion”</a>)</p></dd><dt><span class="term">LH_SYSVINIT</span></dt><dd><p>enable sysvinit. (See <a class="xref" href="bootup.html#startup-scripts" title="8.5. Startup scripts">Section 8.5, “Startup scripts”</a>)</p></dd></dl></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="config-common"></a>B.4. The <code class="filename">config/common</code> file</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">LH_APT</span></dt><dd><p>Set package manager. (See <a class="xref" href="packages.html#package-installation" title="6.2. Package installation">Section 6.2, “Package installation”</a>)</p></dd><dt><span class="term">LH_APT_FTP_PROXY</span></dt><dd><p>Set apt/aptitude ftp proxy. (See <a class="xref" href="packages.html#package-installation" title="6.2. Package installation">Section 6.2, “Package installation”</a>)</p></dd><dt><span class="term">LH_APT_HTTP_PROXY</span></dt><dd><p>Set apt/aptitude http proxy. (See <a class="xref" href="packages.html#package-installation" title="6.2. Package installation">Section 6.2, “Package installation”</a>)</p></dd><dt><span class="term">LH_APT_PDIFFS</span></dt><dd><p>Set apt/aptitude pdiff indices. (See <a class="xref" href="packages.html#package-installation" title="6.2. Package installation">Section 6.2, “Package installation”</a>)</p></dd><dt><span class="term">LH_APT_PIPELINE</span></dt><dd><p>Set apt/aptitude pipeline depth. (See <a class="xref" href="packages.html#package-installation" title="6.2. Package installation">Section 6.2, “Package installation”</a>)</p></dd><dt><span class="term">LH_APT_RECOMMENDS</span></dt><dd><p>Set apt/aptitude recommends. (See <a class="xref" href="packages.html#package-installation" title="6.2. Package installation">Section 6.2, “Package installation”</a>)</p></dd><dt><span class="term">LH_APT_SECURE</span></dt><dd><p>Set apt/aptitude security. (See <a class="xref" href="packages.html#package-installation" title="6.2. Package installation">Section 6.2, “Package installation”</a>)</p></dd><dt><span class="term">LH_BOOTSTRAP</span></dt><dd><p>Set bootstrap program. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_CACHE</span></dt><dd><p>control cache. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_CACHE_INDICES</span></dt><dd><p>control if downloaded package indices should be cached. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_CACHE_PACKAGES</span></dt><dd><p>control if downloaded packages files should be cached. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_CACHE_STAGES</span></dt><dd><p>control if completed stages should be cached. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_DEBCONF_FRONTEND</span></dt><dd><p>Set debconf(1) frontend to use. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_DEBCONF_NOWARNINGS</span></dt><dd><p>Set debconf(1) warnings. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_DEBCONF_PRIORITY</span></dt><dd><p>Set debconf(1) priority to use. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_INITRAMFS</span></dt><dd><p>Set initramfs hook. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_FDISK</span></dt><dd><p>Set fdisk program. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_LOSETUP</span></dt><dd><p>Set losetup program. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_MODE</span></dt><dd><p>Set distribution mode. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_ROOT_COMMAND</span></dt><dd><p>use sudo or equivalent. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_USE_FAKEROOT</span></dt><dd><p>use fakeroot/fakechroot. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_TASKSEL</span></dt><dd><p>Set tasksel program. (See <a class="xref" href="packages.html#tasks" title="3. Tasks">Section 3, “Tasks”</a>)</p></dd><dt><span class="term">LH_INCLUDES</span></dt><dd><p>Set includes. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_TEMPLATES</span></dt><dd><p>Set templates. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_BREAKPOINTS</span></dt><dd><p>enable breakpoints. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_DEBUG</span></dt><dd><p>enable debug. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_FORCE</span></dt><dd><p>enable force. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_QUIET</span></dt><dd><p>enable quiet. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_VERBOSE</span></dt><dd><p>enable verbose. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd></dl></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="config-source"></a>B.5. The <code class="filename">config/source</code> file</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">LH_SOURCE</span></dt><dd><p>Set source option. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term">LH_SOURCE_IMAGES</span></dt><dd><p>Set image type. (See <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd></dl></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="configuration-layout.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top">Appendix A. Configuration layout </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>
diff --git a/configuration-layout.html b/configuration-layout.html
new file mode 100644
index 0000000..3a95dce
--- /dev/null
+++ b/configuration-layout.html
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Appendix A. Configuration layout</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="Debian Live Manual" /><link rel="up" href="index.html" title="Debian Live Manual" /><link rel="prev" href="resources.html" title="Chapter 14. Resources and links" /><link rel="next" href="configuration-files.html" title="Appendix B. Configuration files" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix A. Configuration layout</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="resources.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="configuration-files.html">Next</a></td></tr></table><hr /></div><div class="appendix" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="configuration-layout"></a>Appendix A. Configuration layout</h2></div></div></div><div class="variablelist"><p class="title"><b>Layout of the <code class="filename">config/</code> directory</b></p><dl><dt><span class="term"><code class="filename">binary_debian-installer/</code></span></dt><dd><p>(see <a class="xref" href="common-tasks.html#debian-installer" title="10.1. The Debian Installer">Section 10.1, “The Debian Installer”</a>)</p></dd><dt><span class="term"><code class="filename">binary_grub/</code></span></dt><dd><p>(see <a class="xref" href="bootup.html#bootloaders" title="8.2. Bootloaders">Section 8.2, “Bootloaders”</a>)</p></dd><dt><span class="term"><code class="filename">binary_local-debs/</code></span></dt><dd><p>(see <a class="xref" href="common-tasks.html#debian-installer" title="10.1. The Debian Installer">Section 10.1, “The Debian Installer”</a>)</p></dd><dt><span class="term"><code class="filename">binary_local-hooks/</code></span></dt><dd><p>(see <a class="xref" href="contents.html#binary-local-hooks" title="2. Binary local hooks">Section 2, “Binary local hooks”</a>)</p></dd><dt><span class="term"><code class="filename">binary_local-includes/</code></span></dt><dd><p>(see <a class="xref" href="contents.html#binary-includes" title="2. Binary includes">Section 2, “Binary includes”</a>)</p></dd><dt><span class="term"><code class="filename">binary_local-packageslists/</code></span></dt><dd><p>(see <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term"><code class="filename">binary_local-udebs/</code></span></dt><dd><p>(see <a class="xref" href="common-tasks.html#debian-installer" title="10.1. The Debian Installer">Section 10.1, “The Debian Installer”</a>)</p></dd><dt><span class="term"><code class="filename">binary_rootfs/</code></span></dt><dd><p>(see <a class="xref" href="configuration-layout.html" title="Appendix A. Configuration layout">Appendix A, <i>Configuration layout</i></a>)</p></dd><dt><span class="term"><code class="filename">binary_syslinux/</code></span></dt><dd><p>(see <a class="xref" href="bootup.html#bootloaders" title="8.2. Bootloaders">Section 8.2, “Bootloaders”</a>)</p></dd><dt><span class="term"><code class="filename">chroot_apt/</code></span></dt><dd><p>(see <a class="xref" href="packages.html#custom-packages-apt" title="3. Custom packages and APT">Section 3, “Custom packages and APT”</a>)</p></dd><dt><span class="term"><code class="filename">chroot_local-hooks/</code></span></dt><dd><p>(see <a class="xref" href="contents.html#chroot-local-hooks" title="1. Live/chroot local hooks">Section 1, “Live/chroot local hooks”</a>)</p></dd><dt><span class="term"><code class="filename">chroot_local-includes/</code></span></dt><dd><p>(see <a class="xref" href="contents.html#chroot-includes" title="1. Live/chroot includes">Section 1, “Live/chroot includes”</a>)</p></dd><dt><span class="term"><code class="filename">chroot_local-packages/</code></span></dt><dd><p>(see <a class="xref" href="packages.html#local-packages" title="1. Using chroot_local-packages to install custom packages">Section 1, “Using <code class="filename">chroot_local-packages</code> to install custom packages”</a>)</p></dd><dt><span class="term"><code class="filename">chroot_local-packageslists/</code></span></dt><dd><p>(see <a class="xref" href="packages.html#package-lists" title="2. Package lists">Section 2, “Package lists”</a>)</p></dd><dt><span class="term"><code class="filename">chroot_sources/</code></span></dt><dd><p>(see <a class="xref" href="packages.html#custom-apt-repo" title="2. Using an APT repository to install custom packages">Section 2, “Using an APT repository to install custom packages”</a>)</p></dd><dt><span class="term"><code class="filename">includes/</code></span></dt><dd><p>(see <a class="xref" href="bootup.html#bootloaders" title="8.2. Bootloaders">Section 8.2, “Bootloaders”</a>)</p></dd><dt><span class="term"><code class="filename">templates/</code></span></dt><dd><p>(see <a class="xref" href="bootup.html#bootloaders" title="8.2. Bootloaders">Section 8.2, “Bootloaders”</a>)</p></dd><dt><span class="term"><code class="filename">bootstrap</code></span></dt><dd><p>(see <a class="xref" href="configuration-files.html#config-bootstrap" title="B.2. The config/bootstrap file">Section B.2, “The <code class="filename">config/bootstrap</code> file”</a>)</p></dd><dt><span class="term"><code class="filename">binary</code></span></dt><dd><p>(see <a class="xref" href="configuration-files.html#config-binary" title="B.1. The config/binary file">Section B.1, “The <code class="filename">config/binary</code> file”</a>)</p></dd><dt><span class="term"><code class="filename">chroot</code></span></dt><dd><p>(see <a class="xref" href="configuration-files.html#config-chroot" title="B.3. The config/chroot file">Section B.3, “The <code class="filename">config/chroot</code> file”</a>)</p></dd><dt><span class="term"><code class="filename">common</code></span></dt><dd><p>(see <a class="xref" href="configuration-files.html#config-common" title="B.4. The config/common file">Section B.4, “The <code class="filename">config/common</code> file”</a>)</p></dd><dt><span class="term"><code class="filename">source</code></span></dt><dd><p>(see <a class="xref" href="configuration-files.html#config-source" title="B.5. The config/source file">Section B.5, “The <code class="filename">config/source</code> file”</a>)</p></dd></dl></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="resources.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="configuration-files.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 14. Resources and links </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Appendix B. Configuration files</td></tr></table></div></body></html>
diff --git a/contents.html b/contents.html
new file mode 100644
index 0000000..f2ba8e1
--- /dev/null
+++ b/contents.html
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 7. Customising contents</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="Debian Live Manual" /><link rel="up" href="index.html" title="Debian Live Manual" /><link rel="prev" href="packages.html" title="Chapter 6. Customising package installation" /><link rel="next" href="bootup.html" title="Chapter 8. Customising the bootup process" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 7. Customising contents</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="packages.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="bootup.html">Next</a></td></tr></table><hr /></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="contents"></a>Chapter 7. Customising contents</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="contents.html#hooks">7.1. Hooks</a></span></dt><dt><span class="section"><a href="contents.html#id332183">7.2. Includes</a></span></dt><dt><span class="section"><a href="contents.html#symlinks">7.3. Symlink conversion</a></span></dt></dl></div><p>This chapter discusses further customisation of the live system.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="hooks"></a>7.1. Hooks</h2></div></div></div><p>FIXME.</p><p>Enabling hooks</p><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="chroot-local-hooks"></a>1. Live/chroot local hooks</h2></div></div></div><p>FIXME.</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="binary-local-hooks"></a>2. Binary local hooks</h2></div></div></div><p>FIXME.</p></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id332183"></a>7.2. Includes</h2></div></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="chroot-includes"></a>1. Live/chroot includes</h2></div></div></div><p>FIXME.</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="binary-includes"></a>2. Binary includes</h2></div></div></div><p>FIXME.</p></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="symlinks"></a>7.3. Symlink conversion</h2></div></div></div><p>FIXME. (This is probably in the wrong section)</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="packages.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="bootup.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 6. Customising package installation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 8. Customising the bootup process</td></tr></table></div></body></html>
diff --git a/debian-live-manual.sgml b/debian-live-manual.sgml
deleted file mode 100644
index 51fb425..0000000
--- a/debian-live-manual.sgml
+++ /dev/null
@@ -1,63 +0,0 @@
-<!doctype debiandoc system [
-<!entity % versiondata SYSTEM "out/version.ent"> %versiondata;
-
-<!entity chapter-meta SYSTEM "chapters/meta.sgml">
-<!entity chapter-about SYSTEM "chapters/about.sgml">
-<!entity chapter-installation SYSTEM "chapters/installation.sgml">
-<!entity chapter-basics SYSTEM "chapters/basics.sgml">
-<!entity chapter-overview SYSTEM "chapters/overview.sgml">
-<!entity chapter-customisation-packages SYSTEM "chapters/customisation-packages.sgml">
-<!entity chapter-customisation-contents SYSTEM "chapters/customisation-contents.sgml">
-<!entity chapter-customisation-bootup SYSTEM "chapters/customisation-bootup.sgml">
-<!entity chapter-customisation-binary SYSTEM "chapters/customisation-binary.sgml">
-<!entity chapter-common-tasks SYSTEM "chapters/common-tasks.sgml">
-<!entity chapter-live-environment SYSTEM "chapters/live-environment.sgml">
-<!entity chapter-faq SYSTEM "chapters/faq.sgml">
-<!entity chapter-reporting-bugs SYSTEM "chapters/reporting-bugs.sgml">
-<!entity chapter-resources SYSTEM "chapters/resources.sgml">
-
-<!entity appendix-configuration-layout SYSTEM "appendices/configuration-layout.sgml">
-<!entity appendix-configuration-files SYSTEM "appendices/configuration-files.sgml">
-]>
-
-<debiandoc>
-
-<book>
-
-<titlepag>
-<title>Debian Live Manual</title>
-<author><qref id="authors">The Debian Live Project.</qref></author>
-<version>version &version;, &date;</version>
-
-<copyright>
-<copyrightsummary>Copyright © 2008 Debian Live Project</copyrightsummary>
-<p>This handbook is free software; you may redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.
-</p>
-
-<p>This is distributed in the hope that it will be useful, but <em>without any warranty</em>; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License for more details.
-</p>
-
-<p>A copy of the GNU General Public License is available as <file>/usr/share/common-licenses/GPL-3</file> in the Debian GNU/Linux distribution or on the World Wide Web at <url id="http://www.gnu.org/copyleft/gpl.html" name="the GNU General Public Licence">. You can also obtain it by writing to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.</p>
-</copyright>
-</titlepag>
-
-<toc detail="sect1">
-&chapter-meta;
-&chapter-about;
-&chapter-overview;
-&chapter-installation;
-&chapter-basics;
-&chapter-customisation-packages;
-&chapter-customisation-contents;
-&chapter-customisation-bootup;
-&chapter-customisation-binary;
-&chapter-live-environment;
-&chapter-common-tasks;
-&chapter-faq;
-&chapter-reporting-bugs;
-&chapter-resources;
-
-&appendix-configuration-layout;
-&appendix-configuration-files;
-</book>
-</debiandoc>
diff --git a/ent/common.ent b/ent/common.ent
new file mode 100644
index 0000000..76ff659
--- /dev/null
+++ b/ent/common.ent
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
diff --git a/index.html.in b/index.html.in
index 78408db..3d5e503 100644
--- a/index.html.in
+++ b/index.html.in
@@ -13,9 +13,8 @@
<p>Formats:
<ul>
<li><strong><a href="html/">HTML</a></strong></li>
- <li><a href="NAME.txt">Plain text</a></li>
- <li><a href="NAME.pdf">PDF</a></li>
- <li><a href="NAME.ps">PostScript</a></li>
+ <li><a href="txt/live-manual.txt">Plain text</a></li>
+ <li><a href="pdf/live-manual.pdf">PDF</a></li>
</ul>
</p>
diff --git a/index.xml b/index.xml
new file mode 100644
index 0000000..540fe47
--- /dev/null
+++ b/index.xml
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "ent/common.ent" > %commondata;
+ <!ENTITY % versiondata SYSTEM "ent/version.ent"> %versiondata;
+]>
+<book lang="en">
+
+<title>Debian Live Manual</title>
+<bookinfo>
+<author>
+ <othername>The Debian Live Project</othername>
+ <email>debian-live-devel at lists.alioth.debian.org</email>
+</author>
+
+<releaseinfo>&version;</releaseinfo>
+<pubdate>&pubdate;</pubdate>
+
+<copyright>
+ <year>2008</year>
+ <holder>The Debian Live Project</holder>
+</copyright>
+
+<legalnotice>
+<para>
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+</para>
+<para>
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+</para>
+<para>
+A copy of the GNU General Public License is available as
+<filename>/usr/share/common-licenses/GPL</filename> in the Debian GNU/Linux
+distribution or on the World Wide Web at
+<ulink url="http://www.gnu.org/copyleft/gpl.html">the GNU web site</ulink>.
+You can also obtain it by writing to the Free Software Foundation, Inc., 59
+Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+</para>
+<para>
+If you want to print this reference, this document is also available in Portable
+Document Format (PDF).
+</para>
+</legalnotice>
+</bookinfo>
+
+<!-- Chapters -->
+<xi:include href="chapters/meta.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/about.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/installation.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/basics.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/overview.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/customisation-packages.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/customisation-contents.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/customisation-bootup.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/customisation-binary.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/common-tasks.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/live-environment.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/faq.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/reporting-bugs.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="chapters/resources.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+
+<!-- Appendecis -->
+<xi:include href="appendices/configuration-layout.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+<xi:include href="appendices/configuration-files.xml" xmlns:xi="http://www.w3.org/2003/XInclude"/>
+
+</book>
diff --git a/xsl/html.xsl b/xsl/html.xsl
new file mode 100644
index 0000000..bf75cf8
--- /dev/null
+++ b/xsl/html.xsl
@@ -0,0 +1,10 @@
+<?xml version="1.0"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ version="1.0">
+ <xsl:import
+ href="http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl"/>
+ <xsl:param name="chunk.section.depth">0</xsl:param>
+ <xsl:param name="section.autolabel">1</xsl:param>
+ <xsl:param name="section.label.includes.component.label">1</xsl:param>
+ <xsl:param name="use.id.as.filename">1</xsl:param>
+</xsl:stylesheet>
diff --git a/xsl/txt.xsl b/xsl/txt.xsl
new file mode 100644
index 0000000..227d812
--- /dev/null
+++ b/xsl/txt.xsl
@@ -0,0 +1,27 @@
+<?xml version="1.0"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ version="1.0">
+ <xsl:import
+ href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"/>
+ <xsl:param name="section.autolabel">1</xsl:param>
+ <xsl:param name="section.label.includes.component.label">1</xsl:param>
+ <xsl:param name="generate.toc">
+ appendix title
+ article/appendix nop
+ article toc,title
+ book toc,title,figure,table,example,equation
+ chapter title
+ part toc,title
+ preface toc,title
+ qandadiv toc
+ qandaset toc
+ reference toc,title
+ sect1 toc
+ sect2 toc
+ sect3 toc
+ sect4 toc
+ sect5 toc
+ section toc
+ set toc,title
+ </xsl:param>
+</xsl:stylesheet>
--
Debian Live manual
More information about the debian-live-changes
mailing list