[SCM] live-manual branch, debian, updated. debian/2.0_a5-1-11-gbbfc27d

[Daniel Baumann]

The following commit has been merged in the debian branch:
commit bbfc27d8b141345a52674125286b9ccd85822b90
Author: Daniel Baumann <daniel at debian.org>
Date:   Tue Sep 7 15:15:57 2010 +0200

    Moving reviewed other_overview to user section.

diff --git a/manual/de/live-manual.ssm b/manual/de/live-manual.ssm
index 32e0380..bcbbf8c 100644
--- a/manual/de/live-manual.ssm
+++ b/manual/de/live-manual.ssm
@@ -29,7 +29,7 @@
 
 :B~ User ~#
 
-<< user_installation.ssi << user_basics.ssi
+<< user_installation.ssi << user_basics.ssi << user_overview.ssi
 
 :B~ Development ~#
 
@@ -37,8 +37,6 @@
 
 :B~ Other ~#
 
-<< other_overview.ssi
-
 << other_customization-packages.ssi
 
 << other_customization-contents.ssi
diff --git a/manual/de/other_overview.ssi b/manual/de/other_overview.ssi
deleted file mode 100644
index 7deca95..0000000
--- a/manual/de/other_overview.ssi
+++ /dev/null
@@ -1,176 +0,0 @@
-:B~ Overview of tools
-
-1~ Overview of tools
-
-This chapter contains an overview of the two main tools used in building
-Debian Live systems.
-
-2~ live-helper
-
-live-helper is a collection of scripts to build Debian Live systems. These
-scripts are also referred to as "helpers".
-
-The idea behind live-helper is to be a framework that uses a configuration
-directory to completely automate and customize all aspects of building a
-Live image.
-
-Many concepts are similar to those in the debhelper Debian package tools
-written by Joey Hess:
-
-_* The scripts have a central location for configuring their operation. In
-debhelper, this is the debian subdirectory of a package tree. For example,
-dh_install will look for a file called #{debian/.install}# to determine
-which files should exist in a particular binary package. In much the same
-way, live-helper stores its configuration entirely under a config
-subdirectory.
-
-_* The scripts are independent - that is to say, it is always safe to run
-each command.
-
-Unlike debhelper, live-helper contains a tool to generate a skeleton
-configuration directory, lh config. This could be considered to be similar
-to tools such as dh-make. For more information about lh config, please see
-lh-config.  % FIXME: <xref linkend="lh-config"/>
-
-Besides the common config/common, which is used by all live-helper helper
-commands, some additional files can be used to configure the behavior of
-specific helper commands. These files are typically named config/helper or
-config/stage (where "stage", of course, is replaced with the name of the
-stage that they belong to, and "helper" with the name of the helper).
-
-For example, the lh bootstrap debootstrap helper command uses files named
-config/bootstrap and config/bootstrap_debootstrap to read the options it
-will use. Generally, these files contain variables with values assigned, one
-variable per line. Some programs in live-helper use pairs of values or
-slightly more complicated variable assignments.
-
-live-helper 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), live-helper will automatically set it to a
-default value.
-
-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.
-
-In some rare cases you may want to have different versions of these files
-for different architectures or distributions. If files named
-config/stage.arch or config/stage_helper.arch, and config/stage.dist or
-config/stage_helper.dist exist (where "arch" is the same as the output of
-dpkg --print-architecture 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.
-
-Please see installation for information on how to install live-helper.  %
-FIXME: <xref linkend="installation"/>
-
-The remainder of this section discusses the three most important helpers:
-
-_* *{lh config}*: Responsible for initialising a Live system configuration
-directory. See lh-config for more information.  % FIXME: <xref
-linkend="lh-config"/>
-
-_* *{lh build}*: Responsible for starting a Live system build. See lh-build
-for more information.  % FIXME: <xref linkend="lh-build"/>
-
-_* *{lh clean}*: Responsible for removing parts of a Live system build. See
-lh-clean for more information.  % FIXME: <xref linkend="lh-clean"/
-
-3~ The lh config helper
-
-As discussed in live-helper, the scripts that make up live-helper source
-their configuration from a single directory named config/. As constructing
-this directory by hand would be time-consuming and error-prone, the lh
-config helper can be used to create skeleton configuration folders.  %
-FIXME: <xref linkend="live-helper"/>
-
-Issuing lh config without any arguments creates a config subdirectory which
-it populates with some default settings:
-
-code{
-
-$ 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 104 -rw-r--r-- 1 user group 4175
-2010-04-11 12:16 binary drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-binary_debian-installer drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-binary_debian-installer-includes drwxr-xr-x 2 user group 4096 2010-04-11
-12:16 binary_grub drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-binary_local-debs drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-binary_local-hooks drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-binary_local-includes drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-binary_local-packageslists drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-binary_local-udebs drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-binary_rootfs drwxr-xr-x 2 user group 4096 2010-04-11 12:16 binary_syslinux
--rw-r--r-- 1 user group 2205 2010-04-11 12:16 bootstrap -rw-r--r-- 1 user
-group 1599 2010-04-11 12:16 chroot drwxr-xr-x 2 user group 4096 2010-04-11
-12:16 chroot_apt drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-chroot_local-hooks drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-chroot_local-includes drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-chroot_local-packages drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-chroot_local-packageslists drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-chroot_local-patches drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-chroot_local-preseed drwxr-xr-x 2 user group 4096 2010-04-11 12:16
-chroot_sources -rw-r--r-- 1 user group 2938 2010-04-11 12:16 common
-drwxr-xr-x 2 user group 4096 2010-04-11 12:16 includes -rw-r--r-- 1 user
-group 206 2010-04-11 12:16 source drwxr-xr-x 2 user group 4096 2010-04-11
-12:16 templates
-
-}code
-
-Using lh config 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.
-
-You can ask lh config to generate a config/ 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:
-
-code{
-
-$ lh config -p gnome
-
-}code
-
-will build a config/ directory configured to include the 'gnome' package
-list. It is possible to specify many options:
-
-code{
-
-$ lh config --apt aptitude --binary-images net --hostname live-machine
---username live-user ...
-
-}code
-
-A full list of options is available in the lh_config man page. Most options
-have a parallel with an "LH_" prefixed variable.
-
-3~ The lh build helper
-
-The lh build helper reads in your configuration from the config/
-directory. It then runs the lower lower level commands needed to build your
-Live system.
-
-3~ The lh clean helper
-
-It is the job of the lh clean helper to remove various parts of a Live
-helper build so subsequent builds can start from a clean state.
-
-2~ The live-initramfs package
-
-live-initramfs is a collection of scripts providing hooks for the
-initramfs-tools, used to generate an initramfs capable of booting live
-systems, such as those created by live-helper. This includes the Debian Live
-isos, netboot tarballs, and usb stick images.
-
-At boot time it will look for read-only media containing a "/live" directory
-where a root filesystem (often a compressed filesystem image like squashfs)
-is stored. If found, it will create a writable environment, using aufs or
-unionfs, for Debian like systems to boot from.
-
-live-initramfs is a fork of casper, http://packages.ubuntu.com/casper.
-
-More information on initial ramfs in Debian can be found in the Debian Linux
-Kernel Handbook at http://kernel-handbook.alioth.debian.org/ in the chapter
-on initramfs.
diff --git a/manual/de/user_overview.ssi b/manual/de/user_overview.ssi
new file mode 100644
index 0000000..229f373
--- /dev/null
+++ b/manual/de/user_overview.ssi
@@ -0,0 +1,175 @@
+:B~ Overview of tools
+
+1~ Overview of tools
+
+This chapter contains an overview of the two main tools used in building
+Debian Live systems.
+
+2~ live-build
+
+live-build is a collection of scripts to build Debian Live systems. These
+scripts are also referred to as "commands".
+
+The idea behind live-build is to be a framework that uses a configuration
+directory to completely automate and customize all aspects of building a
+Live image.
+
+Many concepts are similar to those in the debhelper Debian package tools
+written by Joey Hess:
+
+_* The scripts have a central location for configuring their operation. In
+debhelper, this is the debian subdirectory of a package tree. For example,
+dh_install will look, amongst others, for a file called #{debian/install}#
+to determine which files should exist in a particular binary package. In
+much the same way, live-build stores its configuration entirely under a
+config subdirectory.
+
+_* The scripts are independent - that is to say, it is always safe to run
+each command.
+
+Unlike debhelper, live-build contains a tool to generate a skeleton
+configuration directory, #{lb config}#. This could be considered to be
+similar to tools such as #{dh-make}#. For more information about #{lb
+config}#, please see lb-config.  % FIXME: <xref linkend="lb-config"/>
+
+Besides the common config/common, which is used by all live-build commands,
+some additional files can be used to configure the behavior of specific
+helper commands. These files are typically named config/command or
+config/stage (where "stage", of course, is replaced with the name of the
+stage that they belong to, and "command" with the name of the command).
+
+For example, the #{lb_bootstrap_debootstrap}# command uses files named
+config/bootstrap and config/bootstrap_debootstrap to read the options it
+will use. Generally, these files contain variables with values assigned, one
+variable per line. Some commands of live-buil use pairs of values or
+slightly more complicated variable assignments.
+
+live-build 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), live-build will automatically set it to a
+default value.
+
+All config files are shell scripts which are sourced by a live-build
+command. That means they have to follow the normal shell syntax. You can
+also put comments in these files; lines beginning with "#" are ignored.
+
+In some rare cases you may want to have different versions of these files
+for different architectures or distributions. If files named
+config/stage.arch or config/stage_command.arch, and config/stage.dist or
+config/stage_command.dist exist (where "arch" is the same as the output of
+dpkg --print-architecture 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.
+
+Please see installation for information on how to install live-build.  %
+FIXME: <xref linkend="installation"/>
+
+The remainder of this section discusses the three most important commands:
+
+_* *{lb config}*: Responsible for initialising a Live system configuration
+directory. See lb-config for more information.  % FIXME: <xref
+linkend="lb-config"/>
+
+_* *{lb build}*: Responsible for starting a Live system build. See lb-build
+for more information.  % FIXME: <xref linkend="lb-build"/>
+
+_* *{lb clean}*: Responsible for removing parts of a Live system build. See
+lb-clean for more information.  % FIXME: <xref linkend="lb-clean"/
+
+3~ The #{lb config}# command
+
+As discussed in live-build, the scripts that make up live-build source their
+configuration from a single directory named config/. As constructing this
+directory by hand would be time-consuming and error-prone, the #{lb config}#
+command can be used to create skeleton configuration folders.  % FIXME:
+<xref linkend="live-build"/>
+
+Issuing #{lb config}# without any arguments creates a config subdirectory
+which it populates with some default settings:
+
+code{
+
+$ lb config P: Creating config tree
+
+$ ls -l total 8 drwxr-xr-x 3 user user 4096 Sep 7 13:02 auto drwxr-xr-x 22
+user user 4096 Sep 7 13:02 config
+
+$ ls -l config/ total 104 -rw-r--r-- 1 user user 4197 Sep 7 13:02 binary
+drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_debian-installer drwxr-xr-x 2
+user user 4096 Sep 7 13:02 binary_debian-installer-includes drwxr-xr-x 2
+user user 4096 Sep 7 13:02 binary_grub drwxr-xr-x 2 user user 4096 Sep 7
+13:02 binary_local-debs drwxr-xr-x 2 user user 4096 Sep 7 13:02
+binary_local-hooks drwxr-xr-x 2 user user 4096 Sep 7 13:02
+binary_local-includes drwxr-xr-x 2 user user 4096 Sep 7 13:02
+binary_local-packageslists drwxr-xr-x 2 user user 4096 Sep 7 13:02
+binary_local-udebs drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_rootfs
+drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_syslinux -rw-r--r-- 1 user
+user 2051 Sep 7 13:02 bootstrap -rw-r--r-- 1 user user 1647 Sep 7 13:02
+chroot drwxr-xr-x 2 user user 4096 Sep 7 13:02 chroot_apt drwxr-xr-x 2 user
+user 4096 Sep 7 13:02 chroot_local-hooks drwxr-xr-x 2 user user 4096 Sep 7
+13:02 chroot_local-includes drwxr-xr-x 2 user user 4096 Sep 7 13:02
+chroot_local-packages drwxr-xr-x 2 user user 4096 Sep 7 13:02
+chroot_local-packageslists drwxr-xr-x 2 user user 4096 Sep 7 13:02
+chroot_local-patches drwxr-xr-x 2 user user 4096 Sep 7 13:02
+chroot_local-preseed drwxr-xr-x 2 user user 4096 Sep 7 13:02 chroot_sources
+-rw-r--r-- 1 user user 2954 Sep 7 13:02 common drwxr-xr-x 2 user user 4096
+Sep 7 13:02 includes -rw-r--r-- 1 user user 205 Sep 7 13:02 source
+drwxr-xr-x 2 user user 4096 Sep 7 13:02 templates
+
+}code
+
+Using #{lb config}# 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.
+
+You can ask #{lb config}# to generate a config/ 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:
+
+code{
+
+$ lb config -p gnome
+
+}code
+
+will build a config/ directory configured to include the 'gnome' package
+list. It is possible to specify many options:
+
+code{
+
+$ lb config --binary-images net --hostname live-machine --username live-user
+...
+
+}code
+
+A full list of options is available in the #{lb_config}# man page. Most
+options have a parallel with an "LB_" prefixed variable.
+
+3~ The #{lb build}# command
+
+The #{lb build}# command reads in your configuration from the config/
+directory. It then runs the lower lower level commands needed to build your
+Live system.
+
+3~ The #{lb clean}# command
+
+It is the job of the #{lb clean}# command to remove various parts of a build
+so subsequent builds can start from a clean state.
+
+2~ The live-boot package
+
+live-boot is a collection of scripts providing hooks for the
+initramfs-tools, used to generate an initramfs capable of booting live
+systems, such as those created by live-build. This includes the Debian Live
+isos, netboot tarballs, and usb stick images.
+
+At boot time it will look for read-only media containing a "/live" directory
+where a root filesystem (often a compressed filesystem image like squashfs)
+is stored. If found, it will create a writable environment, using aufs, for
+Debian like systems to boot from.
+
+More information on initial ramfs in Debian can be found in the Debian Linux
+Kernel Handbook at http://kernel-handbook.alioth.debian.org/ in the chapter
+on initramfs.
diff --git a/manual/en/live-manual.ssm b/manual/en/live-manual.ssm
index a13ec4b..8178bd1 100644
--- a/manual/en/live-manual.ssm
+++ b/manual/en/live-manual.ssm
@@ -31,6 +31,7 @@
 
 << user_installation.ssi
 << user_basics.ssi
+<< user_overview.ssi
 
 :B~ Development ~#
 
@@ -38,8 +39,6 @@
 
 :B~ Other ~#
 
-<< other_overview.ssi
-
 << other_customization-packages.ssi
 
 << other_customization-contents.ssi
diff --git a/manual/en/other_overview.ssi b/manual/en/user_overview.ssi
similarity index 100%
rename from manual/en/other_overview.ssi
rename to manual/en/user_overview.ssi
diff --git a/manual/po/de/live-manual.ssm.po b/manual/po/de/live-manual.ssm.po
index cfa9f2e..a21a255 100644
--- a/manual/po/de/live-manual.ssm.po
+++ b/manual/po/de/live-manual.ssm.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-09-07 14:53+0300\n"
+"POT-Creation-Date: 2010-09-07 15:15+0300\n"
 "PO-Revision-Date: 2010-08-14 21:32+0300\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -90,121 +90,116 @@ msgid ":B~ User ~#"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:34
-msgid "<< user_installation.ssi << user_basics.ssi"
+#: en/live-manual.ssm:35
+msgid "<< user_installation.ssi << user_basics.ssi << user_overview.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:36
+#: en/live-manual.ssm:37
 msgid ":B~ Development ~#"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:38
+#: en/live-manual.ssm:39
 msgid ":B~ Project ~#"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:40
+#: en/live-manual.ssm:41
 msgid ":B~ Other ~#"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:42
-msgid "<< other_overview.ssi"
-msgstr ""
-
-#. type: Plain text
-#: en/live-manual.ssm:44
+#: en/live-manual.ssm:43
 msgid "<< other_customization-packages.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:46
+#: en/live-manual.ssm:45
 msgid "<< other_customization-contents.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:48
+#: en/live-manual.ssm:47
 msgid "<< other_customization-internationalization.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:50
+#: en/live-manual.ssm:49
 msgid "<< other_customization-bootup.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:52
+#: en/live-manual.ssm:51
 msgid "<< other_customization-binary.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:54
+#: en/live-manual.ssm:53
 msgid "<< other_customization-backports.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:56
+#: en/live-manual.ssm:55
 msgid "<< other_common-tasks.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:58
+#: en/live-manual.ssm:57
 msgid "<< other_live-environment.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:60
+#: en/live-manual.ssm:59
 msgid "<< other_faq.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:62
+#: en/live-manual.ssm:61
 msgid "<< other_reporting-bugs.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:64
+#: en/live-manual.ssm:63
 msgid "<< other_howtos.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:66
+#: en/live-manual.ssm:65
 msgid "<< other_coding-style.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:68
+#: en/live-manual.ssm:67
 msgid "<< other_procedures.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:70
+#: en/live-manual.ssm:69
 msgid "<< other_resources.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:72
+#: en/live-manual.ssm:71
 msgid "<< other_use-cases.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:74
+#: en/live-manual.ssm:73
 msgid "<< other_success-stories.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:76
+#: en/live-manual.ssm:75
 msgid "<< other_troubleshooting.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:78
+#: en/live-manual.ssm:77
 msgid "<< other_configuration-layout.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:79
+#: en/live-manual.ssm:78
 msgid "<< other_configuration-files.ssi"
 msgstr ""
diff --git a/manual/po/de/other_overview.ssi.po b/manual/po/de/other_overview.ssi.po
deleted file mode 100644
index d985ee6..0000000
--- a/manual/po/de/other_overview.ssi.po
+++ /dev/null
@@ -1,448 +0,0 @@
-# German translations for live-manual package
-# Copyright (C) 2010 Free Software Foundation, Inc.
-# This file is distributed under the same license as the live-manual package.
-# Automatically generated, 2010.
-#
-msgid ""
-msgstr ""
-"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-08-14 21:32+0300\n"
-"PO-Revision-Date: 2010-08-14 21:32+0300\n"
-"Last-Translator: Automatically generated\n"
-"Language-Team: none\n"
-"Language: de\n"
-"MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
-
-#. type: Plain text
-#: en/about_manual.ssi:77 en/about_manual.ssi:85 en/about_manual.ssi:93
-#: en/about_manual.ssi:105 en/about_manual.ssi:116 en/about_manual.ssi:129
-#: en/about_manual.ssi:137 en/about_manual.ssi:145 en/about_manual.ssi:153
-#: en/other_basics.ssi:34 en/other_basics.ssi:45 en/other_basics.ssi:58
-#: en/other_basics.ssi:68 en/other_basics.ssi:106 en/other_basics.ssi:120
-#: en/other_basics.ssi:128 en/other_basics.ssi:136 en/other_basics.ssi:146
-#: en/other_basics.ssi:158 en/other_basics.ssi:176 en/other_basics.ssi:184
-#: en/other_basics.ssi:192 en/other_basics.ssi:208 en/other_basics.ssi:216
-#: en/other_basics.ssi:226 en/other_basics.ssi:301 en/other_basics.ssi:317
-#: en/other_basics.ssi:325 en/other_basics.ssi:347 en/other_basics.ssi:386
-#: en/other_coding-style.ssi:28 en/other_coding-style.ssi:38
-#: en/other_coding-style.ssi:51 en/other_coding-style.ssi:61
-#: en/other_coding-style.ssi:88 en/other_coding-style.ssi:96
-#: en/other_coding-style.ssi:106 en/other_coding-style.ssi:117
-#: en/other_common-tasks.ssi:32 en/other_customization-backports.ssi:8
-#: en/other_customization-bootup.ssi:30 en/other_customization-bootup.ssi:39
-#: en/other_customization-contents.ssi:30
-#: en/other_customization-contents.ssi:39
-#: en/other_customization-internationalization.ssi:10
-#: en/other_customization-internationalization.ssi:18
-#: en/other_customization-internationalization.ssi:26
-#: en/other_customization-internationalization.ssi:34
-#: en/other_customization-internationalization.ssi:46
-#: en/other_customization-packages.ssi:16
-#: en/other_customization-packages.ssi:24
-#: en/other_customization-packages.ssi:34
-#: en/other_customization-packages.ssi:42
-#: en/other_customization-packages.ssi:55
-#: en/other_customization-packages.ssi:91
-#: en/other_customization-packages.ssi:99
-#: en/other_customization-packages.ssi:146
-#: en/other_customization-packages.ssi:156
-#: en/other_customization-packages.ssi:166
-#: en/other_customization-packages.ssi:176 en/other_faq.ssi:41
-#: en/other_faq.ssi:83 en/other_faq.ssi:103 en/other_faq.ssi:117
-#: en/other_faq.ssi:137 en/other_faq.ssi:151 en/other_faq.ssi:198
-#: en/other_faq.ssi:245 en/other_faq.ssi:261 en/other_faq.ssi:287
-#: en/other_faq.ssi:299 en/other_faq.ssi:314 en/other_faq.ssi:333
-#: en/other_faq.ssi:345 en/other_faq.ssi:353 en/other_faq.ssi:364
-#: en/other_faq.ssi:374 en/other_howtos.ssi:16 en/other_howtos.ssi:43
-#: en/other_installation.ssi:40 en/other_installation.ssi:48
-#: en/other_installation.ssi:58 en/other_installation.ssi:66
-#: en/other_installation.ssi:78 en/other_installation.ssi:88
-#: en/other_installation.ssi:109 en/other_installation.ssi:123
-#: en/other_installation.ssi:141 en/other_installation.ssi:149
-#: en/other_installation.ssi:157 en/other_live-environment.ssi:14
-#: en/other_live-environment.ssi:30 en/other_live-environment.ssi:51
-#: en/other_live-environment.ssi:61 en/other_live-environment.ssi:69
-#: en/other_live-environment.ssi:77 en/other_live-environment.ssi:85
-#: en/other_live-environment.ssi:93 en/other_live-environment.ssi:116
-#: en/other_live-environment.ssi:124 en/other_live-environment.ssi:133
-#: en/other_overview.ssi:54 en/other_overview.ssi:94 en/other_overview.ssi:102
-#: en/other_procedures.ssi:12 en/other_procedures.ssi:46
-#: en/other_procedures.ssi:58 en/other_use-cases.ssi:24
-#: en/other_use-cases.ssi:49 en/other_use-cases.ssi:75
-#: en/other_use-cases.ssi:103 en/other_use-cases.ssi:111
-msgid "code{"
-msgstr ""
-
-#. type: Plain text
-#: en/about_manual.ssi:81 en/about_manual.ssi:89 en/about_manual.ssi:97
-#: en/about_manual.ssi:112 en/about_manual.ssi:125 en/about_manual.ssi:133
-#: en/about_manual.ssi:141 en/about_manual.ssi:149 en/about_manual.ssi:156
-#: en/other_basics.ssi:38 en/other_basics.ssi:49 en/other_basics.ssi:62
-#: en/other_basics.ssi:72 en/other_basics.ssi:111 en/other_basics.ssi:124
-#: en/other_basics.ssi:132 en/other_basics.ssi:140 en/other_basics.ssi:150
-#: en/other_basics.ssi:162 en/other_basics.ssi:180 en/other_basics.ssi:188
-#: en/other_basics.ssi:196 en/other_basics.ssi:212 en/other_basics.ssi:220
-#: en/other_basics.ssi:230 en/other_basics.ssi:293 en/other_basics.ssi:305
-#: en/other_basics.ssi:321 en/other_basics.ssi:329 en/other_basics.ssi:372
-#: en/other_basics.ssi:397 en/other_coding-style.ssi:34
-#: en/other_coding-style.ssi:45 en/other_coding-style.ssi:57
-#: en/other_coding-style.ssi:68 en/other_coding-style.ssi:92
-#: en/other_coding-style.ssi:100 en/other_coding-style.ssi:113
-#: en/other_coding-style.ssi:124 en/other_common-tasks.ssi:36
-#: en/other_customization-backports.ssi:16
-#: en/other_customization-bootup.ssi:35 en/other_customization-bootup.ssi:48
-#: en/other_customization-contents.ssi:35
-#: en/other_customization-contents.ssi:50
-#: en/other_customization-internationalization.ssi:14
-#: en/other_customization-internationalization.ssi:22
-#: en/other_customization-internationalization.ssi:30
-#: en/other_customization-internationalization.ssi:38
-#: en/other_customization-internationalization.ssi:50
-#: en/other_customization-packages.ssi:20
-#: en/other_customization-packages.ssi:28
-#: en/other_customization-packages.ssi:38
-#: en/other_customization-packages.ssi:47
-#: en/other_customization-packages.ssi:59
-#: en/other_customization-packages.ssi:95
-#: en/other_customization-packages.ssi:103
-#: en/other_customization-packages.ssi:152
-#: en/other_customization-packages.ssi:162
-#: en/other_customization-packages.ssi:172
-#: en/other_customization-packages.ssi:182 en/other_faq.ssi:37
-#: en/other_faq.ssi:46 en/other_faq.ssi:92 en/other_faq.ssi:108
-#: en/other_faq.ssi:141 en/other_faq.ssi:155 en/other_faq.ssi:207
-#: en/other_faq.ssi:256 en/other_faq.ssi:292 en/other_faq.ssi:307
-#: en/other_faq.ssi:319 en/other_faq.ssi:337 en/other_faq.ssi:349
-#: en/other_faq.ssi:358 en/other_faq.ssi:370 en/other_faq.ssi:381
-#: en/other_howtos.ssi:20 en/other_howtos.ssi:47 en/other_installation.ssi:44
-#: en/other_installation.ssi:52 en/other_installation.ssi:62
-#: en/other_installation.ssi:74 en/other_installation.ssi:82
-#: en/other_installation.ssi:92 en/other_installation.ssi:113
-#: en/other_installation.ssi:128 en/other_installation.ssi:145
-#: en/other_installation.ssi:153 en/other_installation.ssi:161
-#: en/other_live-environment.ssi:18 en/other_live-environment.ssi:34
-#: en/other_live-environment.ssi:55 en/other_live-environment.ssi:65
-#: en/other_live-environment.ssi:73 en/other_live-environment.ssi:81
-#: en/other_live-environment.ssi:89 en/other_live-environment.ssi:97
-#: en/other_live-environment.ssi:120 en/other_live-environment.ssi:129
-#: en/other_live-environment.ssi:138 en/other_overview.ssi:88
-#: en/other_overview.ssi:98 en/other_overview.ssi:106
-#: en/other_procedures.ssi:16 en/other_procedures.ssi:54
-#: en/other_procedures.ssi:131 en/other_use-cases.ssi:33
-#: en/other_use-cases.ssi:69 en/other_use-cases.ssi:97
-#: en/other_use-cases.ssi:107 en/other_use-cases.ssi:137
-msgid "}code"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:2
-msgid ":B~ Overview of tools"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:4
-msgid "1~ Overview of tools"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:6
-msgid ""
-"This chapter contains an overview of the two main tools used in building "
-"Debian Live systems."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:8
-msgid "2~ live-helper"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:10
-msgid ""
-"live-helper is a collection of scripts to build Debian Live systems. These "
-"scripts are also referred to as \"helpers\"."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:12
-msgid ""
-"The idea behind live-helper is to be a framework that uses a configuration "
-"directory to completely automate and customize all aspects of building a "
-"Live image."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:14
-msgid ""
-"Many concepts are similar to those in the debhelper Debian package tools "
-"written by Joey Hess:"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:16
-msgid ""
-"_* The scripts have a central location for configuring their operation. In "
-"debhelper, this is the debian subdirectory of a package tree. For example, "
-"dh_install will look for a file called #{debian/.install}# to determine "
-"which files should exist in a particular binary package. In much the same "
-"way, live-helper stores its configuration entirely under a config "
-"subdirectory."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:18
-msgid ""
-"_* The scripts are independent - that is to say, it is always safe to run "
-"each command."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:21
-msgid ""
-"Unlike debhelper, live-helper contains a tool to generate a skeleton "
-"configuration directory, lh config. This could be considered to be similar "
-"to tools such as dh-make. For more information about lh config, please see "
-"lh-config.  % FIXME: <xref linkend=\"lh-config\"/>"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:23
-msgid ""
-"Besides the common config/common, which is used by all live-helper helper "
-"commands, some additional files can be used to configure the behavior of "
-"specific helper commands. These files are typically named config/helper or "
-"config/stage (where \"stage\", of course, is replaced with the name of the "
-"stage that they belong to, and \"helper\" with the name of the helper)."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:25
-msgid ""
-"For example, the lh bootstrap debootstrap helper command uses files named "
-"config/bootstrap and config/bootstrap_debootstrap to read the options it "
-"will use. Generally, these files contain variables with values assigned, one "
-"variable per line. Some programs in live-helper use pairs of values or "
-"slightly more complicated variable assignments."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:27
-msgid ""
-"live-helper 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), live-helper will automatically set it to a "
-"default value."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:29
-msgid ""
-"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."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:31
-msgid ""
-"In some rare cases you may want to have different versions of these files "
-"for different architectures or distributions. If files named config/stage."
-"arch or config/stage_helper.arch, and config/stage.dist or config/"
-"stage_helper.dist exist (where \"arch\" is the same as the output of dpkg --"
-"print-architecture 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."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:34
-msgid ""
-"Please see installation for information on how to install live-helper.  % "
-"FIXME: <xref linkend=\"installation\"/>"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:36
-msgid ""
-"The remainder of this section discusses the three most important helpers:"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:39
-msgid ""
-"_* *{lh config}*: Responsible for initialising a Live system configuration "
-"directory. See lh-config for more information.  % FIXME: <xref linkend=\"lh-"
-"config\"/>"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:42
-msgid ""
-"_* *{lh build}*: Responsible for starting a Live system build. See lh-build "
-"for more information.  % FIXME: <xref linkend=\"lh-build\"/>"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:45
-msgid ""
-"_* *{lh clean}*: Responsible for removing parts of a Live system build. See "
-"lh-clean for more information.  % FIXME: <xref linkend=\"lh-clean\"/"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:47
-msgid "3~ The lh config helper"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:50
-msgid ""
-"As discussed in live-helper, the scripts that make up live-helper source "
-"their configuration from a single directory named config/. As constructing "
-"this directory by hand would be time-consuming and error-prone, the lh "
-"config helper can be used to create skeleton configuration folders.  % "
-"FIXME: <xref linkend=\"live-helper\"/>"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:52
-msgid ""
-"Issuing lh config without any arguments creates a config subdirectory which "
-"it populates with some default settings:"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:86
-msgid ""
-"$ 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 104 -rw-r--r-- 1 user group 4175 "
-"2010-04-11 12:16 binary drwxr-xr-x 2 user group 4096 2010-04-11 12:16 "
-"binary_debian-installer drwxr-xr-x 2 user group 4096 2010-04-11 12:16 "
-"binary_debian-installer-includes drwxr-xr-x 2 user group 4096 2010-04-11 "
-"12:16 binary_grub drwxr-xr-x 2 user group 4096 2010-04-11 12:16 binary_local-"
-"debs drwxr-xr-x 2 user group 4096 2010-04-11 12:16 binary_local-hooks drwxr-"
-"xr-x 2 user group 4096 2010-04-11 12:16 binary_local-includes drwxr-xr-x 2 "
-"user group 4096 2010-04-11 12:16 binary_local-packageslists drwxr-xr-x 2 "
-"user group 4096 2010-04-11 12:16 binary_local-udebs drwxr-xr-x 2 user group "
-"4096 2010-04-11 12:16 binary_rootfs drwxr-xr-x 2 user group 4096 2010-04-11 "
-"12:16 binary_syslinux -rw-r--r-- 1 user group 2205 2010-04-11 12:16 "
-"bootstrap -rw-r--r-- 1 user group 1599 2010-04-11 12:16 chroot drwxr-xr-x 2 "
-"user group 4096 2010-04-11 12:16 chroot_apt drwxr-xr-x 2 user group 4096 "
-"2010-04-11 12:16 chroot_local-hooks drwxr-xr-x 2 user group 4096 2010-04-11 "
-"12:16 chroot_local-includes drwxr-xr-x 2 user group 4096 2010-04-11 12:16 "
-"chroot_local-packages drwxr-xr-x 2 user group 4096 2010-04-11 12:16 "
-"chroot_local-packageslists drwxr-xr-x 2 user group 4096 2010-04-11 12:16 "
-"chroot_local-patches drwxr-xr-x 2 user group 4096 2010-04-11 12:16 "
-"chroot_local-preseed drwxr-xr-x 2 user group 4096 2010-04-11 12:16 "
-"chroot_sources -rw-r--r-- 1 user group 2938 2010-04-11 12:16 common drwxr-xr-"
-"x 2 user group 4096 2010-04-11 12:16 includes -rw-r--r-- 1 user group 206 "
-"2010-04-11 12:16 source drwxr-xr-x 2 user group 4096 2010-04-11 12:16 "
-"templates"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:90
-msgid ""
-"Using lh config 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."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:92
-msgid ""
-"You can ask lh config to generate a config/ 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:"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:96
-msgid "$ lh config -p gnome"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:100
-msgid ""
-"will build a config/ directory configured to include the 'gnome' package "
-"list. It is possible to specify many options:"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:104
-msgid ""
-"$ lh config --apt aptitude --binary-images net --hostname live-machine --"
-"username live-user ..."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:108
-msgid ""
-"A full list of options is available in the lh_config man page. Most options "
-"have a parallel with an \"LH_\" prefixed variable."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:110
-msgid "3~ The lh build helper"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:112
-msgid ""
-"The lh build helper reads in your configuration from the config/ directory. "
-"It then runs the lower lower level commands needed to build your Live system."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:114
-msgid "3~ The lh clean helper"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:116
-msgid ""
-"It is the job of the lh clean helper to remove various parts of a Live "
-"helper build so subsequent builds can start from a clean state."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:118
-msgid "2~ The live-initramfs package"
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:120
-msgid ""
-"live-initramfs is a collection of scripts providing hooks for the initramfs-"
-"tools, used to generate an initramfs capable of booting live systems, such "
-"as those created by live-helper. This includes the Debian Live isos, netboot "
-"tarballs, and usb stick images."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:122
-msgid ""
-"At boot time it will look for read-only media containing a \"/live\" "
-"directory where a root filesystem (often a compressed filesystem image like "
-"squashfs) is stored. If found, it will create a writable environment, using "
-"aufs or unionfs, for Debian like systems to boot from."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:124
-msgid "live-initramfs is a fork of casper, http://packages.ubuntu.com/casper."
-msgstr ""
-
-#. type: Plain text
-#: en/other_overview.ssi:125
-msgid ""
-"More information on initial ramfs in Debian can be found in the Debian Linux "
-"Kernel Handbook at http://kernel-handbook.alioth.debian.org/ in the chapter "
-"on initramfs."
-msgstr ""
diff --git a/manual/po/de/user_overview.ssi.po b/manual/po/de/user_overview.ssi.po
new file mode 100644
index 0000000..35702b3
--- /dev/null
+++ b/manual/po/de/user_overview.ssi.po
@@ -0,0 +1,449 @@
+# German translations for live-manual package
+# Copyright (C) 2010 Free Software Foundation, Inc.
+# This file is distributed under the same license as the live-manual package.
+# Automatically generated, 2010.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: live-manual VERSION\n"
+"POT-Creation-Date: 2010-09-07 15:15+0300\n"
+"PO-Revision-Date: 2010-09-07 15:15+0300\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"Language: de\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#. type: Plain text
+#: en/about_manual.ssi:81 en/about_manual.ssi:89 en/about_manual.ssi:97
+#: en/about_manual.ssi:109 en/about_manual.ssi:120 en/about_manual.ssi:133
+#: en/about_manual.ssi:141 en/about_manual.ssi:149 en/about_manual.ssi:157
+#: en/other_coding-style.ssi:28 en/other_coding-style.ssi:38
+#: en/other_coding-style.ssi:51 en/other_coding-style.ssi:61
+#: en/other_coding-style.ssi:88 en/other_coding-style.ssi:96
+#: en/other_coding-style.ssi:106 en/other_coding-style.ssi:117
+#: en/other_common-tasks.ssi:32 en/other_customization-backports.ssi:8
+#: en/other_customization-bootup.ssi:30 en/other_customization-bootup.ssi:39
+#: en/other_customization-contents.ssi:30
+#: en/other_customization-contents.ssi:39
+#: en/other_customization-internationalization.ssi:10
+#: en/other_customization-internationalization.ssi:18
+#: en/other_customization-internationalization.ssi:26
+#: en/other_customization-internationalization.ssi:34
+#: en/other_customization-internationalization.ssi:46
+#: en/other_customization-packages.ssi:16
+#: en/other_customization-packages.ssi:24
+#: en/other_customization-packages.ssi:34
+#: en/other_customization-packages.ssi:42
+#: en/other_customization-packages.ssi:55
+#: en/other_customization-packages.ssi:91
+#: en/other_customization-packages.ssi:99
+#: en/other_customization-packages.ssi:146
+#: en/other_customization-packages.ssi:156
+#: en/other_customization-packages.ssi:166
+#: en/other_customization-packages.ssi:176 en/other_faq.ssi:41
+#: en/other_faq.ssi:83 en/other_faq.ssi:103 en/other_faq.ssi:117
+#: en/other_faq.ssi:137 en/other_faq.ssi:151 en/other_faq.ssi:198
+#: en/other_faq.ssi:245 en/other_faq.ssi:261 en/other_faq.ssi:287
+#: en/other_faq.ssi:299 en/other_faq.ssi:314 en/other_faq.ssi:333
+#: en/other_faq.ssi:345 en/other_faq.ssi:353 en/other_faq.ssi:364
+#: en/other_faq.ssi:374 en/other_howtos.ssi:16 en/other_howtos.ssi:43
+#: en/other_live-environment.ssi:14 en/other_live-environment.ssi:30
+#: en/other_live-environment.ssi:51 en/other_live-environment.ssi:61
+#: en/other_live-environment.ssi:69 en/other_live-environment.ssi:77
+#: en/other_live-environment.ssi:85 en/other_live-environment.ssi:93
+#: en/other_live-environment.ssi:116 en/other_live-environment.ssi:124
+#: en/other_live-environment.ssi:133 en/other_procedures.ssi:12
+#: en/other_procedures.ssi:46 en/other_procedures.ssi:58
+#: en/other_use-cases.ssi:24 en/other_use-cases.ssi:49
+#: en/other_use-cases.ssi:75 en/other_use-cases.ssi:103
+#: en/other_use-cases.ssi:111 en/user_basics.ssi:34 en/user_basics.ssi:45
+#: en/user_basics.ssi:58 en/user_basics.ssi:70 en/user_basics.ssi:84
+#: en/user_basics.ssi:99 en/user_basics.ssi:107 en/user_basics.ssi:115
+#: en/user_basics.ssi:125 en/user_basics.ssi:137 en/user_basics.ssi:149
+#: en/user_basics.ssi:157 en/user_basics.ssi:165 en/user_basics.ssi:179
+#: en/user_basics.ssi:187 en/user_basics.ssi:197 en/user_basics.ssi:249
+#: en/user_basics.ssi:265 en/user_basics.ssi:273 en/user_basics.ssi:293
+#: en/user_basics.ssi:318 en/user_installation.ssi:38
+#: en/user_installation.ssi:46 en/user_installation.ssi:56
+#: en/user_installation.ssi:64 en/user_installation.ssi:76
+#: en/user_installation.ssi:84 en/user_installation.ssi:104
+#: en/user_installation.ssi:118 en/user_installation.ssi:134
+#: en/user_overview.ssi:54 en/user_overview.ssi:98 en/user_overview.ssi:106
+msgid "code{"
+msgstr ""
+
+#. type: Plain text
+#: en/about_manual.ssi:85 en/about_manual.ssi:93 en/about_manual.ssi:101
+#: en/about_manual.ssi:116 en/about_manual.ssi:129 en/about_manual.ssi:137
+#: en/about_manual.ssi:145 en/about_manual.ssi:153 en/about_manual.ssi:160
+#: en/other_coding-style.ssi:34 en/other_coding-style.ssi:45
+#: en/other_coding-style.ssi:57 en/other_coding-style.ssi:68
+#: en/other_coding-style.ssi:92 en/other_coding-style.ssi:100
+#: en/other_coding-style.ssi:113 en/other_coding-style.ssi:124
+#: en/other_common-tasks.ssi:36 en/other_customization-backports.ssi:16
+#: en/other_customization-bootup.ssi:35 en/other_customization-bootup.ssi:48
+#: en/other_customization-contents.ssi:35
+#: en/other_customization-contents.ssi:50
+#: en/other_customization-internationalization.ssi:14
+#: en/other_customization-internationalization.ssi:22
+#: en/other_customization-internationalization.ssi:30
+#: en/other_customization-internationalization.ssi:38
+#: en/other_customization-internationalization.ssi:50
+#: en/other_customization-packages.ssi:20
+#: en/other_customization-packages.ssi:28
+#: en/other_customization-packages.ssi:38
+#: en/other_customization-packages.ssi:47
+#: en/other_customization-packages.ssi:59
+#: en/other_customization-packages.ssi:95
+#: en/other_customization-packages.ssi:103
+#: en/other_customization-packages.ssi:152
+#: en/other_customization-packages.ssi:162
+#: en/other_customization-packages.ssi:172
+#: en/other_customization-packages.ssi:182 en/other_faq.ssi:37
+#: en/other_faq.ssi:46 en/other_faq.ssi:92 en/other_faq.ssi:108
+#: en/other_faq.ssi:141 en/other_faq.ssi:155 en/other_faq.ssi:207
+#: en/other_faq.ssi:256 en/other_faq.ssi:292 en/other_faq.ssi:307
+#: en/other_faq.ssi:319 en/other_faq.ssi:337 en/other_faq.ssi:349
+#: en/other_faq.ssi:358 en/other_faq.ssi:370 en/other_faq.ssi:381
+#: en/other_howtos.ssi:20 en/other_howtos.ssi:47
+#: en/other_live-environment.ssi:18 en/other_live-environment.ssi:34
+#: en/other_live-environment.ssi:55 en/other_live-environment.ssi:65
+#: en/other_live-environment.ssi:73 en/other_live-environment.ssi:81
+#: en/other_live-environment.ssi:89 en/other_live-environment.ssi:97
+#: en/other_live-environment.ssi:120 en/other_live-environment.ssi:129
+#: en/other_live-environment.ssi:138 en/other_procedures.ssi:16
+#: en/other_procedures.ssi:54 en/other_procedures.ssi:131
+#: en/other_use-cases.ssi:33 en/other_use-cases.ssi:69
+#: en/other_use-cases.ssi:97 en/other_use-cases.ssi:107
+#: en/other_use-cases.ssi:137 en/user_basics.ssi:38 en/user_basics.ssi:49
+#: en/user_basics.ssi:64 en/user_basics.ssi:74 en/user_basics.ssi:90
+#: en/user_basics.ssi:103 en/user_basics.ssi:111 en/user_basics.ssi:119
+#: en/user_basics.ssi:129 en/user_basics.ssi:143 en/user_basics.ssi:153
+#: en/user_basics.ssi:161 en/user_basics.ssi:169 en/user_basics.ssi:183
+#: en/user_basics.ssi:191 en/user_basics.ssi:201 en/user_basics.ssi:241
+#: en/user_basics.ssi:269 en/user_basics.ssi:277 en/user_basics.ssi:304
+#: en/user_basics.ssi:343 en/user_installation.ssi:42
+#: en/user_installation.ssi:50 en/user_installation.ssi:60
+#: en/user_installation.ssi:72 en/user_installation.ssi:80
+#: en/user_installation.ssi:108 en/user_installation.ssi:123
+#: en/user_installation.ssi:137 en/user_overview.ssi:92
+#: en/user_overview.ssi:102 en/user_overview.ssi:110
+msgid "}code"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:2
+msgid ":B~ Overview of tools"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:4
+msgid "1~ Overview of tools"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:6
+msgid ""
+"This chapter contains an overview of the two main tools used in building "
+"Debian Live systems."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:8
+msgid "2~ live-build"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:10
+msgid ""
+"live-build is a collection of scripts to build Debian Live systems. These "
+"scripts are also referred to as \"commands\"."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:12
+msgid ""
+"The idea behind live-build is to be a framework that uses a configuration "
+"directory to completely automate and customize all aspects of building a "
+"Live image."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:14
+msgid ""
+"Many concepts are similar to those in the debhelper Debian package tools "
+"written by Joey Hess:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:16
+msgid ""
+"_* The scripts have a central location for configuring their operation. In "
+"debhelper, this is the debian subdirectory of a package tree. For example, "
+"dh_install will look, amongst others, for a file called #{debian/install}# "
+"to determine which files should exist in a particular binary package. In "
+"much the same way, live-build stores its configuration entirely under a "
+"config subdirectory."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:18
+msgid ""
+"_* The scripts are independent - that is to say, it is always safe to run "
+"each command."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:21
+msgid ""
+"Unlike debhelper, live-build contains a tool to generate a skeleton "
+"configuration directory, #{lb config}#. This could be considered to be "
+"similar to tools such as #{dh-make}#. For more information about #{lb config}"
+"#, please see lb-config.  % FIXME: <xref linkend=\"lb-config\"/>"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:23
+msgid ""
+"Besides the common config/common, which is used by all live-build commands, "
+"some additional files can be used to configure the behavior of specific "
+"helper commands. These files are typically named config/command or config/"
+"stage (where \"stage\", of course, is replaced with the name of the stage "
+"that they belong to, and \"command\" with the name of the command)."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:25
+msgid ""
+"For example, the #{lb_bootstrap_debootstrap}# command uses files named "
+"config/bootstrap and config/bootstrap_debootstrap to read the options it "
+"will use. Generally, these files contain variables with values assigned, one "
+"variable per line. Some commands of live-buil use pairs of values or "
+"slightly more complicated variable assignments."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:27
+msgid ""
+"live-build 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), live-build will automatically set it to a "
+"default value."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:29
+msgid ""
+"All config files are shell scripts which are sourced by a live-build "
+"command. That means they have to follow the normal shell syntax. You can "
+"also put comments in these files; lines beginning with \"#\" are ignored."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:31
+msgid ""
+"In some rare cases you may want to have different versions of these files "
+"for different architectures or distributions. If files named config/stage."
+"arch or config/stage_command.arch, and config/stage.dist or config/"
+"stage_command.dist exist (where \"arch\" is the same as the output of dpkg --"
+"print-architecture 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."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:34
+msgid ""
+"Please see installation for information on how to install live-build.  % "
+"FIXME: <xref linkend=\"installation\"/>"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:36
+msgid ""
+"The remainder of this section discusses the three most important commands:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:39
+msgid ""
+"_* *{lb config}*: Responsible for initialising a Live system configuration "
+"directory. See lb-config for more information.  % FIXME: <xref linkend=\"lb-"
+"config\"/>"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:42
+msgid ""
+"_* *{lb build}*: Responsible for starting a Live system build. See lb-build "
+"for more information.  % FIXME: <xref linkend=\"lb-build\"/>"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:45
+msgid ""
+"_* *{lb clean}*: Responsible for removing parts of a Live system build. See "
+"lb-clean for more information.  % FIXME: <xref linkend=\"lb-clean\"/"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:47
+msgid "3~ The #{lb config}# command"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:50
+msgid ""
+"As discussed in live-build, the scripts that make up live-build source their "
+"configuration from a single directory named config/. As constructing this "
+"directory by hand would be time-consuming and error-prone, the #{lb config}# "
+"command can be used to create skeleton configuration folders.  % FIXME: "
+"<xref linkend=\"live-build\"/>"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:52
+msgid ""
+"Issuing #{lb config}# without any arguments creates a config subdirectory "
+"which it populates with some default settings:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:57
+msgid "$ lb config P: Creating config tree"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:62
+msgid ""
+"$ ls -l total 8 drwxr-xr-x 3 user user 4096 Sep 7 13:02 auto drwxr-xr-x 22 "
+"user user 4096 Sep 7 13:02 config"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:90
+msgid ""
+"$ ls -l config/ total 104 -rw-r--r-- 1 user user 4197 Sep 7 13:02 binary "
+"drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_debian-installer drwxr-xr-x 2 "
+"user user 4096 Sep 7 13:02 binary_debian-installer-includes drwxr-xr-x 2 "
+"user user 4096 Sep 7 13:02 binary_grub drwxr-xr-x 2 user user 4096 Sep 7 "
+"13:02 binary_local-debs drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_local-"
+"hooks drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_local-includes drwxr-xr-"
+"x 2 user user 4096 Sep 7 13:02 binary_local-packageslists drwxr-xr-x 2 user "
+"user 4096 Sep 7 13:02 binary_local-udebs drwxr-xr-x 2 user user 4096 Sep 7 "
+"13:02 binary_rootfs drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_syslinux -"
+"rw-r--r-- 1 user user 2051 Sep 7 13:02 bootstrap -rw-r--r-- 1 user user 1647 "
+"Sep 7 13:02 chroot drwxr-xr-x 2 user user 4096 Sep 7 13:02 chroot_apt drwxr-"
+"xr-x 2 user user 4096 Sep 7 13:02 chroot_local-hooks drwxr-xr-x 2 user user "
+"4096 Sep 7 13:02 chroot_local-includes drwxr-xr-x 2 user user 4096 Sep 7 "
+"13:02 chroot_local-packages drwxr-xr-x 2 user user 4096 Sep 7 13:02 "
+"chroot_local-packageslists drwxr-xr-x 2 user user 4096 Sep 7 13:02 "
+"chroot_local-patches drwxr-xr-x 2 user user 4096 Sep 7 13:02 chroot_local-"
+"preseed drwxr-xr-x 2 user user 4096 Sep 7 13:02 chroot_sources -rw-r--r-- 1 "
+"user user 2954 Sep 7 13:02 common drwxr-xr-x 2 user user 4096 Sep 7 13:02 "
+"includes -rw-r--r-- 1 user user 205 Sep 7 13:02 source drwxr-xr-x 2 user "
+"user 4096 Sep 7 13:02 templates"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:94
+msgid ""
+"Using #{lb config}# 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."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:96
+msgid ""
+"You can ask #{lb config}# to generate a config/ 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:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:100
+msgid "$ lb config -p gnome"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:104
+msgid ""
+"will build a config/ directory configured to include the 'gnome' package "
+"list. It is possible to specify many options:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:108
+msgid ""
+"$ lb config --binary-images net --hostname live-machine --username live-"
+"user ..."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:112
+msgid ""
+"A full list of options is available in the #{lb_config}# man page. Most "
+"options have a parallel with an \"LB_\" prefixed variable."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:114
+msgid "3~ The #{lb build}# command"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:116
+msgid ""
+"The #{lb build}# command reads in your configuration from the config/ "
+"directory. It then runs the lower lower level commands needed to build your "
+"Live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:118
+msgid "3~ The #{lb clean}# command"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:120
+msgid ""
+"It is the job of the #{lb clean}# command to remove various parts of a build "
+"so subsequent builds can start from a clean state."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:122
+msgid "2~ The live-boot package"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:124
+msgid ""
+"live-boot is a collection of scripts providing hooks for the initramfs-"
+"tools, used to generate an initramfs capable of booting live systems, such "
+"as those created by live-build. This includes the Debian Live isos, netboot "
+"tarballs, and usb stick images."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:126
+msgid ""
+"At boot time it will look for read-only media containing a \"/live\" "
+"directory where a root filesystem (often a compressed filesystem image like "
+"squashfs) is stored. If found, it will create a writable environment, using "
+"aufs, for Debian like systems to boot from."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:127
+msgid ""
+"More information on initial ramfs in Debian can be found in the Debian Linux "
+"Kernel Handbook at http://kernel-handbook.alioth.debian.org/ in the chapter "
+"on initramfs."
+msgstr ""
diff --git a/manual/po4a.cfg b/manual/po4a.cfg
index 91f322d..e7b5f18 100644
--- a/manual/po4a.cfg
+++ b/manual/po4a.cfg
@@ -16,7 +16,6 @@
 [type: text] en/other_faq.ssi $lang:$lang/other_faq.ssi
 [type: text] en/other_howtos.ssi $lang:$lang/other_howtos.ssi
 [type: text] en/other_live-environment.ssi $lang:$lang/other_live-environment.ssi
-[type: text] en/other_overview.ssi $lang:$lang/other_overview.ssi
 [type: text] en/other_procedures.ssi $lang:$lang/other_procedures.ssi
 [type: text] en/other_reporting-bugs.ssi $lang:$lang/other_reporting-bugs.ssi
 [type: text] en/other_resources.ssi $lang:$lang/other_resources.ssi
@@ -25,4 +24,5 @@
 [type: text] en/other_use-cases.ssi $lang:$lang/other_use-cases.ssi
 [type: text] en/user_basics.ssi $lang:$lang/user_basics.ssi
 [type: text] en/user_installation.ssi $lang:$lang/user_installation.ssi
+[type: text] en/user_overview.ssi $lang:$lang/user_overview.ssi
 [type: xhtml] en/index.html.in $lang:$lang/index.html.in
diff --git a/manual/pot/live-manual.ssm.pot b/manual/pot/live-manual.ssm.pot
index 455801a..47f8b34 100644
--- a/manual/pot/live-manual.ssm.pot
+++ b/manual/pot/live-manual.ssm.pot
@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-09-07 14:53+0300\n"
+"POT-Creation-Date: 2010-09-07 15:15+0300\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
 "Language-Team: LANGUAGE <LL at li.org>\n"
@@ -90,121 +90,116 @@ msgid ":B~ User ~#"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:34
-msgid "<< user_installation.ssi << user_basics.ssi"
+#: en/live-manual.ssm:35
+msgid "<< user_installation.ssi << user_basics.ssi << user_overview.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:36
+#: en/live-manual.ssm:37
 msgid ":B~ Development ~#"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:38
+#: en/live-manual.ssm:39
 msgid ":B~ Project ~#"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:40
+#: en/live-manual.ssm:41
 msgid ":B~ Other ~#"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:42
-msgid "<< other_overview.ssi"
-msgstr ""
-
-#. type: Plain text
-#: en/live-manual.ssm:44
+#: en/live-manual.ssm:43
 msgid "<< other_customization-packages.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:46
+#: en/live-manual.ssm:45
 msgid "<< other_customization-contents.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:48
+#: en/live-manual.ssm:47
 msgid "<< other_customization-internationalization.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:50
+#: en/live-manual.ssm:49
 msgid "<< other_customization-bootup.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:52
+#: en/live-manual.ssm:51
 msgid "<< other_customization-binary.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:54
+#: en/live-manual.ssm:53
 msgid "<< other_customization-backports.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:56
+#: en/live-manual.ssm:55
 msgid "<< other_common-tasks.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:58
+#: en/live-manual.ssm:57
 msgid "<< other_live-environment.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:60
+#: en/live-manual.ssm:59
 msgid "<< other_faq.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:62
+#: en/live-manual.ssm:61
 msgid "<< other_reporting-bugs.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:64
+#: en/live-manual.ssm:63
 msgid "<< other_howtos.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:66
+#: en/live-manual.ssm:65
 msgid "<< other_coding-style.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:68
+#: en/live-manual.ssm:67
 msgid "<< other_procedures.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:70
+#: en/live-manual.ssm:69
 msgid "<< other_resources.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:72
+#: en/live-manual.ssm:71
 msgid "<< other_use-cases.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:74
+#: en/live-manual.ssm:73
 msgid "<< other_success-stories.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:76
+#: en/live-manual.ssm:75
 msgid "<< other_troubleshooting.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:78
+#: en/live-manual.ssm:77
 msgid "<< other_configuration-layout.ssi"
 msgstr ""
 
 #. type: Plain text
-#: en/live-manual.ssm:79
+#: en/live-manual.ssm:78
 msgid "<< other_configuration-files.ssi"
 msgstr ""
diff --git a/manual/pot/user_overview.ssi.pot b/manual/pot/user_overview.ssi.pot
new file mode 100644
index 0000000..a04c3ac
--- /dev/null
+++ b/manual/pot/user_overview.ssi.pot
@@ -0,0 +1,449 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the live-manual package.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: live-manual VERSION\n"
+"POT-Creation-Date: 2010-09-07 15:15+0300\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. type: Plain text
+#: en/about_manual.ssi:81 en/about_manual.ssi:89 en/about_manual.ssi:97
+#: en/about_manual.ssi:109 en/about_manual.ssi:120 en/about_manual.ssi:133
+#: en/about_manual.ssi:141 en/about_manual.ssi:149 en/about_manual.ssi:157
+#: en/other_coding-style.ssi:28 en/other_coding-style.ssi:38
+#: en/other_coding-style.ssi:51 en/other_coding-style.ssi:61
+#: en/other_coding-style.ssi:88 en/other_coding-style.ssi:96
+#: en/other_coding-style.ssi:106 en/other_coding-style.ssi:117
+#: en/other_common-tasks.ssi:32 en/other_customization-backports.ssi:8
+#: en/other_customization-bootup.ssi:30 en/other_customization-bootup.ssi:39
+#: en/other_customization-contents.ssi:30
+#: en/other_customization-contents.ssi:39
+#: en/other_customization-internationalization.ssi:10
+#: en/other_customization-internationalization.ssi:18
+#: en/other_customization-internationalization.ssi:26
+#: en/other_customization-internationalization.ssi:34
+#: en/other_customization-internationalization.ssi:46
+#: en/other_customization-packages.ssi:16
+#: en/other_customization-packages.ssi:24
+#: en/other_customization-packages.ssi:34
+#: en/other_customization-packages.ssi:42
+#: en/other_customization-packages.ssi:55
+#: en/other_customization-packages.ssi:91
+#: en/other_customization-packages.ssi:99
+#: en/other_customization-packages.ssi:146
+#: en/other_customization-packages.ssi:156
+#: en/other_customization-packages.ssi:166
+#: en/other_customization-packages.ssi:176 en/other_faq.ssi:41
+#: en/other_faq.ssi:83 en/other_faq.ssi:103 en/other_faq.ssi:117
+#: en/other_faq.ssi:137 en/other_faq.ssi:151 en/other_faq.ssi:198
+#: en/other_faq.ssi:245 en/other_faq.ssi:261 en/other_faq.ssi:287
+#: en/other_faq.ssi:299 en/other_faq.ssi:314 en/other_faq.ssi:333
+#: en/other_faq.ssi:345 en/other_faq.ssi:353 en/other_faq.ssi:364
+#: en/other_faq.ssi:374 en/other_howtos.ssi:16 en/other_howtos.ssi:43
+#: en/other_live-environment.ssi:14 en/other_live-environment.ssi:30
+#: en/other_live-environment.ssi:51 en/other_live-environment.ssi:61
+#: en/other_live-environment.ssi:69 en/other_live-environment.ssi:77
+#: en/other_live-environment.ssi:85 en/other_live-environment.ssi:93
+#: en/other_live-environment.ssi:116 en/other_live-environment.ssi:124
+#: en/other_live-environment.ssi:133 en/other_procedures.ssi:12
+#: en/other_procedures.ssi:46 en/other_procedures.ssi:58
+#: en/other_use-cases.ssi:24 en/other_use-cases.ssi:49
+#: en/other_use-cases.ssi:75 en/other_use-cases.ssi:103
+#: en/other_use-cases.ssi:111 en/user_basics.ssi:34 en/user_basics.ssi:45
+#: en/user_basics.ssi:58 en/user_basics.ssi:70 en/user_basics.ssi:84
+#: en/user_basics.ssi:99 en/user_basics.ssi:107 en/user_basics.ssi:115
+#: en/user_basics.ssi:125 en/user_basics.ssi:137 en/user_basics.ssi:149
+#: en/user_basics.ssi:157 en/user_basics.ssi:165 en/user_basics.ssi:179
+#: en/user_basics.ssi:187 en/user_basics.ssi:197 en/user_basics.ssi:249
+#: en/user_basics.ssi:265 en/user_basics.ssi:273 en/user_basics.ssi:293
+#: en/user_basics.ssi:318 en/user_installation.ssi:38
+#: en/user_installation.ssi:46 en/user_installation.ssi:56
+#: en/user_installation.ssi:64 en/user_installation.ssi:76
+#: en/user_installation.ssi:84 en/user_installation.ssi:104
+#: en/user_installation.ssi:118 en/user_installation.ssi:134
+#: en/user_overview.ssi:54 en/user_overview.ssi:98 en/user_overview.ssi:106
+msgid "code{"
+msgstr ""
+
+#. type: Plain text
+#: en/about_manual.ssi:85 en/about_manual.ssi:93 en/about_manual.ssi:101
+#: en/about_manual.ssi:116 en/about_manual.ssi:129 en/about_manual.ssi:137
+#: en/about_manual.ssi:145 en/about_manual.ssi:153 en/about_manual.ssi:160
+#: en/other_coding-style.ssi:34 en/other_coding-style.ssi:45
+#: en/other_coding-style.ssi:57 en/other_coding-style.ssi:68
+#: en/other_coding-style.ssi:92 en/other_coding-style.ssi:100
+#: en/other_coding-style.ssi:113 en/other_coding-style.ssi:124
+#: en/other_common-tasks.ssi:36 en/other_customization-backports.ssi:16
+#: en/other_customization-bootup.ssi:35 en/other_customization-bootup.ssi:48
+#: en/other_customization-contents.ssi:35
+#: en/other_customization-contents.ssi:50
+#: en/other_customization-internationalization.ssi:14
+#: en/other_customization-internationalization.ssi:22
+#: en/other_customization-internationalization.ssi:30
+#: en/other_customization-internationalization.ssi:38
+#: en/other_customization-internationalization.ssi:50
+#: en/other_customization-packages.ssi:20
+#: en/other_customization-packages.ssi:28
+#: en/other_customization-packages.ssi:38
+#: en/other_customization-packages.ssi:47
+#: en/other_customization-packages.ssi:59
+#: en/other_customization-packages.ssi:95
+#: en/other_customization-packages.ssi:103
+#: en/other_customization-packages.ssi:152
+#: en/other_customization-packages.ssi:162
+#: en/other_customization-packages.ssi:172
+#: en/other_customization-packages.ssi:182 en/other_faq.ssi:37
+#: en/other_faq.ssi:46 en/other_faq.ssi:92 en/other_faq.ssi:108
+#: en/other_faq.ssi:141 en/other_faq.ssi:155 en/other_faq.ssi:207
+#: en/other_faq.ssi:256 en/other_faq.ssi:292 en/other_faq.ssi:307
+#: en/other_faq.ssi:319 en/other_faq.ssi:337 en/other_faq.ssi:349
+#: en/other_faq.ssi:358 en/other_faq.ssi:370 en/other_faq.ssi:381
+#: en/other_howtos.ssi:20 en/other_howtos.ssi:47
+#: en/other_live-environment.ssi:18 en/other_live-environment.ssi:34
+#: en/other_live-environment.ssi:55 en/other_live-environment.ssi:65
+#: en/other_live-environment.ssi:73 en/other_live-environment.ssi:81
+#: en/other_live-environment.ssi:89 en/other_live-environment.ssi:97
+#: en/other_live-environment.ssi:120 en/other_live-environment.ssi:129
+#: en/other_live-environment.ssi:138 en/other_procedures.ssi:16
+#: en/other_procedures.ssi:54 en/other_procedures.ssi:131
+#: en/other_use-cases.ssi:33 en/other_use-cases.ssi:69
+#: en/other_use-cases.ssi:97 en/other_use-cases.ssi:107
+#: en/other_use-cases.ssi:137 en/user_basics.ssi:38 en/user_basics.ssi:49
+#: en/user_basics.ssi:64 en/user_basics.ssi:74 en/user_basics.ssi:90
+#: en/user_basics.ssi:103 en/user_basics.ssi:111 en/user_basics.ssi:119
+#: en/user_basics.ssi:129 en/user_basics.ssi:143 en/user_basics.ssi:153
+#: en/user_basics.ssi:161 en/user_basics.ssi:169 en/user_basics.ssi:183
+#: en/user_basics.ssi:191 en/user_basics.ssi:201 en/user_basics.ssi:241
+#: en/user_basics.ssi:269 en/user_basics.ssi:277 en/user_basics.ssi:304
+#: en/user_basics.ssi:343 en/user_installation.ssi:42
+#: en/user_installation.ssi:50 en/user_installation.ssi:60
+#: en/user_installation.ssi:72 en/user_installation.ssi:80
+#: en/user_installation.ssi:108 en/user_installation.ssi:123
+#: en/user_installation.ssi:137 en/user_overview.ssi:92
+#: en/user_overview.ssi:102 en/user_overview.ssi:110
+msgid "}code"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:2
+msgid ":B~ Overview of tools"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:4
+msgid "1~ Overview of tools"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:6
+msgid ""
+"This chapter contains an overview of the two main tools used in building "
+"Debian Live systems."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:8
+msgid "2~ live-build"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:10
+msgid ""
+"live-build is a collection of scripts to build Debian Live systems. These "
+"scripts are also referred to as \"commands\"."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:12
+msgid ""
+"The idea behind live-build is to be a framework that uses a configuration "
+"directory to completely automate and customize all aspects of building a "
+"Live image."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:14
+msgid ""
+"Many concepts are similar to those in the debhelper Debian package tools "
+"written by Joey Hess:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:16
+msgid ""
+"_* The scripts have a central location for configuring their operation. In "
+"debhelper, this is the debian subdirectory of a package tree. For example, "
+"dh_install will look, amongst others, for a file called #{debian/install}# "
+"to determine which files should exist in a particular binary package. In "
+"much the same way, live-build stores its configuration entirely under a "
+"config subdirectory."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:18
+msgid ""
+"_* The scripts are independent - that is to say, it is always safe to run "
+"each command."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:21
+msgid ""
+"Unlike debhelper, live-build contains a tool to generate a skeleton "
+"configuration directory, #{lb config}#. This could be considered to be "
+"similar to tools such as #{dh-make}#. For more information about #{lb config}"
+"#, please see lb-config.  % FIXME: <xref linkend=\"lb-config\"/>"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:23
+msgid ""
+"Besides the common config/common, which is used by all live-build commands, "
+"some additional files can be used to configure the behavior of specific "
+"helper commands. These files are typically named config/command or config/"
+"stage (where \"stage\", of course, is replaced with the name of the stage "
+"that they belong to, and \"command\" with the name of the command)."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:25
+msgid ""
+"For example, the #{lb_bootstrap_debootstrap}# command uses files named "
+"config/bootstrap and config/bootstrap_debootstrap to read the options it "
+"will use. Generally, these files contain variables with values assigned, one "
+"variable per line. Some commands of live-buil use pairs of values or "
+"slightly more complicated variable assignments."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:27
+msgid ""
+"live-build 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), live-build will automatically set it to a "
+"default value."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:29
+msgid ""
+"All config files are shell scripts which are sourced by a live-build "
+"command. That means they have to follow the normal shell syntax. You can "
+"also put comments in these files; lines beginning with \"#\" are ignored."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:31
+msgid ""
+"In some rare cases you may want to have different versions of these files "
+"for different architectures or distributions. If files named config/stage."
+"arch or config/stage_command.arch, and config/stage.dist or config/"
+"stage_command.dist exist (where \"arch\" is the same as the output of dpkg --"
+"print-architecture 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."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:34
+msgid ""
+"Please see installation for information on how to install live-build.  % "
+"FIXME: <xref linkend=\"installation\"/>"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:36
+msgid ""
+"The remainder of this section discusses the three most important commands:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:39
+msgid ""
+"_* *{lb config}*: Responsible for initialising a Live system configuration "
+"directory. See lb-config for more information.  % FIXME: <xref linkend=\"lb-"
+"config\"/>"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:42
+msgid ""
+"_* *{lb build}*: Responsible for starting a Live system build. See lb-build "
+"for more information.  % FIXME: <xref linkend=\"lb-build\"/>"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:45
+msgid ""
+"_* *{lb clean}*: Responsible for removing parts of a Live system build. See "
+"lb-clean for more information.  % FIXME: <xref linkend=\"lb-clean\"/"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:47
+msgid "3~ The #{lb config}# command"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:50
+msgid ""
+"As discussed in live-build, the scripts that make up live-build source their "
+"configuration from a single directory named config/. As constructing this "
+"directory by hand would be time-consuming and error-prone, the #{lb config}# "
+"command can be used to create skeleton configuration folders.  % FIXME: "
+"<xref linkend=\"live-build\"/>"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:52
+msgid ""
+"Issuing #{lb config}# without any arguments creates a config subdirectory "
+"which it populates with some default settings:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:57
+msgid "$ lb config P: Creating config tree"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:62
+msgid ""
+"$ ls -l total 8 drwxr-xr-x 3 user user 4096 Sep 7 13:02 auto drwxr-xr-x 22 "
+"user user 4096 Sep 7 13:02 config"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:90
+msgid ""
+"$ ls -l config/ total 104 -rw-r--r-- 1 user user 4197 Sep 7 13:02 binary "
+"drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_debian-installer drwxr-xr-x 2 "
+"user user 4096 Sep 7 13:02 binary_debian-installer-includes drwxr-xr-x 2 "
+"user user 4096 Sep 7 13:02 binary_grub drwxr-xr-x 2 user user 4096 Sep 7 "
+"13:02 binary_local-debs drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_local-"
+"hooks drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_local-includes drwxr-xr-"
+"x 2 user user 4096 Sep 7 13:02 binary_local-packageslists drwxr-xr-x 2 user "
+"user 4096 Sep 7 13:02 binary_local-udebs drwxr-xr-x 2 user user 4096 Sep 7 "
+"13:02 binary_rootfs drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_syslinux -"
+"rw-r--r-- 1 user user 2051 Sep 7 13:02 bootstrap -rw-r--r-- 1 user user 1647 "
+"Sep 7 13:02 chroot drwxr-xr-x 2 user user 4096 Sep 7 13:02 chroot_apt drwxr-"
+"xr-x 2 user user 4096 Sep 7 13:02 chroot_local-hooks drwxr-xr-x 2 user user "
+"4096 Sep 7 13:02 chroot_local-includes drwxr-xr-x 2 user user 4096 Sep 7 "
+"13:02 chroot_local-packages drwxr-xr-x 2 user user 4096 Sep 7 13:02 "
+"chroot_local-packageslists drwxr-xr-x 2 user user 4096 Sep 7 13:02 "
+"chroot_local-patches drwxr-xr-x 2 user user 4096 Sep 7 13:02 chroot_local-"
+"preseed drwxr-xr-x 2 user user 4096 Sep 7 13:02 chroot_sources -rw-r--r-- 1 "
+"user user 2954 Sep 7 13:02 common drwxr-xr-x 2 user user 4096 Sep 7 13:02 "
+"includes -rw-r--r-- 1 user user 205 Sep 7 13:02 source drwxr-xr-x 2 user "
+"user 4096 Sep 7 13:02 templates"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:94
+msgid ""
+"Using #{lb config}# 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."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:96
+msgid ""
+"You can ask #{lb config}# to generate a config/ 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:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:100
+msgid "$ lb config -p gnome"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:104
+msgid ""
+"will build a config/ directory configured to include the 'gnome' package "
+"list. It is possible to specify many options:"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:108
+msgid ""
+"$ lb config --binary-images net --hostname live-machine --username live-"
+"user ..."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:112
+msgid ""
+"A full list of options is available in the #{lb_config}# man page. Most "
+"options have a parallel with an \"LB_\" prefixed variable."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:114
+msgid "3~ The #{lb build}# command"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:116
+msgid ""
+"The #{lb build}# command reads in your configuration from the config/ "
+"directory. It then runs the lower lower level commands needed to build your "
+"Live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:118
+msgid "3~ The #{lb clean}# command"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:120
+msgid ""
+"It is the job of the #{lb clean}# command to remove various parts of a build "
+"so subsequent builds can start from a clean state."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:122
+msgid "2~ The live-boot package"
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:124
+msgid ""
+"live-boot is a collection of scripts providing hooks for the initramfs-"
+"tools, used to generate an initramfs capable of booting live systems, such "
+"as those created by live-build. This includes the Debian Live isos, netboot "
+"tarballs, and usb stick images."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:126
+msgid ""
+"At boot time it will look for read-only media containing a \"/live\" "
+"directory where a root filesystem (often a compressed filesystem image like "
+"squashfs) is stored. If found, it will create a writable environment, using "
+"aufs, for Debian like systems to boot from."
+msgstr ""
+
+#. type: Plain text
+#: en/user_overview.ssi:127
+msgid ""
+"More information on initial ramfs in Debian can be found in the Debian Linux "
+"Kernel Handbook at http://kernel-handbook.alioth.debian.org/ in the chapter "
+"on initramfs."
+msgstr ""

-- 
live-manual