[SCM] live-manual branch, debian, updated. debian/2.0_a1-1-2-gcf853e4
Daniel Baumann
daniel at debian.org
Sun Jun 6 14:41:59 UTC 2010
The following commit has been merged in the debian branch:
commit cf853e4e074014ae3fe03f3829e73ab051469961
Author: Daniel Baumann <daniel at debian.org>
Date: Sun Jun 6 16:35:22 2010 +0200
Rewrapping about_project page.
diff --git a/manual/en/about_project.xml b/manual/en/about_project.xml
index be7d195..0105678 100644
--- a/manual/en/about_project.xml
+++ b/manual/en/about_project.xml
@@ -1,8 +1,10 @@
<?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 "common.ent" > %commondata;
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "common.ent" > %commondata;
]>
+
<sect1 id="about">
<title>About the Debian Live Project</title>
@@ -12,32 +14,116 @@
<sect3>
<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>
+<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 modify the behaviour and/or appearance of packages 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 that are 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>
+
+<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 modify the behaviour and/or appearance of packages 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 that are 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>
</sect3>
<sect3>
<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>
+<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>
+
+<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>
</sect3>
@@ -49,29 +135,77 @@
<sect3>
<title>Only unchanged, official packages</title>
-<para>We will only use official packages from the Debian repository in the "main" section (possibly contrib, although not decided yet). The non-free section is not part of Debian and therefore cannot be used at all for live systems.</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>
+ We will only use official packages from the Debian repository in the
+ "main" section (possibly contrib, although not decided yet). The
+ non-free section is not part of Debian and therefore cannot be used at
+ all for live systems.
+</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>
+ As an exception, our own packages such as &live-helper; or
+ &live-initramfs; may temporarily be used from our own repository for
+ development reasons (e.g. to create development snapshots). They will be
+ uploaded to Debian on a regular basis.
+</para>
-<para>As an exception, our own packages such as &live-helper; or &live-initramfs; may temporarily be used from our own repository for development reasons (e.g. to create development snapshots). They will be uploaded to Debian on a regular basis.</para>
</sect3>
<sect3>
<title>No package 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>
+ 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
+ <command>lh config</command> (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. For more information, please see <xref linkend="customization"/>.
+</para>
-<para>A system for configuring packages is provided using debconf in <command>lh config</command> (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. For more information, please see <xref linkend="customization"/>.</para>
+<para>
+ Exception: There are a few essential changes needed to bring a live
+ system to life (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>
-<para>Exception: There are a few essential changes needed to bring a live system to life (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>
</sect3>
<sect3>
<title>Live system to hard disk installer</title>
-<para>For the moment we will not ship an installer to copy the live system to a partition on the hard disk. 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>
+<para>
+ For the moment we will not ship an installer to copy the live system to
+ a partition on the hard disk. 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>
+
</sect3>
</sect2>
@@ -80,20 +214,60 @@
<title>Contact</title>
<variablelist>
- <varlistentry><term>Mailing list</term>
- <listitem><para>The primary contact for the project is the <ulink url="http://lists.debian.org/debian-live/">mailing list</ulink>. You can email the list directly by addressing your mail to <email>debian-live at lists.debian.org</email>. The <ulink url="http://lists.debian.org/debian-live/">list archives</ulink> are also available.</para></listitem>
+
+<varlistentry>
+<term>Mailing list</term>
+
+<listitem>
+<para>
+ The primary contact for the project is the <ulink
+ url="http://lists.debian.org/debian-live/">mailing list</ulink>. You can
+ email the list directly by addressing your mail to
+ <email>debian-live at lists.debian.org</email>. The <ulink
+ url="http://lists.debian.org/debian-live/">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>
+<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 users 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>
+<term>BTS</term>
+
+<listitem>
+<para>
+ The Debian Bug Tracking System (BTS) contains details of bugs reported
+ by users 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>The <ulink url="http://wiki.debian.org/DebianLive">Debian Live wiki</ulink> is a place to gather information, discuss applied technologies, and document frameworks of Debian Live systems that go beyond the scope of this document.</para></listitem>
+<varlistentry>
+<term>Wiki</term>
+
+<listitem>
+<para>
+ The <ulink url="http://wiki.debian.org/DebianLive"
+ >Debian Live wiki</ulink> is a place to gather information, discuss
+ applied technologies, and document frameworks of Debian Live systems
+ that go beyond the scope of this document.
+</para>
+</listitem>
</varlistentry>
</variablelist>
--
live-manual
More information about the debian-live-changes
mailing list