[SCM] Debian Live manual branch, master, updated. 8504d667333757d98240808c0c0de5fef69a0b6b

Chris Lamb chris at chris-lamb.co.uk
Sun May 11 21:32:06 UTC 2008 

The following commit has been merged in the master branch:
commit 8504d667333757d98240808c0c0de5fef69a0b6b
Author: Chris Lamb <chris at chris-lamb.co.uk>
Date:   Sun May 11 22:32:00 2008 +0100

    Remove accidentally checked-in output files
    
    Signed-off-by: Chris Lamb <chris at chris-lamb.co.uk>

diff --git a/about.html b/about.html
deleted file mode 100644
index d8e0fd6..0000000
--- a/about.html
+++ /dev/null
@@ -1,9 +0,0 @@
-<?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">&lt;<a class="email" href="mailto:debian-live-devel at lists.alioth.debian.org">debian-live-devel at lists.alioth.debian.org</a>&gt;</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/basics.html b/basics.html
deleted file mode 100644
index 556d0d4..0000000
--- a/basics.html
+++ /dev/null
@@ -1,39 +0,0 @@
-<?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
deleted file mode 100644
index a100032..0000000
--- a/binary.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<?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&gt;</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
deleted file mode 100644
index b20ec2b..0000000
--- a/bootup.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<?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
deleted file mode 100644
index 1f54948..0000000
--- a/bugs.html
+++ /dev/null
@@ -1,9 +0,0 @@
-<?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/common-tasks.html b/common-tasks.html
deleted file mode 100644
index e9de66c..0000000
--- a/common-tasks.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<?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
deleted file mode 100644
index 9f15d57..0000000
--- a/configuration-files.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<?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
deleted file mode 100644
index 3a95dce..0000000
--- a/configuration-layout.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<?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
deleted file mode 100644
index f2ba8e1..0000000
--- a/contents.html
+++ /dev/null
@@ -1,3 +0,0 @@
-<?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>

-- 
Debian Live manual

More information about the debian-live-changes mailing list