[SCM] live-manual branch, debian, updated. debian/2.0_a9-1-21-gf14db5f

[Ben Armstrong]

The following commit has been merged in the debian branch:
commit f14db5f6ac94645e7ac93bca95607cea2263d62e
Author: Ben Armstrong <synrg at debian.org>
Date:   Sun Nov 7 15:35:21 2010 -0400

    Adding background in customization overview to refer to in packages customization.

diff --git a/manual/de/live-manual.ssm b/manual/de/live-manual.ssm
index 32a2301..9292332 100644
--- a/manual/de/live-manual.ssm
+++ b/manual/de/live-manual.ssm
@@ -9,7 +9,7 @@
  :license: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.<br><br>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.<br><br>You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/. <br><br>On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3 file.
 
 @date:
- :published: 2010-11-04
+ :published: 2010-11-07
 
 @publisher: Debian Live Project <debian-live at lists.debian.org>
 
diff --git a/manual/de/user_customization-overview.ssi b/manual/de/user_customization-overview.ssi
index 0871fe5..1900889 100644
--- a/manual/de/user_customization-overview.ssi
+++ b/manual/de/user_customization-overview.ssi
@@ -5,37 +5,68 @@ B~ Customizing contents
 This chapter gives an overview of the various ways in which you may
 customize a Debian Live system.
 
-It is important to understand the different layers of a Live system to know
-where configurations must occur, and particular, to know when they are
-applied. Of course, all configurations are in some way processed by
-live-build at build time, but some parts of setting up the Live system don't
-actually occur until boot time, either early in the boot by live-boot, or
-later by live-config. Thus, it is necessary to have a way to specify
-boot-time customizations. In particular, while most #{lb config}# options
-control aspects of the build, #{--bootappend-live}# will pass additional
-options through the kernel command line to set things up at boot time, such
-as persistence, keyboard layouts, or timezone.
-
-Therefore, in addition to the man pages included in live-build, you should
-keep near at hand the man pages for live-boot and live-config. Although the
-live-boot and live-config packages are installed within the live system you
-are building, it is recommended that you also install them on your build
-system for easy reference when you are working on your configuration. It is
-safe to do so, as none of the scripts contained within them are executed
-unless the system is configured as a live system.
-
-You should also be aware of the kinds of material that go into a Debian live
-configuration. Although #{lb config}# does create a skeletal configuration
-in the config/ directory, to accomplish your goals, you may need to provide
-additional files in subdirectories of config/. Depending on where the files
-are stored in the configuration, they may be copied into the live system's
-filesystem or into the binary image filesystem, or may provide build-time
+2~ Build time vs. boot time configuration
+
+Live system configuration options are divided into those that are applied at
+build time and those that are applied at boot time. Boot-time options are
+further divided into those occurring early in the boot, applied by the
+live-boot package, and those that happen later in the boot, applied by
+live-config. Any boot-time option may be modified by the user by specifying
+it at the boot prompt. The image may also be built with default boot
+parameters so users can normally just boot directly to the live system
+without specifying any options when all of the defaults are suitable. In
+particular, the argument to #{lb --bootappend-live}# consists of any default
+kernel command line options for the Live system, such as persistence,
+keyboard layouts, or timezone. See {Customizing locale and
+language}#customizing-locale-and-language, for example.
+
+Build-time configuration options are described in the #{lb config}# man
+page. Boot-time options are described in the man pages for live-boot and
+live-config. Although the live-boot and live-config packages are installed
+within the live system you are building, it is recommended that you also
+install them on your build system for easy reference when you are working on
+your configuration. It is safe to do so, as none of the scripts contained
+within them are executed unless the system is configured as a live system.
+
+2~stages-of-the-build Stages of the build
+
+The build process is divided into stages, with various customizations
+applied in sequence in each. The first stage to run is the *{bootstrap}*
+stage. This is the initial phase of populating the chroot directory with
+packages to make a barebones Debian system. This is followed by the
+*{chroot}* stage, which completes the construction of chroot directory,
+populating it with all of the packages listed in the configuration, along
+with any other materials. Most customization of content occurs in this
+stage. The final stage of preparing the live image is the *{binary}* stage,
+which builds a bootable image, using the contents of the chroot directory to
+construct the root filesystem for the Live system, and including the
+installer and any other additional material on the target media outside of
+the Live system's filesystem. After the live image is built, if enabled, the
+source tarball is built in the *{source}* stage.
+
+Within each of these stages, there is a particular sequence in which
+commands are applied. These are arranged in such a way as to ensure
+customizations can be layered in a reasonable fashion. For example, within
+the *{chroot}* stage, preseeds are applied before any packages are
+installed, packages are installed before any locally included files or
+patches are applied, and hooks are run later, after all of the materials are
+in place.
+
+2~ Supplement #{lb config}# with files
+
+Although #{lb config}# does create a skeletal configuration in the config/
+directory, to accomplish your goals, you may need to provide additional
+files in subdirectories of config/. Depending on where the files are stored
+in the configuration, they may be copied into the live system's filesystem
+or into the binary image filesystem, or may provide build-time
 configurations of the system that would be cumbersome to pass as
 command-line options. You may include things such as custom lists of
 packages, custom artwork, or hook scripts to run either at build time or at
 boot time, boosting the already considerable flexibility of debian-live with
 code of your own.
 
+2~ Customization tasks
+
 The following chapters are organized by the kinds of customization task
 users typically perform: {Customizing package
 installation}#customizing-package-installation, {Customizing
diff --git a/manual/de/user_customization-packages.ssi b/manual/de/user_customization-packages.ssi
index 29fb5eb..530d9eb 100644
--- a/manual/de/user_customization-packages.ssi
+++ b/manual/de/user_customization-packages.ssi
@@ -10,15 +10,26 @@ _* Installing modified packages
 
 3~ Debian repositories
 
-To set a local mirror (used to 'build' the live system)
+To set a local mirror to be used to at build time:
 
 code{
 
-$ lb config --mirror-bootstrap http://localhost/debian/ --mirror-chroot
-http://localhost/debian/
+$ lb config --mirror-bootstrap http://localhost/debian/
 
 }code
 
+The chroot repository, specified by --mirror-chroot, defaults to the same as
+--mirror-bootstrap.
+
+Each of the --mirror-* options governs which repository is used at various
+stages of the build. Recall from {Stages of the build}#stages-of-the-build
+that the *bootstrap* stage is when the chroot is initially populated by
+debootstrap with a minimal system, and the *chroot* stage is when the chroot
+used to construct the live system's filesystem is built. Thus, the
+corresponding mirror switches are used for those stages, and later, when the
+binary image is constructed, the --mirror-binary value is used, superceding
+any earlier repositories.
+
 The generic mirror is added to the live system's /etc/apt/sources.list.
 
 code{
diff --git a/manual/en/live-manual.ssm b/manual/en/live-manual.ssm
index 42d7261..6570953 100644
--- a/manual/en/live-manual.ssm
+++ b/manual/en/live-manual.ssm
@@ -9,7 +9,7 @@
  :license: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.<br><br>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.<br><br>You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/. <br><br>On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3 file.
 
 @date:
- :published: 2010-11-04
+ :published: 2010-11-07
 
 @publisher: Debian Live Project <debian-live at lists.debian.org>
 
diff --git a/manual/en/user_customization-overview.ssi b/manual/en/user_customization-overview.ssi
index 77821fb..d158312 100644
--- a/manual/en/user_customization-overview.ssi
+++ b/manual/en/user_customization-overview.ssi
@@ -4,11 +4,23 @@ B~ Customizing contents
 
 This chapter gives an overview of the various ways in which you may customize a Debian Live system.
 
-It is important to understand the different layers of a Live system to know where configurations must occur, and particular, to know when they are applied. Of course, all configurations are in some way processed by live-build at build time, but some parts of setting up the Live system don't actually occur until boot time, either early in the boot by live-boot, or later by live-config. Thus, it is necessary to have a way to specify boot-time customizations. In particular, while most #{lb config}# options control aspects of the build, #{--bootappend-live}# will pass additional options through the kernel command line to set things up at boot time, such as persistence, keyboard layouts, or timezone.
+2~ Build time vs. boot time configuration
 
-Therefore, in addition to the man pages included in live-build, you should keep near at hand the man pages for live-boot and live-config. Although the live-boot and live-config packages are installed within the live system you are building, it is recommended that you also install them on your build system for easy reference when you are working on your configuration. It is safe to do so, as none of the scripts contained within them are executed unless the system is configured as a live system.
+Live system configuration options are divided into those that are applied at build time and those that are applied at boot time. Boot-time options are further divided into those occurring early in the boot, applied by the live-boot package, and those that happen later in the boot, applied by live-config. Any boot-time option may be modified by the user by specifying it at the boot prompt. The image may also be built with default boot parameters so users can normally just boot directly to the live system without specifying any options when all of the defaults are suitable. In particular, the argument to #{lb --bootappend-live}# consists of any default kernel command line options for the Live system, such as persistence, keyboard layouts, or timezone. See {Customizing locale and language}#customizing-locale-and-language, for example.
 
-You should also be aware of the kinds of material that go into a Debian live configuration. Although #{lb config}# does create a skeletal configuration in the config/ directory, to accomplish your goals, you may need to provide additional files in subdirectories of config/. Depending on where the files are stored in the configuration, they may be copied into the live system's filesystem or into the binary image filesystem, or may provide build-time configurations of the system that would be cumbersome to pass as command-line options. You may include things such as custom lists of packages, custom artwork, or hook scripts to run either at build time or at boot time, boosting the already considerable flexibility of debian-live with code of your own.
+Build-time configuration options are described in the #{lb config}# man page. Boot-time options are described in the man pages for live-boot and live-config. Although the live-boot and live-config packages are installed within the live system you are building, it is recommended that you also install them on your build system for easy reference when you are working on your configuration. It is safe to do so, as none of the scripts contained within them are executed unless the system is configured as a live system.
+
+2~stages-of-the-build Stages of the build
+
+The build process is divided into stages, with various customizations applied in sequence in each. The first stage to run is the *{bootstrap}* stage. This is the initial phase of populating the chroot directory with packages to make a barebones Debian system. This is followed by the *{chroot}* stage, which completes the construction of chroot directory, populating it with all of the packages listed in the configuration, along with any other materials. Most customization of content occurs in this stage. The final stage of preparing the live image is the *{binary}* stage, which builds a bootable image, using the contents of the chroot directory to construct the root filesystem for the Live system, and including the installer and any other additional material on the target media outside of the Live system's filesystem. After the live image is built, if enabled, the source tarball is built in the *{source}* stage.
+
+Within each of these stages, there is a particular sequence in which commands are applied. These are arranged in such a way as to ensure customizations can be layered in a reasonable fashion. For example, within the *{chroot}* stage, preseeds are applied before any packages are installed, packages are installed before any locally included files or patches are applied, and hooks are run later, after all of the materials are in place.
+
+2~ Supplement #{lb config}# with files
+
+Although #{lb config}# does create a skeletal configuration in the config/ directory, to accomplish your goals, you may need to provide additional files in subdirectories of config/. Depending on where the files are stored in the configuration, they may be copied into the live system's filesystem or into the binary image filesystem, or may provide build-time configurations of the system that would be cumbersome to pass as command-line options. You may include things such as custom lists of packages, custom artwork, or hook scripts to run either at build time or at boot time, boosting the already considerable flexibility of debian-live with code of your own.
+
+2~ Customization tasks
 
 The following chapters are organized by the kinds of customization task users typically perform: {Customizing package installation}#customizing-package-installation, {Customizing contents}#customizing-contents and {Customizing locale and language}#customizing-locale-and-language cover just a few of the things you might want to do.
 
diff --git a/manual/en/user_customization-packages.ssi b/manual/en/user_customization-packages.ssi
index 289d6ab..427c01b 100644
--- a/manual/en/user_customization-packages.ssi
+++ b/manual/en/user_customization-packages.ssi
@@ -10,14 +10,18 @@ _* Installing modified packages
 
 3~ Debian repositories
 
-To set a local mirror (used to 'build' the live system)
+To set a local mirror to be used to at build time:
 
 code{
 
-$ lb config --mirror-bootstrap http://localhost/debian/ --mirror-chroot http://localhost/debian/
+$ lb config --mirror-bootstrap http://localhost/debian/
 
 }code
 
+The chroot repository, specified by --mirror-chroot, defaults to the same as --mirror-bootstrap.
+
+Each of the --mirror-* options governs which repository is used at various stages of the build. Recall from {Stages of the build}#stages-of-the-build that the *bootstrap* stage is when the chroot is initially populated by debootstrap with a minimal system, and the *chroot* stage is when the chroot used to construct the live system's filesystem is built. Thus, the corresponding mirror switches are used for those stages, and later, when the binary image is constructed, the --mirror-binary value is used, superceding any earlier repositories.
+
 The generic mirror is added to the live system's /etc/apt/sources.list.
 
 code{
diff --git a/manual/fr/live-manual.ssm b/manual/fr/live-manual.ssm
index d2a738c..aaa863d 100644
--- a/manual/fr/live-manual.ssm
+++ b/manual/fr/live-manual.ssm
@@ -9,7 +9,7 @@
  :license: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.<br><br>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.<br><br>You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/. <br><br>On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3 file.
 
 @date:
- :published: 2010-11-04
+ :published: 2010-11-07
 
 @publisher: Debian Live Project <debian-live at lists.debian.org>
 
diff --git a/manual/fr/user_customization-overview.ssi b/manual/fr/user_customization-overview.ssi
index 0871fe5..1900889 100644
--- a/manual/fr/user_customization-overview.ssi
+++ b/manual/fr/user_customization-overview.ssi
@@ -5,37 +5,68 @@ B~ Customizing contents
 This chapter gives an overview of the various ways in which you may
 customize a Debian Live system.
 
-It is important to understand the different layers of a Live system to know
-where configurations must occur, and particular, to know when they are
-applied. Of course, all configurations are in some way processed by
-live-build at build time, but some parts of setting up the Live system don't
-actually occur until boot time, either early in the boot by live-boot, or
-later by live-config. Thus, it is necessary to have a way to specify
-boot-time customizations. In particular, while most #{lb config}# options
-control aspects of the build, #{--bootappend-live}# will pass additional
-options through the kernel command line to set things up at boot time, such
-as persistence, keyboard layouts, or timezone.
-
-Therefore, in addition to the man pages included in live-build, you should
-keep near at hand the man pages for live-boot and live-config. Although the
-live-boot and live-config packages are installed within the live system you
-are building, it is recommended that you also install them on your build
-system for easy reference when you are working on your configuration. It is
-safe to do so, as none of the scripts contained within them are executed
-unless the system is configured as a live system.
-
-You should also be aware of the kinds of material that go into a Debian live
-configuration. Although #{lb config}# does create a skeletal configuration
-in the config/ directory, to accomplish your goals, you may need to provide
-additional files in subdirectories of config/. Depending on where the files
-are stored in the configuration, they may be copied into the live system's
-filesystem or into the binary image filesystem, or may provide build-time
+2~ Build time vs. boot time configuration
+
+Live system configuration options are divided into those that are applied at
+build time and those that are applied at boot time. Boot-time options are
+further divided into those occurring early in the boot, applied by the
+live-boot package, and those that happen later in the boot, applied by
+live-config. Any boot-time option may be modified by the user by specifying
+it at the boot prompt. The image may also be built with default boot
+parameters so users can normally just boot directly to the live system
+without specifying any options when all of the defaults are suitable. In
+particular, the argument to #{lb --bootappend-live}# consists of any default
+kernel command line options for the Live system, such as persistence,
+keyboard layouts, or timezone. See {Customizing locale and
+language}#customizing-locale-and-language, for example.
+
+Build-time configuration options are described in the #{lb config}# man
+page. Boot-time options are described in the man pages for live-boot and
+live-config. Although the live-boot and live-config packages are installed
+within the live system you are building, it is recommended that you also
+install them on your build system for easy reference when you are working on
+your configuration. It is safe to do so, as none of the scripts contained
+within them are executed unless the system is configured as a live system.
+
+2~stages-of-the-build Stages of the build
+
+The build process is divided into stages, with various customizations
+applied in sequence in each. The first stage to run is the *{bootstrap}*
+stage. This is the initial phase of populating the chroot directory with
+packages to make a barebones Debian system. This is followed by the
+*{chroot}* stage, which completes the construction of chroot directory,
+populating it with all of the packages listed in the configuration, along
+with any other materials. Most customization of content occurs in this
+stage. The final stage of preparing the live image is the *{binary}* stage,
+which builds a bootable image, using the contents of the chroot directory to
+construct the root filesystem for the Live system, and including the
+installer and any other additional material on the target media outside of
+the Live system's filesystem. After the live image is built, if enabled, the
+source tarball is built in the *{source}* stage.
+
+Within each of these stages, there is a particular sequence in which
+commands are applied. These are arranged in such a way as to ensure
+customizations can be layered in a reasonable fashion. For example, within
+the *{chroot}* stage, preseeds are applied before any packages are
+installed, packages are installed before any locally included files or
+patches are applied, and hooks are run later, after all of the materials are
+in place.
+
+2~ Supplement #{lb config}# with files
+
+Although #{lb config}# does create a skeletal configuration in the config/
+directory, to accomplish your goals, you may need to provide additional
+files in subdirectories of config/. Depending on where the files are stored
+in the configuration, they may be copied into the live system's filesystem
+or into the binary image filesystem, or may provide build-time
 configurations of the system that would be cumbersome to pass as
 command-line options. You may include things such as custom lists of
 packages, custom artwork, or hook scripts to run either at build time or at
 boot time, boosting the already considerable flexibility of debian-live with
 code of your own.
 
+2~ Customization tasks
+
 The following chapters are organized by the kinds of customization task
 users typically perform: {Customizing package
 installation}#customizing-package-installation, {Customizing
diff --git a/manual/fr/user_customization-packages.ssi b/manual/fr/user_customization-packages.ssi
index 29fb5eb..530d9eb 100644
--- a/manual/fr/user_customization-packages.ssi
+++ b/manual/fr/user_customization-packages.ssi
@@ -10,15 +10,26 @@ _* Installing modified packages
 
 3~ Debian repositories
 
-To set a local mirror (used to 'build' the live system)
+To set a local mirror to be used to at build time:
 
 code{
 
-$ lb config --mirror-bootstrap http://localhost/debian/ --mirror-chroot
-http://localhost/debian/
+$ lb config --mirror-bootstrap http://localhost/debian/
 
 }code
 
+The chroot repository, specified by --mirror-chroot, defaults to the same as
+--mirror-bootstrap.
+
+Each of the --mirror-* options governs which repository is used at various
+stages of the build. Recall from {Stages of the build}#stages-of-the-build
+that the *bootstrap* stage is when the chroot is initially populated by
+debootstrap with a minimal system, and the *chroot* stage is when the chroot
+used to construct the live system's filesystem is built. Thus, the
+corresponding mirror switches are used for those stages, and later, when the
+binary image is constructed, the --mirror-binary value is used, superceding
+any earlier repositories.
+
 The generic mirror is added to the live system's /etc/apt/sources.list.
 
 code{
diff --git a/manual/po/de/live-manual.ssm.po b/manual/po/de/live-manual.ssm.po
index 4bce20d..3ef282a 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-11-04 16:34-0400\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-03 20:30+0300\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -45,7 +45,7 @@ msgstr ""
 #, no-wrap
 msgid ""
 "@date:\n"
-" :published: 2010-11-04\n"
+" :published: 2010-11-07\n"
 msgstr ""
 
 #. type: Plain text
diff --git a/manual/po/de/user_customization-overview.ssi.po b/manual/po/de/user_customization-overview.ssi.po
index 64aaaed..89a6d9f 100644
--- a/manual/po/de/user_customization-overview.ssi.po
+++ b/manual/po/de/user_customization-overview.ssi.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-29 17:14-0200\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-22 07:52-0200\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -35,40 +35,86 @@ msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:8
-msgid ""
-"It is important to understand the different layers of a Live system to know "
-"where configurations must occur, and particular, to know when they are "
-"applied. Of course, all configurations are in some way processed by live-"
-"build at build time, but some parts of setting up the Live system don't "
-"actually occur until boot time, either early in the boot by live-boot, or "
-"later by live-config. Thus, it is necessary to have a way to specify boot-"
-"time customizations. In particular, while most #{lb config}# options control "
-"aspects of the build, #{--bootappend-live}# will pass additional options "
-"through the kernel command line to set things up at boot time, such as "
-"persistence, keyboard layouts, or timezone."
+msgid "2~ Build time vs. boot time configuration"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:10
 msgid ""
-"Therefore, in addition to the man pages included in live-build, you should "
-"keep near at hand the man pages for live-boot and live-config. Although the "
-"live-boot and live-config packages are installed within the live system you "
-"are building, it is recommended that you also install them on your build "
-"system for easy reference when you are working on your configuration. It is "
-"safe to do so, as none of the scripts contained within them are executed "
-"unless the system is configured as a live system."
+"Live system configuration options are divided into those that are applied at "
+"build time and those that are applied at boot time. Boot-time options are "
+"further divided into those occurring early in the boot, applied by the live-"
+"boot package, and those that happen later in the boot, applied by live-"
+"config. Any boot-time option may be modified by the user by specifying it at "
+"the boot prompt. The image may also be built with default boot parameters so "
+"users can normally just boot directly to the live system without specifying "
+"any options when all of the defaults are suitable. In particular, the "
+"argument to #{lb --bootappend-live}# consists of any default kernel command "
+"line options for the Live system, such as persistence, keyboard layouts, or "
+"timezone. See {Customizing locale and language}#customizing-locale-and-"
+"language, for example."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:12
 msgid ""
-"You should also be aware of the kinds of material that go into a Debian live "
-"configuration. Although #{lb config}# does create a skeletal configuration "
-"in the config/ directory, to accomplish your goals, you may need to provide "
-"additional files in subdirectories of config/. Depending on where the files "
-"are stored in the configuration, they may be copied into the live system's "
-"filesystem or into the binary image filesystem, or may provide build-time "
+"Build-time configuration options are described in the #{lb config}# man "
+"page. Boot-time options are described in the man pages for live-boot and "
+"live-config. Although the live-boot and live-config packages are installed "
+"within the live system you are building, it is recommended that you also "
+"install them on your build system for easy reference when you are working on "
+"your configuration. It is safe to do so, as none of the scripts contained "
+"within them are executed unless the system is configured as a live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:14
+msgid "2~stages-of-the-build Stages of the build"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:16
+msgid ""
+"The build process is divided into stages, with various customizations "
+"applied in sequence in each. The first stage to run is the *{bootstrap}* "
+"stage. This is the initial phase of populating the chroot directory with "
+"packages to make a barebones Debian system. This is followed by the *{chroot}"
+"* stage, which completes the construction of chroot directory, populating it "
+"with all of the packages listed in the configuration, along with any other "
+"materials. Most customization of content occurs in this stage. The final "
+"stage of preparing the live image is the *{binary}* stage, which builds a "
+"bootable image, using the contents of the chroot directory to construct the "
+"root filesystem for the Live system, and including the installer and any "
+"other additional material on the target media outside of the Live system's "
+"filesystem. After the live image is built, if enabled, the source tarball is "
+"built in the *{source}* stage."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:18
+msgid ""
+"Within each of these stages, there is a particular sequence in which "
+"commands are applied. These are arranged in such a way as to ensure "
+"customizations can be layered in a reasonable fashion. For example, within "
+"the *{chroot}* stage, preseeds are applied before any packages are "
+"installed, packages are installed before any locally included files or "
+"patches are applied, and hooks are run later, after all of the materials are "
+"in place."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:20
+msgid "2~ Supplement #{lb config}# with files"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:22
+msgid ""
+"Although #{lb config}# does create a skeletal configuration in the config/ "
+"directory, to accomplish your goals, you may need to provide additional "
+"files in subdirectories of config/. Depending on where the files are stored "
+"in the configuration, they may be copied into the live system's filesystem "
+"or into the binary image filesystem, or may provide build-time "
 "configurations of the system that would be cumbersome to pass as command-"
 "line options. You may include things such as custom lists of packages, "
 "custom artwork, or hook scripts to run either at build time or at boot time, "
@@ -77,7 +123,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-overview.ssi:14
+#: en/user_customization-overview.ssi:24
+msgid "2~ Customization tasks"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:26
 msgid ""
 "The following chapters are organized by the kinds of customization task "
 "users typically perform: {Customizing package installation}#customizing-"
diff --git a/manual/po/de/user_customization-packages.ssi.po b/manual/po/de/user_customization-packages.ssi.po
index f303056..eae8d15 100644
--- a/manual/po/de/user_customization-packages.ssi.po
+++ b/manual/po/de/user_customization-packages.ssi.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-22 08:58-0200\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-03 20:30+0300\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -39,40 +39,38 @@ msgstr ""
 #: 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:36
-#: en/user_basics.ssi:48 en/user_basics.ssi:62 en/user_basics.ssi:74
-#: en/user_basics.ssi:86 en/user_basics.ssi:98 en/user_basics.ssi:114
-#: en/user_basics.ssi:122 en/user_basics.ssi:130 en/user_basics.ssi:140
-#: en/user_basics.ssi:152 en/user_basics.ssi:164 en/user_basics.ssi:172
-#: en/user_basics.ssi:180 en/user_basics.ssi:194 en/user_basics.ssi:202
-#: en/user_basics.ssi:212 en/user_basics.ssi:232 en/user_basics.ssi:265
-#: en/user_basics.ssi:281 en/user_basics.ssi:289 en/user_basics.ssi:309
-#: en/user_basics.ssi:334 en/user_customization-contents.ssi:34
+#: en/other_procedures.ssi:58 en/project_bugs.ssi:58 en/user_basics.ssi:32
+#: en/user_basics.ssi:42 en/user_basics.ssi:54 en/user_basics.ssi:66
+#: en/user_basics.ssi:78 en/user_basics.ssi:88 en/user_basics.ssi:102
+#: en/user_basics.ssi:110 en/user_basics.ssi:118 en/user_basics.ssi:128
+#: en/user_basics.ssi:140 en/user_basics.ssi:152 en/user_basics.ssi:160
+#: en/user_basics.ssi:168 en/user_basics.ssi:182 en/user_basics.ssi:190
+#: en/user_basics.ssi:200 en/user_basics.ssi:220 en/user_basics.ssi:253
+#: en/user_basics.ssi:269 en/user_basics.ssi:277 en/user_basics.ssi:297
+#: en/user_basics.ssi:322 en/user_customization-contents.ssi:34
 #: en/user_customization-contents.ssi:43 en/user_customization-contents.ssi:66
 #: en/user_customization-internationalization.ssi:10
 #: en/user_customization-internationalization.ssi:18
 #: en/user_customization-internationalization.ssi:26
 #: en/user_customization-internationalization.ssi:38
-#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:24
-#: en/user_customization-packages.ssi:36 en/user_customization-packages.ssi:45
-#: en/user_customization-packages.ssi:59 en/user_customization-packages.ssi:73
-#: en/user_customization-packages.ssi:103
-#: en/user_customization-packages.ssi:111
-#: en/user_customization-packages.ssi:131
-#: en/user_customization-packages.ssi:166
-#: en/user_customization-packages.ssi:176
-#: en/user_customization-packages.ssi:186
-#: en/user_customization-packages.ssi:196 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:106
-#: en/user_installation.ssi:120 en/user_installation.ssi:137
-#: en/user_managing_a_configuration.ssi:24
+#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:28
+#: en/user_customization-packages.ssi:40 en/user_customization-packages.ssi:49
+#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
+#: en/user_customization-packages.ssi:107
+#: en/user_customization-packages.ssi:115
+#: en/user_customization-packages.ssi:135
+#: en/user_customization-packages.ssi:170
+#: en/user_customization-packages.ssi:180
+#: en/user_customization-packages.ssi:190
+#: en/user_customization-packages.ssi:200 en/user_examples.ssi:24
+#: 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:135 en/user_managing_a_configuration.ssi:24
 #: en/user_managing_a_configuration.ssi:35
-#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:46
-#: en/user_overview.ssi:90 en/user_overview.ssi:98
+#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:36
+#: en/user_overview.ssi:80 en/user_overview.ssi:88
 msgid "code{"
 msgstr ""
 
@@ -99,45 +97,43 @@ msgstr ""
 #: 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:40 en/user_basics.ssi:52
-#: en/user_basics.ssi:68 en/user_basics.ssi:78 en/user_basics.ssi:92
-#: en/user_basics.ssi:104 en/user_basics.ssi:118 en/user_basics.ssi:126
-#: en/user_basics.ssi:134 en/user_basics.ssi:144 en/user_basics.ssi:158
-#: en/user_basics.ssi:168 en/user_basics.ssi:176 en/user_basics.ssi:184
-#: en/user_basics.ssi:198 en/user_basics.ssi:206 en/user_basics.ssi:216
-#: en/user_basics.ssi:257 en/user_basics.ssi:269 en/user_basics.ssi:285
-#: en/user_basics.ssi:293 en/user_basics.ssi:320 en/user_basics.ssi:359
+#: en/project_bugs.ssi:62 en/user_basics.ssi:36 en/user_basics.ssi:46
+#: en/user_basics.ssi:60 en/user_basics.ssi:72 en/user_basics.ssi:82
+#: en/user_basics.ssi:94 en/user_basics.ssi:106 en/user_basics.ssi:114
+#: en/user_basics.ssi:122 en/user_basics.ssi:132 en/user_basics.ssi:146
+#: en/user_basics.ssi:156 en/user_basics.ssi:164 en/user_basics.ssi:172
+#: en/user_basics.ssi:186 en/user_basics.ssi:194 en/user_basics.ssi:204
+#: en/user_basics.ssi:245 en/user_basics.ssi:257 en/user_basics.ssi:273
+#: en/user_basics.ssi:281 en/user_basics.ssi:308 en/user_basics.ssi:347
 #: en/user_customization-contents.ssi:39 en/user_customization-contents.ssi:54
 #: en/user_customization-contents.ssi:70
 #: en/user_customization-internationalization.ssi:14
 #: en/user_customization-internationalization.ssi:22
 #: en/user_customization-internationalization.ssi:30
 #: en/user_customization-internationalization.ssi:42
-#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:28
-#: en/user_customization-packages.ssi:41 en/user_customization-packages.ssi:49
-#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
-#: en/user_customization-packages.ssi:107
-#: en/user_customization-packages.ssi:115
-#: en/user_customization-packages.ssi:135
-#: en/user_customization-packages.ssi:172
-#: en/user_customization-packages.ssi:182
-#: en/user_customization-packages.ssi:192
-#: en/user_customization-packages.ssi:202 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:88 en/user_installation.ssi:110
-#: en/user_installation.ssi:125 en/user_installation.ssi:140
-#: en/user_managing_a_configuration.ssi:31
+#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:32
+#: en/user_customization-packages.ssi:45 en/user_customization-packages.ssi:53
+#: en/user_customization-packages.ssi:67 en/user_customization-packages.ssi:81
+#: en/user_customization-packages.ssi:111
+#: en/user_customization-packages.ssi:119
+#: en/user_customization-packages.ssi:139
+#: en/user_customization-packages.ssi:176
+#: en/user_customization-packages.ssi:186
+#: en/user_customization-packages.ssi:196
+#: en/user_customization-packages.ssi:206 en/user_examples.ssi:33
+#: 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:88
+#: en/user_installation.ssi:108 en/user_installation.ssi:123
+#: en/user_installation.ssi:138 en/user_managing_a_configuration.ssi:31
 #: en/user_managing_a_configuration.ssi:43
-#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:84
-#: en/user_overview.ssi:94 en/user_overview.ssi:102
+#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:74
+#: en/user_overview.ssi:84 en/user_overview.ssi:92
 msgid "}code"
 msgstr ""
 
 #. type: Plain text
-#: en/user_basics.ssi:230 en/user_customization-packages.ssi:153
+#: en/user_basics.ssi:218 en/user_customization-packages.ssi:157
 msgid "% FIXME"
 msgstr ""
 
@@ -173,65 +169,83 @@ msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:14
-msgid "To set a local mirror (used to 'build' the live system)"
+msgid "To set a local mirror to be used to at build time:"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:18
-msgid ""
-"$ lb config --mirror-bootstrap http://localhost/debian/ --mirror-chroot "
-"http://localhost/debian/"
+msgid "$ lb config --mirror-bootstrap http://localhost/debian/"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:22
-msgid "The generic mirror is added to the live system's /etc/apt/sources.list."
+msgid ""
+"The chroot repository, specified by --mirror-chroot, defaults to the same as "
+"--mirror-bootstrap."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:24
+msgid ""
+"Each of the --mirror-* options governs which repository is used at various "
+"stages of the build. Recall from {Stages of the build}#stages-of-the-build "
+"that the *bootstrap* stage is when the chroot is initially populated by "
+"debootstrap with a minimal system, and the *chroot* stage is when the chroot "
+"used to construct the live system's filesystem is built. Thus, the "
+"corresponding mirror switches are used for those stages, and later, when the "
+"binary image is constructed, the --mirror-binary value is used, superceding "
+"any earlier repositories."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:26
-msgid "$ lb config --mirror-binary http://ftp.debian.org/debian/"
+msgid "The generic mirror is added to the live system's /etc/apt/sources.list."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:30
+msgid "$ lb config --mirror-binary http://ftp.debian.org/debian/"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:34
 msgid ""
 "Note: It is not used for building the live system but to install new "
 "software while using the live system."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:32
+#: en/user_customization-packages.ssi:36
 msgid ""
 "It can be disabled by setting the binary mirror to the same value as the "
 "chroot mirror."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:34
+#: en/user_customization-packages.ssi:38
 msgid ""
 "Note: the same applies for mirror chroot security and mirror binary security"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:39
+#: en/user_customization-packages.ssi:43
 msgid ""
 "$ lb config --mirror-chroot-security {URL} $ lb config --mirror-binary-"
 "security {URL}"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:43
+#: en/user_customization-packages.ssi:47
 msgid "If you don't want to include apt indices, you can skip those with:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:47
+#: en/user_customization-packages.ssi:51
 msgid "$ lb config --binary-indices false"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:51
+#: en/user_customization-packages.ssi:55
 msgid ""
 "This will not influence the entries in /etc/apt/sources.list, but only if /"
 "var/lib/apt contains the indices files or not (and by that making the image "
@@ -239,12 +253,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:53
+#: en/user_customization-packages.ssi:57
 msgid "3~ Own repository"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:55
+#: en/user_customization-packages.ssi:59
 msgid ""
 "To add more repositories (e.g. backports, experimental or custom packages, "
 "etc.), create #{config/chroot_sources/your-repository.{chroot,binary}}# "
@@ -252,7 +266,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:57
+#: en/user_customization-packages.ssi:61
 msgid ""
 "e.g. #{config/chroot_sources/live.chroot}# allows you to install packages "
 "from the debian live snapshot repository at live system build time (you have "
@@ -260,31 +274,31 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:61
+#: en/user_customization-packages.ssi:65
 msgid "deb http://live.debian.net/ sid-snapshots main contrib non-free"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:65
+#: en/user_customization-packages.ssi:69
 msgid ""
 "If you add the line to #{config/chroot_sources/live.binary}# the repository "
 "will be added to your live-system's #{/etc/apt/sources.list}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:67
+#: en/user_customization-packages.ssi:71
 msgid "If such files exist, they will be picked up automatically."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:69
+#: en/user_customization-packages.ssi:73
 msgid ""
 "You can also put the gpg-key used to sign the repository into config/"
 "chroot_sources/your-repository.{binary,chroot}.gpg"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:71
+#: en/user_customization-packages.ssi:75
 msgid ""
 "Note: some preconfigured package repositories are available for easy "
 "selection through the --repository switch, e.g. for enabling live snapshots, "
@@ -292,17 +306,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:75
+#: en/user_customization-packages.ssi:79
 msgid "$ lb config --repository live.debian.net"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:79
+#: en/user_customization-packages.ssi:83
 msgid "3~ Package installation"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:81
+#: en/user_customization-packages.ssi:85
 msgid ""
 "You can elect to use either #{apt}# or #{aptitude}# when installing "
 "packages. Which utility is used is governed by the #{LB_APT}# variable in #"
@@ -310,7 +324,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:83
+#: en/user_customization-packages.ssi:87
 msgid ""
 "_* #{apt}#: Specifying a missing package causes package installation to "
 "fail, which may not be the desired behaviour. This is the default setting "
@@ -318,7 +332,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:85
+#: en/user_customization-packages.ssi:89
 msgid ""
 "_* #{aptitude}#: Specifying a missing package causes package installation to "
 "succeed, which may not be the desired behaviour. This is the default setting "
@@ -326,66 +340,66 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:87
+#: en/user_customization-packages.ssi:91
 msgid "2~ Installing additional packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:89
+#: en/user_customization-packages.ssi:93
 msgid ""
 "live-helper has a number of mechanisms for indicating that additional "
 "packages should be installed, including:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:91
+#: en/user_customization-packages.ssi:95
 msgid "_* The #{LB_PACKAGES}# variable"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:93
+#: en/user_customization-packages.ssi:97
 msgid "_* Package lists"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:95
+#: en/user_customization-packages.ssi:99
 msgid "_* Local packages (#{chroot_local-packages/}#)"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:97
+#: en/user_customization-packages.ssi:101
 msgid "_* Tasks"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:99
+#: en/user_customization-packages.ssi:103
 msgid "3~ The #{LB_PACKAGES}# variable"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:101
+#: en/user_customization-packages.ssi:105
 msgid ""
 "To install additional packages, simply add them to the #{LB_PACKAGES}# "
 "variable in #{config/chroot}#. For example:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:105
+#: en/user_customization-packages.ssi:109
 msgid "LB_PACKAGES=\"package1 package2 package3 ... \""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:109
+#: en/user_customization-packages.ssi:113
 msgid "You can also specify initial values on the command line:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:113
+#: en/user_customization-packages.ssi:117
 msgid "$ lb config --packages \"package1 package2 package3\""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:117
+#: en/user_customization-packages.ssi:121
 msgid ""
 "The behaviour of live-build when specifying a package that does not exist is "
 "determined by your choice of APT utility. See package-installation for more "
@@ -393,12 +407,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:119
+#: en/user_customization-packages.ssi:123
 msgid "% FIXME: <xref linkend=\"package-installation\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:121
+#: en/user_customization-packages.ssi:125
 msgid ""
 "If you need to specify a large number of packages to be installed or you "
 "need flexibility regarding which packages to install, you should probably be "
@@ -406,17 +420,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:123
+#: en/user_customization-packages.ssi:127
 msgid "% FIXME: <xref linkend=\"package-lists\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:125
+#: en/user_customization-packages.ssi:129
 msgid "3~ Package lists"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:127
+#: en/user_customization-packages.ssi:131
 msgid ""
 "Package lists are a powerful way of expressing which packages should be "
 "installed. live-build ships with a number of predefined package lists which "
@@ -425,37 +439,37 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:129
+#: en/user_customization-packages.ssi:133
 msgid "To specify one or more package list, you can use:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:133
+#: en/user_customization-packages.ssi:137
 msgid "$ lb config --packages-lists \"list1 list2 list3\""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:137
+#: en/user_customization-packages.ssi:141
 msgid ""
 "Note: Package lists that are distributed with live-build reside in the #{/"
 "usr/share/live/build/lists}# directory."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:139
+#: en/user_customization-packages.ssi:143
 #, no-wrap
 msgid "*{Local packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:141
+#: en/user_customization-packages.ssi:145
 msgid ""
 "You may supplement the supplied lists using local package lists stored in #"
 "{config/chroot_local-packageslists}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:143
+#: en/user_customization-packages.ssi:147
 msgid ""
 "Package lists that exist in this directory need to have a #{.list}# suffix "
 "in order to be processed. Local packages lists always override package lists "
@@ -464,13 +478,13 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:145
+#: en/user_customization-packages.ssi:149
 #, no-wrap
 msgid "*{Local binary packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:147
+#: en/user_customization-packages.ssi:151
 msgid ""
 "In case you want to include some required .deb packages to live media's "
 "pool/ (without installing them onto the live image) you may need to use "
@@ -480,25 +494,25 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:149
+#: en/user_customization-packages.ssi:153
 msgid ""
 "Package lists that exist in this directory need to have a .list suffix in "
 "order to be processed."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:151
+#: en/user_customization-packages.ssi:155
 #, no-wrap
 msgid "*{Extending a provided package list using includes}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:160
+#: en/user_customization-packages.ssi:164
 msgid "% code{ % % #include <gnome> % iceweasel % % }code"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:162
+#: en/user_customization-packages.ssi:166
 msgid ""
 "The package lists that are included with live-build make extensive use of "
 "includes. They are available to view in the #{/usr/share/live/build/lists}# "
@@ -506,75 +520,75 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:164
+#: en/user_customization-packages.ssi:168
 #, no-wrap
 msgid "*{Using conditionals inside packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:170
+#: en/user_customization-packages.ssi:174
 msgid "#if ARCHITECTURE amd64 ia32-libs #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:174
+#: en/user_customization-packages.ssi:178
 msgid "or if #{LB_ARCHITECTURE}# is set to #{i386}# or #{amd64}#:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:180
+#: en/user_customization-packages.ssi:184
 msgid "#if ARCHITECTURE i386 amd64 memtest86+ #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:184
+#: en/user_customization-packages.ssi:188
 msgid "or if #{LB_ARCHIVE_AREAS}# contains either #{contrib}# or #{non-free}#:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:190
+#: en/user_customization-packages.ssi:194
 msgid "#if ARCHIVE_AREAS contrib non-free vrms #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:194
+#: en/user_customization-packages.ssi:198
 msgid "A conditional may surround an #{#include}# directive:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:200
+#: en/user_customization-packages.ssi:204
 msgid "#if ARCHITECTURE amd64 #include <gnome-full> #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:204
+#: en/user_customization-packages.ssi:208
 msgid ""
 "Any live-build configuration variable that begins with #{LB_}# can be tested "
 "in this way."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:206
+#: en/user_customization-packages.ssi:210
 msgid "The nesting of conditionals is not supported."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:208
+#: en/user_customization-packages.ssi:212
 msgid "3~ Tasks"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:210
+#: en/user_customization-packages.ssi:214
 msgid "%FIXME"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:212
+#: en/user_customization-packages.ssi:216
 msgid "2~ Installing modified or third-party packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:214
+#: en/user_customization-packages.ssi:218
 msgid ""
 "Whilst it is against the philosophy of Debian Live, it may sometimes be "
 "necessary to build a Live system with modified versions of packages that are "
@@ -585,7 +599,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:216
+#: en/user_customization-packages.ssi:220
 msgid ""
 "This section does not cover advice regarding building or maintaining "
 "modified packages. Joachim Breitner's 'How to fork privately' method from "
@@ -596,22 +610,22 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:218
+#: en/user_customization-packages.ssi:222
 msgid "There are two ways of installing modified custom packages:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:220
+#: en/user_customization-packages.ssi:224
 msgid "_* #{chroot_local-packages}#"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:222
+#: en/user_customization-packages.ssi:226
 msgid "_* Using a custom APT repository"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:224
+#: en/user_customization-packages.ssi:228
 msgid ""
 "The #{chroot_local-packages}# is simpler to achieve and useful for \"one-off"
 "\" customizations but has a number of drawbacks, whilst using a custom APT "
@@ -619,12 +633,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:226
+#: en/user_customization-packages.ssi:230
 msgid "3~ Using #{chroot_local-packages}# to install custom packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:228
+#: en/user_customization-packages.ssi:232
 msgid ""
 "To install a custom package, simply copy it to the #{config/chroot_local-"
 "packages}# directory. Packages that are inside this directory will be "
@@ -633,45 +647,45 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:230
+#: en/user_customization-packages.ssi:234
 msgid ""
 "Packages *{must}* be named in the prescribed way. One simple way to do this "
 "is to use #{dpkg-name}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:232
+#: en/user_customization-packages.ssi:236
 msgid ""
 "Using #{chroot_local-packages}# for installation of custom packages has "
 "disadvantages:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:234
+#: en/user_customization-packages.ssi:238
 msgid "_* It is not possible to use secure APT"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:236
+#: en/user_customization-packages.ssi:240
 msgid ""
 "_* You must install all appropriate packages in the #{config/chroot_local-"
 "packages}# directory"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:238
+#: en/user_customization-packages.ssi:242
 msgid ""
 "_* It does not lend itself to storing Debian Live configurations in revision "
 "control"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:240
+#: en/user_customization-packages.ssi:244
 msgid "3~ Using an APT repository to install custom packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:242
+#: en/user_customization-packages.ssi:246
 msgid ""
 "Unlike using #{chroot_local-packages}#, when using a custom APT repository "
 "you must ensure that you specify the packages elsewhere. See lb-packages for "
@@ -679,12 +693,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:244
+#: en/user_customization-packages.ssi:248
 msgid "% FIXME: <xref linkend=\"lb-packages\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:246
+#: en/user_customization-packages.ssi:250
 msgid ""
 "Whilst it may seem unnecessary effort to create an APT repository to install "
 "custom packages, the infrastructure can be easily re-used at a later date to "
@@ -692,12 +706,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:248
+#: en/user_customization-packages.ssi:252
 msgid "3~ Custom packages and APT"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:250
+#: en/user_customization-packages.ssi:254
 msgid ""
 "live-build uses APT to install all packages into the live system so will "
 "therefore inherit behaviours from this program. One relevant example is that "
@@ -707,7 +721,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:252
+#: en/user_customization-packages.ssi:256
 msgid ""
 "Because of this, you may wish to increment the version number in your custom "
 "packages' #{debian/changelog}# files to ensure that your modified version is "
@@ -717,17 +731,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:254
+#: en/user_customization-packages.ssi:258
 msgid "% FIXME: <xref linkend=\"apt-preferences\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:256
+#: en/user_customization-packages.ssi:260
 msgid "3~ Altering APT preferences during Live system"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:257
+#: en/user_customization-packages.ssi:261
 msgid ""
 "Whilst it may seem unnecessary effort to create an APT repository to install "
 "custom packages, the infrastructure can be easily re-used at a later date to "
diff --git a/manual/po/de/user_examples.ssi.po b/manual/po/de/user_examples.ssi.po
index ac912f2..a41671f 100644
--- a/manual/po/de/user_examples.ssi.po
+++ b/manual/po/de/user_examples.ssi.po
@@ -12,7 +12,7 @@ msgstr ""
 "Language-Team: none\n"
 "Language: de\n"
 "MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=ASCII\n"
+"Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
diff --git a/manual/po/fr/live-manual.ssm.po b/manual/po/fr/live-manual.ssm.po
index 6e72f25..7469234 100644
--- a/manual/po/fr/live-manual.ssm.po
+++ b/manual/po/fr/live-manual.ssm.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-11-04 16:34-0400\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-21 07:06-0200\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -45,7 +45,7 @@ msgstr ""
 #, no-wrap
 msgid ""
 "@date:\n"
-" :published: 2010-11-04\n"
+" :published: 2010-11-07\n"
 msgstr ""
 
 #. type: Plain text
diff --git a/manual/po/fr/user_customization-overview.ssi.po b/manual/po/fr/user_customization-overview.ssi.po
index a887219..abd0d01 100644
--- a/manual/po/fr/user_customization-overview.ssi.po
+++ b/manual/po/fr/user_customization-overview.ssi.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-29 17:14-0200\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-22 07:52-0200\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -35,40 +35,86 @@ msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:8
-msgid ""
-"It is important to understand the different layers of a Live system to know "
-"where configurations must occur, and particular, to know when they are "
-"applied. Of course, all configurations are in some way processed by live-"
-"build at build time, but some parts of setting up the Live system don't "
-"actually occur until boot time, either early in the boot by live-boot, or "
-"later by live-config. Thus, it is necessary to have a way to specify boot-"
-"time customizations. In particular, while most #{lb config}# options control "
-"aspects of the build, #{--bootappend-live}# will pass additional options "
-"through the kernel command line to set things up at boot time, such as "
-"persistence, keyboard layouts, or timezone."
+msgid "2~ Build time vs. boot time configuration"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:10
 msgid ""
-"Therefore, in addition to the man pages included in live-build, you should "
-"keep near at hand the man pages for live-boot and live-config. Although the "
-"live-boot and live-config packages are installed within the live system you "
-"are building, it is recommended that you also install them on your build "
-"system for easy reference when you are working on your configuration. It is "
-"safe to do so, as none of the scripts contained within them are executed "
-"unless the system is configured as a live system."
+"Live system configuration options are divided into those that are applied at "
+"build time and those that are applied at boot time. Boot-time options are "
+"further divided into those occurring early in the boot, applied by the live-"
+"boot package, and those that happen later in the boot, applied by live-"
+"config. Any boot-time option may be modified by the user by specifying it at "
+"the boot prompt. The image may also be built with default boot parameters so "
+"users can normally just boot directly to the live system without specifying "
+"any options when all of the defaults are suitable. In particular, the "
+"argument to #{lb --bootappend-live}# consists of any default kernel command "
+"line options for the Live system, such as persistence, keyboard layouts, or "
+"timezone. See {Customizing locale and language}#customizing-locale-and-"
+"language, for example."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:12
 msgid ""
-"You should also be aware of the kinds of material that go into a Debian live "
-"configuration. Although #{lb config}# does create a skeletal configuration "
-"in the config/ directory, to accomplish your goals, you may need to provide "
-"additional files in subdirectories of config/. Depending on where the files "
-"are stored in the configuration, they may be copied into the live system's "
-"filesystem or into the binary image filesystem, or may provide build-time "
+"Build-time configuration options are described in the #{lb config}# man "
+"page. Boot-time options are described in the man pages for live-boot and "
+"live-config. Although the live-boot and live-config packages are installed "
+"within the live system you are building, it is recommended that you also "
+"install them on your build system for easy reference when you are working on "
+"your configuration. It is safe to do so, as none of the scripts contained "
+"within them are executed unless the system is configured as a live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:14
+msgid "2~stages-of-the-build Stages of the build"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:16
+msgid ""
+"The build process is divided into stages, with various customizations "
+"applied in sequence in each. The first stage to run is the *{bootstrap}* "
+"stage. This is the initial phase of populating the chroot directory with "
+"packages to make a barebones Debian system. This is followed by the *{chroot}"
+"* stage, which completes the construction of chroot directory, populating it "
+"with all of the packages listed in the configuration, along with any other "
+"materials. Most customization of content occurs in this stage. The final "
+"stage of preparing the live image is the *{binary}* stage, which builds a "
+"bootable image, using the contents of the chroot directory to construct the "
+"root filesystem for the Live system, and including the installer and any "
+"other additional material on the target media outside of the Live system's "
+"filesystem. After the live image is built, if enabled, the source tarball is "
+"built in the *{source}* stage."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:18
+msgid ""
+"Within each of these stages, there is a particular sequence in which "
+"commands are applied. These are arranged in such a way as to ensure "
+"customizations can be layered in a reasonable fashion. For example, within "
+"the *{chroot}* stage, preseeds are applied before any packages are "
+"installed, packages are installed before any locally included files or "
+"patches are applied, and hooks are run later, after all of the materials are "
+"in place."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:20
+msgid "2~ Supplement #{lb config}# with files"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:22
+msgid ""
+"Although #{lb config}# does create a skeletal configuration in the config/ "
+"directory, to accomplish your goals, you may need to provide additional "
+"files in subdirectories of config/. Depending on where the files are stored "
+"in the configuration, they may be copied into the live system's filesystem "
+"or into the binary image filesystem, or may provide build-time "
 "configurations of the system that would be cumbersome to pass as command-"
 "line options. You may include things such as custom lists of packages, "
 "custom artwork, or hook scripts to run either at build time or at boot time, "
@@ -77,7 +123,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-overview.ssi:14
+#: en/user_customization-overview.ssi:24
+msgid "2~ Customization tasks"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:26
 msgid ""
 "The following chapters are organized by the kinds of customization task "
 "users typically perform: {Customizing package installation}#customizing-"
diff --git a/manual/po/fr/user_customization-packages.ssi.po b/manual/po/fr/user_customization-packages.ssi.po
index c79afc7..887b6a9 100644
--- a/manual/po/fr/user_customization-packages.ssi.po
+++ b/manual/po/fr/user_customization-packages.ssi.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-22 08:58-0200\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-16 14:45-0200\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -39,40 +39,38 @@ msgstr ""
 #: 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:36
-#: en/user_basics.ssi:48 en/user_basics.ssi:62 en/user_basics.ssi:74
-#: en/user_basics.ssi:86 en/user_basics.ssi:98 en/user_basics.ssi:114
-#: en/user_basics.ssi:122 en/user_basics.ssi:130 en/user_basics.ssi:140
-#: en/user_basics.ssi:152 en/user_basics.ssi:164 en/user_basics.ssi:172
-#: en/user_basics.ssi:180 en/user_basics.ssi:194 en/user_basics.ssi:202
-#: en/user_basics.ssi:212 en/user_basics.ssi:232 en/user_basics.ssi:265
-#: en/user_basics.ssi:281 en/user_basics.ssi:289 en/user_basics.ssi:309
-#: en/user_basics.ssi:334 en/user_customization-contents.ssi:34
+#: en/other_procedures.ssi:58 en/project_bugs.ssi:58 en/user_basics.ssi:32
+#: en/user_basics.ssi:42 en/user_basics.ssi:54 en/user_basics.ssi:66
+#: en/user_basics.ssi:78 en/user_basics.ssi:88 en/user_basics.ssi:102
+#: en/user_basics.ssi:110 en/user_basics.ssi:118 en/user_basics.ssi:128
+#: en/user_basics.ssi:140 en/user_basics.ssi:152 en/user_basics.ssi:160
+#: en/user_basics.ssi:168 en/user_basics.ssi:182 en/user_basics.ssi:190
+#: en/user_basics.ssi:200 en/user_basics.ssi:220 en/user_basics.ssi:253
+#: en/user_basics.ssi:269 en/user_basics.ssi:277 en/user_basics.ssi:297
+#: en/user_basics.ssi:322 en/user_customization-contents.ssi:34
 #: en/user_customization-contents.ssi:43 en/user_customization-contents.ssi:66
 #: en/user_customization-internationalization.ssi:10
 #: en/user_customization-internationalization.ssi:18
 #: en/user_customization-internationalization.ssi:26
 #: en/user_customization-internationalization.ssi:38
-#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:24
-#: en/user_customization-packages.ssi:36 en/user_customization-packages.ssi:45
-#: en/user_customization-packages.ssi:59 en/user_customization-packages.ssi:73
-#: en/user_customization-packages.ssi:103
-#: en/user_customization-packages.ssi:111
-#: en/user_customization-packages.ssi:131
-#: en/user_customization-packages.ssi:166
-#: en/user_customization-packages.ssi:176
-#: en/user_customization-packages.ssi:186
-#: en/user_customization-packages.ssi:196 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:106
-#: en/user_installation.ssi:120 en/user_installation.ssi:137
-#: en/user_managing_a_configuration.ssi:24
+#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:28
+#: en/user_customization-packages.ssi:40 en/user_customization-packages.ssi:49
+#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
+#: en/user_customization-packages.ssi:107
+#: en/user_customization-packages.ssi:115
+#: en/user_customization-packages.ssi:135
+#: en/user_customization-packages.ssi:170
+#: en/user_customization-packages.ssi:180
+#: en/user_customization-packages.ssi:190
+#: en/user_customization-packages.ssi:200 en/user_examples.ssi:24
+#: 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:135 en/user_managing_a_configuration.ssi:24
 #: en/user_managing_a_configuration.ssi:35
-#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:46
-#: en/user_overview.ssi:90 en/user_overview.ssi:98
+#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:36
+#: en/user_overview.ssi:80 en/user_overview.ssi:88
 msgid "code{"
 msgstr "code{"
 
@@ -99,45 +97,43 @@ msgstr "code{"
 #: 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:40 en/user_basics.ssi:52
-#: en/user_basics.ssi:68 en/user_basics.ssi:78 en/user_basics.ssi:92
-#: en/user_basics.ssi:104 en/user_basics.ssi:118 en/user_basics.ssi:126
-#: en/user_basics.ssi:134 en/user_basics.ssi:144 en/user_basics.ssi:158
-#: en/user_basics.ssi:168 en/user_basics.ssi:176 en/user_basics.ssi:184
-#: en/user_basics.ssi:198 en/user_basics.ssi:206 en/user_basics.ssi:216
-#: en/user_basics.ssi:257 en/user_basics.ssi:269 en/user_basics.ssi:285
-#: en/user_basics.ssi:293 en/user_basics.ssi:320 en/user_basics.ssi:359
+#: en/project_bugs.ssi:62 en/user_basics.ssi:36 en/user_basics.ssi:46
+#: en/user_basics.ssi:60 en/user_basics.ssi:72 en/user_basics.ssi:82
+#: en/user_basics.ssi:94 en/user_basics.ssi:106 en/user_basics.ssi:114
+#: en/user_basics.ssi:122 en/user_basics.ssi:132 en/user_basics.ssi:146
+#: en/user_basics.ssi:156 en/user_basics.ssi:164 en/user_basics.ssi:172
+#: en/user_basics.ssi:186 en/user_basics.ssi:194 en/user_basics.ssi:204
+#: en/user_basics.ssi:245 en/user_basics.ssi:257 en/user_basics.ssi:273
+#: en/user_basics.ssi:281 en/user_basics.ssi:308 en/user_basics.ssi:347
 #: en/user_customization-contents.ssi:39 en/user_customization-contents.ssi:54
 #: en/user_customization-contents.ssi:70
 #: en/user_customization-internationalization.ssi:14
 #: en/user_customization-internationalization.ssi:22
 #: en/user_customization-internationalization.ssi:30
 #: en/user_customization-internationalization.ssi:42
-#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:28
-#: en/user_customization-packages.ssi:41 en/user_customization-packages.ssi:49
-#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
-#: en/user_customization-packages.ssi:107
-#: en/user_customization-packages.ssi:115
-#: en/user_customization-packages.ssi:135
-#: en/user_customization-packages.ssi:172
-#: en/user_customization-packages.ssi:182
-#: en/user_customization-packages.ssi:192
-#: en/user_customization-packages.ssi:202 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:88 en/user_installation.ssi:110
-#: en/user_installation.ssi:125 en/user_installation.ssi:140
-#: en/user_managing_a_configuration.ssi:31
+#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:32
+#: en/user_customization-packages.ssi:45 en/user_customization-packages.ssi:53
+#: en/user_customization-packages.ssi:67 en/user_customization-packages.ssi:81
+#: en/user_customization-packages.ssi:111
+#: en/user_customization-packages.ssi:119
+#: en/user_customization-packages.ssi:139
+#: en/user_customization-packages.ssi:176
+#: en/user_customization-packages.ssi:186
+#: en/user_customization-packages.ssi:196
+#: en/user_customization-packages.ssi:206 en/user_examples.ssi:33
+#: 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:88
+#: en/user_installation.ssi:108 en/user_installation.ssi:123
+#: en/user_installation.ssi:138 en/user_managing_a_configuration.ssi:31
 #: en/user_managing_a_configuration.ssi:43
-#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:84
-#: en/user_overview.ssi:94 en/user_overview.ssi:102
+#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:74
+#: en/user_overview.ssi:84 en/user_overview.ssi:92
 msgid "}code"
 msgstr "}code"
 
 #. type: Plain text
-#: en/user_basics.ssi:230 en/user_customization-packages.ssi:153
+#: en/user_basics.ssi:218 en/user_customization-packages.ssi:157
 msgid "% FIXME"
 msgstr ""
 
@@ -173,65 +169,83 @@ msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:14
-msgid "To set a local mirror (used to 'build' the live system)"
+msgid "To set a local mirror to be used to at build time:"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:18
-msgid ""
-"$ lb config --mirror-bootstrap http://localhost/debian/ --mirror-chroot "
-"http://localhost/debian/"
+msgid "$ lb config --mirror-bootstrap http://localhost/debian/"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:22
-msgid "The generic mirror is added to the live system's /etc/apt/sources.list."
+msgid ""
+"The chroot repository, specified by --mirror-chroot, defaults to the same as "
+"--mirror-bootstrap."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:24
+msgid ""
+"Each of the --mirror-* options governs which repository is used at various "
+"stages of the build. Recall from {Stages of the build}#stages-of-the-build "
+"that the *bootstrap* stage is when the chroot is initially populated by "
+"debootstrap with a minimal system, and the *chroot* stage is when the chroot "
+"used to construct the live system's filesystem is built. Thus, the "
+"corresponding mirror switches are used for those stages, and later, when the "
+"binary image is constructed, the --mirror-binary value is used, superceding "
+"any earlier repositories."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:26
-msgid "$ lb config --mirror-binary http://ftp.debian.org/debian/"
+msgid "The generic mirror is added to the live system's /etc/apt/sources.list."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:30
+msgid "$ lb config --mirror-binary http://ftp.debian.org/debian/"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:34
 msgid ""
 "Note: It is not used for building the live system but to install new "
 "software while using the live system."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:32
+#: en/user_customization-packages.ssi:36
 msgid ""
 "It can be disabled by setting the binary mirror to the same value as the "
 "chroot mirror."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:34
+#: en/user_customization-packages.ssi:38
 msgid ""
 "Note: the same applies for mirror chroot security and mirror binary security"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:39
+#: en/user_customization-packages.ssi:43
 msgid ""
 "$ lb config --mirror-chroot-security {URL} $ lb config --mirror-binary-"
 "security {URL}"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:43
+#: en/user_customization-packages.ssi:47
 msgid "If you don't want to include apt indices, you can skip those with:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:47
+#: en/user_customization-packages.ssi:51
 msgid "$ lb config --binary-indices false"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:51
+#: en/user_customization-packages.ssi:55
 msgid ""
 "This will not influence the entries in /etc/apt/sources.list, but only if /"
 "var/lib/apt contains the indices files or not (and by that making the image "
@@ -239,12 +253,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:53
+#: en/user_customization-packages.ssi:57
 msgid "3~ Own repository"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:55
+#: en/user_customization-packages.ssi:59
 msgid ""
 "To add more repositories (e.g. backports, experimental or custom packages, "
 "etc.), create #{config/chroot_sources/your-repository.{chroot,binary}}# "
@@ -252,7 +266,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:57
+#: en/user_customization-packages.ssi:61
 msgid ""
 "e.g. #{config/chroot_sources/live.chroot}# allows you to install packages "
 "from the debian live snapshot repository at live system build time (you have "
@@ -260,31 +274,31 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:61
+#: en/user_customization-packages.ssi:65
 msgid "deb http://live.debian.net/ sid-snapshots main contrib non-free"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:65
+#: en/user_customization-packages.ssi:69
 msgid ""
 "If you add the line to #{config/chroot_sources/live.binary}# the repository "
 "will be added to your live-system's #{/etc/apt/sources.list}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:67
+#: en/user_customization-packages.ssi:71
 msgid "If such files exist, they will be picked up automatically."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:69
+#: en/user_customization-packages.ssi:73
 msgid ""
 "You can also put the gpg-key used to sign the repository into config/"
 "chroot_sources/your-repository.{binary,chroot}.gpg"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:71
+#: en/user_customization-packages.ssi:75
 msgid ""
 "Note: some preconfigured package repositories are available for easy "
 "selection through the --repository switch, e.g. for enabling live snapshots, "
@@ -292,17 +306,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:75
+#: en/user_customization-packages.ssi:79
 msgid "$ lb config --repository live.debian.net"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:79
+#: en/user_customization-packages.ssi:83
 msgid "3~ Package installation"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:81
+#: en/user_customization-packages.ssi:85
 msgid ""
 "You can elect to use either #{apt}# or #{aptitude}# when installing "
 "packages. Which utility is used is governed by the #{LB_APT}# variable in #"
@@ -310,7 +324,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:83
+#: en/user_customization-packages.ssi:87
 msgid ""
 "_* #{apt}#: Specifying a missing package causes package installation to "
 "fail, which may not be the desired behaviour. This is the default setting "
@@ -318,7 +332,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:85
+#: en/user_customization-packages.ssi:89
 msgid ""
 "_* #{aptitude}#: Specifying a missing package causes package installation to "
 "succeed, which may not be the desired behaviour. This is the default setting "
@@ -326,66 +340,66 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:87
+#: en/user_customization-packages.ssi:91
 msgid "2~ Installing additional packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:89
+#: en/user_customization-packages.ssi:93
 msgid ""
 "live-helper has a number of mechanisms for indicating that additional "
 "packages should be installed, including:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:91
+#: en/user_customization-packages.ssi:95
 msgid "_* The #{LB_PACKAGES}# variable"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:93
+#: en/user_customization-packages.ssi:97
 msgid "_* Package lists"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:95
+#: en/user_customization-packages.ssi:99
 msgid "_* Local packages (#{chroot_local-packages/}#)"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:97
+#: en/user_customization-packages.ssi:101
 msgid "_* Tasks"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:99
+#: en/user_customization-packages.ssi:103
 msgid "3~ The #{LB_PACKAGES}# variable"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:101
+#: en/user_customization-packages.ssi:105
 msgid ""
 "To install additional packages, simply add them to the #{LB_PACKAGES}# "
 "variable in #{config/chroot}#. For example:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:105
+#: en/user_customization-packages.ssi:109
 msgid "LB_PACKAGES=\"package1 package2 package3 ... \""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:109
+#: en/user_customization-packages.ssi:113
 msgid "You can also specify initial values on the command line:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:113
+#: en/user_customization-packages.ssi:117
 msgid "$ lb config --packages \"package1 package2 package3\""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:117
+#: en/user_customization-packages.ssi:121
 msgid ""
 "The behaviour of live-build when specifying a package that does not exist is "
 "determined by your choice of APT utility. See package-installation for more "
@@ -393,12 +407,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:119
+#: en/user_customization-packages.ssi:123
 msgid "% FIXME: <xref linkend=\"package-installation\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:121
+#: en/user_customization-packages.ssi:125
 msgid ""
 "If you need to specify a large number of packages to be installed or you "
 "need flexibility regarding which packages to install, you should probably be "
@@ -406,17 +420,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:123
+#: en/user_customization-packages.ssi:127
 msgid "% FIXME: <xref linkend=\"package-lists\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:125
+#: en/user_customization-packages.ssi:129
 msgid "3~ Package lists"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:127
+#: en/user_customization-packages.ssi:131
 msgid ""
 "Package lists are a powerful way of expressing which packages should be "
 "installed. live-build ships with a number of predefined package lists which "
@@ -425,37 +439,37 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:129
+#: en/user_customization-packages.ssi:133
 msgid "To specify one or more package list, you can use:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:133
+#: en/user_customization-packages.ssi:137
 msgid "$ lb config --packages-lists \"list1 list2 list3\""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:137
+#: en/user_customization-packages.ssi:141
 msgid ""
 "Note: Package lists that are distributed with live-build reside in the #{/"
 "usr/share/live/build/lists}# directory."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:139
+#: en/user_customization-packages.ssi:143
 #, no-wrap
 msgid "*{Local packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:141
+#: en/user_customization-packages.ssi:145
 msgid ""
 "You may supplement the supplied lists using local package lists stored in #"
 "{config/chroot_local-packageslists}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:143
+#: en/user_customization-packages.ssi:147
 msgid ""
 "Package lists that exist in this directory need to have a #{.list}# suffix "
 "in order to be processed. Local packages lists always override package lists "
@@ -464,13 +478,13 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:145
+#: en/user_customization-packages.ssi:149
 #, no-wrap
 msgid "*{Local binary packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:147
+#: en/user_customization-packages.ssi:151
 msgid ""
 "In case you want to include some required .deb packages to live media's "
 "pool/ (without installing them onto the live image) you may need to use "
@@ -480,25 +494,25 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:149
+#: en/user_customization-packages.ssi:153
 msgid ""
 "Package lists that exist in this directory need to have a .list suffix in "
 "order to be processed."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:151
+#: en/user_customization-packages.ssi:155
 #, no-wrap
 msgid "*{Extending a provided package list using includes}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:160
+#: en/user_customization-packages.ssi:164
 msgid "% code{ % % #include <gnome> % iceweasel % % }code"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:162
+#: en/user_customization-packages.ssi:166
 msgid ""
 "The package lists that are included with live-build make extensive use of "
 "includes. They are available to view in the #{/usr/share/live/build/lists}# "
@@ -506,75 +520,75 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:164
+#: en/user_customization-packages.ssi:168
 #, no-wrap
 msgid "*{Using conditionals inside packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:170
+#: en/user_customization-packages.ssi:174
 msgid "#if ARCHITECTURE amd64 ia32-libs #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:174
+#: en/user_customization-packages.ssi:178
 msgid "or if #{LB_ARCHITECTURE}# is set to #{i386}# or #{amd64}#:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:180
+#: en/user_customization-packages.ssi:184
 msgid "#if ARCHITECTURE i386 amd64 memtest86+ #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:184
+#: en/user_customization-packages.ssi:188
 msgid "or if #{LB_ARCHIVE_AREAS}# contains either #{contrib}# or #{non-free}#:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:190
+#: en/user_customization-packages.ssi:194
 msgid "#if ARCHIVE_AREAS contrib non-free vrms #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:194
+#: en/user_customization-packages.ssi:198
 msgid "A conditional may surround an #{#include}# directive:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:200
+#: en/user_customization-packages.ssi:204
 msgid "#if ARCHITECTURE amd64 #include <gnome-full> #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:204
+#: en/user_customization-packages.ssi:208
 msgid ""
 "Any live-build configuration variable that begins with #{LB_}# can be tested "
 "in this way."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:206
+#: en/user_customization-packages.ssi:210
 msgid "The nesting of conditionals is not supported."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:208
+#: en/user_customization-packages.ssi:212
 msgid "3~ Tasks"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:210
+#: en/user_customization-packages.ssi:214
 msgid "%FIXME"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:212
+#: en/user_customization-packages.ssi:216
 msgid "2~ Installing modified or third-party packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:214
+#: en/user_customization-packages.ssi:218
 msgid ""
 "Whilst it is against the philosophy of Debian Live, it may sometimes be "
 "necessary to build a Live system with modified versions of packages that are "
@@ -585,7 +599,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:216
+#: en/user_customization-packages.ssi:220
 msgid ""
 "This section does not cover advice regarding building or maintaining "
 "modified packages. Joachim Breitner's 'How to fork privately' method from "
@@ -596,22 +610,22 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:218
+#: en/user_customization-packages.ssi:222
 msgid "There are two ways of installing modified custom packages:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:220
+#: en/user_customization-packages.ssi:224
 msgid "_* #{chroot_local-packages}#"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:222
+#: en/user_customization-packages.ssi:226
 msgid "_* Using a custom APT repository"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:224
+#: en/user_customization-packages.ssi:228
 msgid ""
 "The #{chroot_local-packages}# is simpler to achieve and useful for \"one-off"
 "\" customizations but has a number of drawbacks, whilst using a custom APT "
@@ -619,12 +633,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:226
+#: en/user_customization-packages.ssi:230
 msgid "3~ Using #{chroot_local-packages}# to install custom packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:228
+#: en/user_customization-packages.ssi:232
 msgid ""
 "To install a custom package, simply copy it to the #{config/chroot_local-"
 "packages}# directory. Packages that are inside this directory will be "
@@ -633,45 +647,45 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:230
+#: en/user_customization-packages.ssi:234
 msgid ""
 "Packages *{must}* be named in the prescribed way. One simple way to do this "
 "is to use #{dpkg-name}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:232
+#: en/user_customization-packages.ssi:236
 msgid ""
 "Using #{chroot_local-packages}# for installation of custom packages has "
 "disadvantages:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:234
+#: en/user_customization-packages.ssi:238
 msgid "_* It is not possible to use secure APT"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:236
+#: en/user_customization-packages.ssi:240
 msgid ""
 "_* You must install all appropriate packages in the #{config/chroot_local-"
 "packages}# directory"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:238
+#: en/user_customization-packages.ssi:242
 msgid ""
 "_* It does not lend itself to storing Debian Live configurations in revision "
 "control"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:240
+#: en/user_customization-packages.ssi:244
 msgid "3~ Using an APT repository to install custom packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:242
+#: en/user_customization-packages.ssi:246
 msgid ""
 "Unlike using #{chroot_local-packages}#, when using a custom APT repository "
 "you must ensure that you specify the packages elsewhere. See lb-packages for "
@@ -679,12 +693,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:244
+#: en/user_customization-packages.ssi:248
 msgid "% FIXME: <xref linkend=\"lb-packages\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:246
+#: en/user_customization-packages.ssi:250
 msgid ""
 "Whilst it may seem unnecessary effort to create an APT repository to install "
 "custom packages, the infrastructure can be easily re-used at a later date to "
@@ -692,12 +706,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:248
+#: en/user_customization-packages.ssi:252
 msgid "3~ Custom packages and APT"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:250
+#: en/user_customization-packages.ssi:254
 msgid ""
 "live-build uses APT to install all packages into the live system so will "
 "therefore inherit behaviours from this program. One relevant example is that "
@@ -707,7 +721,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:252
+#: en/user_customization-packages.ssi:256
 msgid ""
 "Because of this, you may wish to increment the version number in your custom "
 "packages' #{debian/changelog}# files to ensure that your modified version is "
@@ -717,17 +731,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:254
+#: en/user_customization-packages.ssi:258
 msgid "% FIXME: <xref linkend=\"apt-preferences\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:256
+#: en/user_customization-packages.ssi:260
 msgid "3~ Altering APT preferences during Live system"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:257
+#: en/user_customization-packages.ssi:261
 msgid ""
 "Whilst it may seem unnecessary effort to create an APT repository to install "
 "custom packages, the infrastructure can be easily re-used at a later date to "
diff --git a/manual/po/pt_BR/live-manual.ssm.po b/manual/po/pt_BR/live-manual.ssm.po
index 5334a36..6278992 100644
--- a/manual/po/pt_BR/live-manual.ssm.po
+++ b/manual/po/pt_BR/live-manual.ssm.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-11-04 16:34-0400\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-22 07:52-0200\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -45,7 +45,7 @@ msgstr ""
 #, no-wrap
 msgid ""
 "@date:\n"
-" :published: 2010-11-04\n"
+" :published: 2010-11-07\n"
 msgstr ""
 
 #. type: Plain text
diff --git a/manual/po/pt_BR/user_customization-overview.ssi.po b/manual/po/pt_BR/user_customization-overview.ssi.po
index 616a788..7fab156 100644
--- a/manual/po/pt_BR/user_customization-overview.ssi.po
+++ b/manual/po/pt_BR/user_customization-overview.ssi.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-29 17:14-0200\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-22 08:57-0200\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -35,40 +35,86 @@ msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:8
-msgid ""
-"It is important to understand the different layers of a Live system to know "
-"where configurations must occur, and particular, to know when they are "
-"applied. Of course, all configurations are in some way processed by live-"
-"build at build time, but some parts of setting up the Live system don't "
-"actually occur until boot time, either early in the boot by live-boot, or "
-"later by live-config. Thus, it is necessary to have a way to specify boot-"
-"time customizations. In particular, while most #{lb config}# options control "
-"aspects of the build, #{--bootappend-live}# will pass additional options "
-"through the kernel command line to set things up at boot time, such as "
-"persistence, keyboard layouts, or timezone."
+msgid "2~ Build time vs. boot time configuration"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:10
 msgid ""
-"Therefore, in addition to the man pages included in live-build, you should "
-"keep near at hand the man pages for live-boot and live-config. Although the "
-"live-boot and live-config packages are installed within the live system you "
-"are building, it is recommended that you also install them on your build "
-"system for easy reference when you are working on your configuration. It is "
-"safe to do so, as none of the scripts contained within them are executed "
-"unless the system is configured as a live system."
+"Live system configuration options are divided into those that are applied at "
+"build time and those that are applied at boot time. Boot-time options are "
+"further divided into those occurring early in the boot, applied by the live-"
+"boot package, and those that happen later in the boot, applied by live-"
+"config. Any boot-time option may be modified by the user by specifying it at "
+"the boot prompt. The image may also be built with default boot parameters so "
+"users can normally just boot directly to the live system without specifying "
+"any options when all of the defaults are suitable. In particular, the "
+"argument to #{lb --bootappend-live}# consists of any default kernel command "
+"line options for the Live system, such as persistence, keyboard layouts, or "
+"timezone. See {Customizing locale and language}#customizing-locale-and-"
+"language, for example."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:12
 msgid ""
-"You should also be aware of the kinds of material that go into a Debian live "
-"configuration. Although #{lb config}# does create a skeletal configuration "
-"in the config/ directory, to accomplish your goals, you may need to provide "
-"additional files in subdirectories of config/. Depending on where the files "
-"are stored in the configuration, they may be copied into the live system's "
-"filesystem or into the binary image filesystem, or may provide build-time "
+"Build-time configuration options are described in the #{lb config}# man "
+"page. Boot-time options are described in the man pages for live-boot and "
+"live-config. Although the live-boot and live-config packages are installed "
+"within the live system you are building, it is recommended that you also "
+"install them on your build system for easy reference when you are working on "
+"your configuration. It is safe to do so, as none of the scripts contained "
+"within them are executed unless the system is configured as a live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:14
+msgid "2~stages-of-the-build Stages of the build"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:16
+msgid ""
+"The build process is divided into stages, with various customizations "
+"applied in sequence in each. The first stage to run is the *{bootstrap}* "
+"stage. This is the initial phase of populating the chroot directory with "
+"packages to make a barebones Debian system. This is followed by the *{chroot}"
+"* stage, which completes the construction of chroot directory, populating it "
+"with all of the packages listed in the configuration, along with any other "
+"materials. Most customization of content occurs in this stage. The final "
+"stage of preparing the live image is the *{binary}* stage, which builds a "
+"bootable image, using the contents of the chroot directory to construct the "
+"root filesystem for the Live system, and including the installer and any "
+"other additional material on the target media outside of the Live system's "
+"filesystem. After the live image is built, if enabled, the source tarball is "
+"built in the *{source}* stage."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:18
+msgid ""
+"Within each of these stages, there is a particular sequence in which "
+"commands are applied. These are arranged in such a way as to ensure "
+"customizations can be layered in a reasonable fashion. For example, within "
+"the *{chroot}* stage, preseeds are applied before any packages are "
+"installed, packages are installed before any locally included files or "
+"patches are applied, and hooks are run later, after all of the materials are "
+"in place."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:20
+msgid "2~ Supplement #{lb config}# with files"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:22
+msgid ""
+"Although #{lb config}# does create a skeletal configuration in the config/ "
+"directory, to accomplish your goals, you may need to provide additional "
+"files in subdirectories of config/. Depending on where the files are stored "
+"in the configuration, they may be copied into the live system's filesystem "
+"or into the binary image filesystem, or may provide build-time "
 "configurations of the system that would be cumbersome to pass as command-"
 "line options. You may include things such as custom lists of packages, "
 "custom artwork, or hook scripts to run either at build time or at boot time, "
@@ -77,7 +123,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-overview.ssi:14
+#: en/user_customization-overview.ssi:24
+msgid "2~ Customization tasks"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:26
 msgid ""
 "The following chapters are organized by the kinds of customization task "
 "users typically perform: {Customizing package installation}#customizing-"
diff --git a/manual/po/pt_BR/user_customization-packages.ssi.po b/manual/po/pt_BR/user_customization-packages.ssi.po
index 143ae89..e041621 100644
--- a/manual/po/pt_BR/user_customization-packages.ssi.po
+++ b/manual/po/pt_BR/user_customization-packages.ssi.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-22 08:58-0200\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-22 08:58-0200\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -39,40 +39,38 @@ msgstr ""
 #: 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:36
-#: en/user_basics.ssi:48 en/user_basics.ssi:62 en/user_basics.ssi:74
-#: en/user_basics.ssi:86 en/user_basics.ssi:98 en/user_basics.ssi:114
-#: en/user_basics.ssi:122 en/user_basics.ssi:130 en/user_basics.ssi:140
-#: en/user_basics.ssi:152 en/user_basics.ssi:164 en/user_basics.ssi:172
-#: en/user_basics.ssi:180 en/user_basics.ssi:194 en/user_basics.ssi:202
-#: en/user_basics.ssi:212 en/user_basics.ssi:232 en/user_basics.ssi:265
-#: en/user_basics.ssi:281 en/user_basics.ssi:289 en/user_basics.ssi:309
-#: en/user_basics.ssi:334 en/user_customization-contents.ssi:34
+#: en/other_procedures.ssi:58 en/project_bugs.ssi:58 en/user_basics.ssi:32
+#: en/user_basics.ssi:42 en/user_basics.ssi:54 en/user_basics.ssi:66
+#: en/user_basics.ssi:78 en/user_basics.ssi:88 en/user_basics.ssi:102
+#: en/user_basics.ssi:110 en/user_basics.ssi:118 en/user_basics.ssi:128
+#: en/user_basics.ssi:140 en/user_basics.ssi:152 en/user_basics.ssi:160
+#: en/user_basics.ssi:168 en/user_basics.ssi:182 en/user_basics.ssi:190
+#: en/user_basics.ssi:200 en/user_basics.ssi:220 en/user_basics.ssi:253
+#: en/user_basics.ssi:269 en/user_basics.ssi:277 en/user_basics.ssi:297
+#: en/user_basics.ssi:322 en/user_customization-contents.ssi:34
 #: en/user_customization-contents.ssi:43 en/user_customization-contents.ssi:66
 #: en/user_customization-internationalization.ssi:10
 #: en/user_customization-internationalization.ssi:18
 #: en/user_customization-internationalization.ssi:26
 #: en/user_customization-internationalization.ssi:38
-#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:24
-#: en/user_customization-packages.ssi:36 en/user_customization-packages.ssi:45
-#: en/user_customization-packages.ssi:59 en/user_customization-packages.ssi:73
-#: en/user_customization-packages.ssi:103
-#: en/user_customization-packages.ssi:111
-#: en/user_customization-packages.ssi:131
-#: en/user_customization-packages.ssi:166
-#: en/user_customization-packages.ssi:176
-#: en/user_customization-packages.ssi:186
-#: en/user_customization-packages.ssi:196 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:106
-#: en/user_installation.ssi:120 en/user_installation.ssi:137
-#: en/user_managing_a_configuration.ssi:24
+#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:28
+#: en/user_customization-packages.ssi:40 en/user_customization-packages.ssi:49
+#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
+#: en/user_customization-packages.ssi:107
+#: en/user_customization-packages.ssi:115
+#: en/user_customization-packages.ssi:135
+#: en/user_customization-packages.ssi:170
+#: en/user_customization-packages.ssi:180
+#: en/user_customization-packages.ssi:190
+#: en/user_customization-packages.ssi:200 en/user_examples.ssi:24
+#: 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:135 en/user_managing_a_configuration.ssi:24
 #: en/user_managing_a_configuration.ssi:35
-#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:46
-#: en/user_overview.ssi:90 en/user_overview.ssi:98
+#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:36
+#: en/user_overview.ssi:80 en/user_overview.ssi:88
 msgid "code{"
 msgstr "code{"
 
@@ -99,45 +97,43 @@ msgstr "code{"
 #: 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:40 en/user_basics.ssi:52
-#: en/user_basics.ssi:68 en/user_basics.ssi:78 en/user_basics.ssi:92
-#: en/user_basics.ssi:104 en/user_basics.ssi:118 en/user_basics.ssi:126
-#: en/user_basics.ssi:134 en/user_basics.ssi:144 en/user_basics.ssi:158
-#: en/user_basics.ssi:168 en/user_basics.ssi:176 en/user_basics.ssi:184
-#: en/user_basics.ssi:198 en/user_basics.ssi:206 en/user_basics.ssi:216
-#: en/user_basics.ssi:257 en/user_basics.ssi:269 en/user_basics.ssi:285
-#: en/user_basics.ssi:293 en/user_basics.ssi:320 en/user_basics.ssi:359
+#: en/project_bugs.ssi:62 en/user_basics.ssi:36 en/user_basics.ssi:46
+#: en/user_basics.ssi:60 en/user_basics.ssi:72 en/user_basics.ssi:82
+#: en/user_basics.ssi:94 en/user_basics.ssi:106 en/user_basics.ssi:114
+#: en/user_basics.ssi:122 en/user_basics.ssi:132 en/user_basics.ssi:146
+#: en/user_basics.ssi:156 en/user_basics.ssi:164 en/user_basics.ssi:172
+#: en/user_basics.ssi:186 en/user_basics.ssi:194 en/user_basics.ssi:204
+#: en/user_basics.ssi:245 en/user_basics.ssi:257 en/user_basics.ssi:273
+#: en/user_basics.ssi:281 en/user_basics.ssi:308 en/user_basics.ssi:347
 #: en/user_customization-contents.ssi:39 en/user_customization-contents.ssi:54
 #: en/user_customization-contents.ssi:70
 #: en/user_customization-internationalization.ssi:14
 #: en/user_customization-internationalization.ssi:22
 #: en/user_customization-internationalization.ssi:30
 #: en/user_customization-internationalization.ssi:42
-#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:28
-#: en/user_customization-packages.ssi:41 en/user_customization-packages.ssi:49
-#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
-#: en/user_customization-packages.ssi:107
-#: en/user_customization-packages.ssi:115
-#: en/user_customization-packages.ssi:135
-#: en/user_customization-packages.ssi:172
-#: en/user_customization-packages.ssi:182
-#: en/user_customization-packages.ssi:192
-#: en/user_customization-packages.ssi:202 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:88 en/user_installation.ssi:110
-#: en/user_installation.ssi:125 en/user_installation.ssi:140
-#: en/user_managing_a_configuration.ssi:31
+#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:32
+#: en/user_customization-packages.ssi:45 en/user_customization-packages.ssi:53
+#: en/user_customization-packages.ssi:67 en/user_customization-packages.ssi:81
+#: en/user_customization-packages.ssi:111
+#: en/user_customization-packages.ssi:119
+#: en/user_customization-packages.ssi:139
+#: en/user_customization-packages.ssi:176
+#: en/user_customization-packages.ssi:186
+#: en/user_customization-packages.ssi:196
+#: en/user_customization-packages.ssi:206 en/user_examples.ssi:33
+#: 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:88
+#: en/user_installation.ssi:108 en/user_installation.ssi:123
+#: en/user_installation.ssi:138 en/user_managing_a_configuration.ssi:31
 #: en/user_managing_a_configuration.ssi:43
-#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:84
-#: en/user_overview.ssi:94 en/user_overview.ssi:102
+#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:74
+#: en/user_overview.ssi:84 en/user_overview.ssi:92
 msgid "}code"
 msgstr "}code"
 
 #. type: Plain text
-#: en/user_basics.ssi:230 en/user_customization-packages.ssi:153
+#: en/user_basics.ssi:218 en/user_customization-packages.ssi:157
 msgid "% FIXME"
 msgstr ""
 
@@ -173,65 +169,83 @@ msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:14
-msgid "To set a local mirror (used to 'build' the live system)"
+msgid "To set a local mirror to be used to at build time:"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:18
-msgid ""
-"$ lb config --mirror-bootstrap http://localhost/debian/ --mirror-chroot "
-"http://localhost/debian/"
+msgid "$ lb config --mirror-bootstrap http://localhost/debian/"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:22
-msgid "The generic mirror is added to the live system's /etc/apt/sources.list."
+msgid ""
+"The chroot repository, specified by --mirror-chroot, defaults to the same as "
+"--mirror-bootstrap."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:24
+msgid ""
+"Each of the --mirror-* options governs which repository is used at various "
+"stages of the build. Recall from {Stages of the build}#stages-of-the-build "
+"that the *bootstrap* stage is when the chroot is initially populated by "
+"debootstrap with a minimal system, and the *chroot* stage is when the chroot "
+"used to construct the live system's filesystem is built. Thus, the "
+"corresponding mirror switches are used for those stages, and later, when the "
+"binary image is constructed, the --mirror-binary value is used, superceding "
+"any earlier repositories."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:26
-msgid "$ lb config --mirror-binary http://ftp.debian.org/debian/"
+msgid "The generic mirror is added to the live system's /etc/apt/sources.list."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:30
+msgid "$ lb config --mirror-binary http://ftp.debian.org/debian/"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:34
 msgid ""
 "Note: It is not used for building the live system but to install new "
 "software while using the live system."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:32
+#: en/user_customization-packages.ssi:36
 msgid ""
 "It can be disabled by setting the binary mirror to the same value as the "
 "chroot mirror."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:34
+#: en/user_customization-packages.ssi:38
 msgid ""
 "Note: the same applies for mirror chroot security and mirror binary security"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:39
+#: en/user_customization-packages.ssi:43
 msgid ""
 "$ lb config --mirror-chroot-security {URL} $ lb config --mirror-binary-"
 "security {URL}"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:43
+#: en/user_customization-packages.ssi:47
 msgid "If you don't want to include apt indices, you can skip those with:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:47
+#: en/user_customization-packages.ssi:51
 msgid "$ lb config --binary-indices false"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:51
+#: en/user_customization-packages.ssi:55
 msgid ""
 "This will not influence the entries in /etc/apt/sources.list, but only if /"
 "var/lib/apt contains the indices files or not (and by that making the image "
@@ -239,12 +253,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:53
+#: en/user_customization-packages.ssi:57
 msgid "3~ Own repository"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:55
+#: en/user_customization-packages.ssi:59
 msgid ""
 "To add more repositories (e.g. backports, experimental or custom packages, "
 "etc.), create #{config/chroot_sources/your-repository.{chroot,binary}}# "
@@ -252,7 +266,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:57
+#: en/user_customization-packages.ssi:61
 msgid ""
 "e.g. #{config/chroot_sources/live.chroot}# allows you to install packages "
 "from the debian live snapshot repository at live system build time (you have "
@@ -260,31 +274,31 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:61
+#: en/user_customization-packages.ssi:65
 msgid "deb http://live.debian.net/ sid-snapshots main contrib non-free"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:65
+#: en/user_customization-packages.ssi:69
 msgid ""
 "If you add the line to #{config/chroot_sources/live.binary}# the repository "
 "will be added to your live-system's #{/etc/apt/sources.list}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:67
+#: en/user_customization-packages.ssi:71
 msgid "If such files exist, they will be picked up automatically."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:69
+#: en/user_customization-packages.ssi:73
 msgid ""
 "You can also put the gpg-key used to sign the repository into config/"
 "chroot_sources/your-repository.{binary,chroot}.gpg"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:71
+#: en/user_customization-packages.ssi:75
 msgid ""
 "Note: some preconfigured package repositories are available for easy "
 "selection through the --repository switch, e.g. for enabling live snapshots, "
@@ -292,17 +306,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:75
+#: en/user_customization-packages.ssi:79
 msgid "$ lb config --repository live.debian.net"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:79
+#: en/user_customization-packages.ssi:83
 msgid "3~ Package installation"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:81
+#: en/user_customization-packages.ssi:85
 msgid ""
 "You can elect to use either #{apt}# or #{aptitude}# when installing "
 "packages. Which utility is used is governed by the #{LB_APT}# variable in #"
@@ -310,7 +324,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:83
+#: en/user_customization-packages.ssi:87
 msgid ""
 "_* #{apt}#: Specifying a missing package causes package installation to "
 "fail, which may not be the desired behaviour. This is the default setting "
@@ -318,7 +332,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:85
+#: en/user_customization-packages.ssi:89
 msgid ""
 "_* #{aptitude}#: Specifying a missing package causes package installation to "
 "succeed, which may not be the desired behaviour. This is the default setting "
@@ -326,66 +340,66 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:87
+#: en/user_customization-packages.ssi:91
 msgid "2~ Installing additional packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:89
+#: en/user_customization-packages.ssi:93
 msgid ""
 "live-helper has a number of mechanisms for indicating that additional "
 "packages should be installed, including:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:91
+#: en/user_customization-packages.ssi:95
 msgid "_* The #{LB_PACKAGES}# variable"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:93
+#: en/user_customization-packages.ssi:97
 msgid "_* Package lists"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:95
+#: en/user_customization-packages.ssi:99
 msgid "_* Local packages (#{chroot_local-packages/}#)"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:97
+#: en/user_customization-packages.ssi:101
 msgid "_* Tasks"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:99
+#: en/user_customization-packages.ssi:103
 msgid "3~ The #{LB_PACKAGES}# variable"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:101
+#: en/user_customization-packages.ssi:105
 msgid ""
 "To install additional packages, simply add them to the #{LB_PACKAGES}# "
 "variable in #{config/chroot}#. For example:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:105
+#: en/user_customization-packages.ssi:109
 msgid "LB_PACKAGES=\"package1 package2 package3 ... \""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:109
+#: en/user_customization-packages.ssi:113
 msgid "You can also specify initial values on the command line:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:113
+#: en/user_customization-packages.ssi:117
 msgid "$ lb config --packages \"package1 package2 package3\""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:117
+#: en/user_customization-packages.ssi:121
 msgid ""
 "The behaviour of live-build when specifying a package that does not exist is "
 "determined by your choice of APT utility. See package-installation for more "
@@ -393,12 +407,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:119
+#: en/user_customization-packages.ssi:123
 msgid "% FIXME: <xref linkend=\"package-installation\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:121
+#: en/user_customization-packages.ssi:125
 msgid ""
 "If you need to specify a large number of packages to be installed or you "
 "need flexibility regarding which packages to install, you should probably be "
@@ -406,17 +420,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:123
+#: en/user_customization-packages.ssi:127
 msgid "% FIXME: <xref linkend=\"package-lists\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:125
+#: en/user_customization-packages.ssi:129
 msgid "3~ Package lists"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:127
+#: en/user_customization-packages.ssi:131
 msgid ""
 "Package lists are a powerful way of expressing which packages should be "
 "installed. live-build ships with a number of predefined package lists which "
@@ -425,37 +439,37 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:129
+#: en/user_customization-packages.ssi:133
 msgid "To specify one or more package list, you can use:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:133
+#: en/user_customization-packages.ssi:137
 msgid "$ lb config --packages-lists \"list1 list2 list3\""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:137
+#: en/user_customization-packages.ssi:141
 msgid ""
 "Note: Package lists that are distributed with live-build reside in the #{/"
 "usr/share/live/build/lists}# directory."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:139
+#: en/user_customization-packages.ssi:143
 #, no-wrap
 msgid "*{Local packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:141
+#: en/user_customization-packages.ssi:145
 msgid ""
 "You may supplement the supplied lists using local package lists stored in #"
 "{config/chroot_local-packageslists}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:143
+#: en/user_customization-packages.ssi:147
 msgid ""
 "Package lists that exist in this directory need to have a #{.list}# suffix "
 "in order to be processed. Local packages lists always override package lists "
@@ -464,13 +478,13 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:145
+#: en/user_customization-packages.ssi:149
 #, no-wrap
 msgid "*{Local binary packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:147
+#: en/user_customization-packages.ssi:151
 msgid ""
 "In case you want to include some required .deb packages to live media's "
 "pool/ (without installing them onto the live image) you may need to use "
@@ -480,25 +494,25 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:149
+#: en/user_customization-packages.ssi:153
 msgid ""
 "Package lists that exist in this directory need to have a .list suffix in "
 "order to be processed."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:151
+#: en/user_customization-packages.ssi:155
 #, no-wrap
 msgid "*{Extending a provided package list using includes}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:160
+#: en/user_customization-packages.ssi:164
 msgid "% code{ % % #include <gnome> % iceweasel % % }code"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:162
+#: en/user_customization-packages.ssi:166
 msgid ""
 "The package lists that are included with live-build make extensive use of "
 "includes. They are available to view in the #{/usr/share/live/build/lists}# "
@@ -506,75 +520,75 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:164
+#: en/user_customization-packages.ssi:168
 #, no-wrap
 msgid "*{Using conditionals inside packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:170
+#: en/user_customization-packages.ssi:174
 msgid "#if ARCHITECTURE amd64 ia32-libs #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:174
+#: en/user_customization-packages.ssi:178
 msgid "or if #{LB_ARCHITECTURE}# is set to #{i386}# or #{amd64}#:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:180
+#: en/user_customization-packages.ssi:184
 msgid "#if ARCHITECTURE i386 amd64 memtest86+ #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:184
+#: en/user_customization-packages.ssi:188
 msgid "or if #{LB_ARCHIVE_AREAS}# contains either #{contrib}# or #{non-free}#:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:190
+#: en/user_customization-packages.ssi:194
 msgid "#if ARCHIVE_AREAS contrib non-free vrms #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:194
+#: en/user_customization-packages.ssi:198
 msgid "A conditional may surround an #{#include}# directive:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:200
+#: en/user_customization-packages.ssi:204
 msgid "#if ARCHITECTURE amd64 #include <gnome-full> #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:204
+#: en/user_customization-packages.ssi:208
 msgid ""
 "Any live-build configuration variable that begins with #{LB_}# can be tested "
 "in this way."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:206
+#: en/user_customization-packages.ssi:210
 msgid "The nesting of conditionals is not supported."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:208
+#: en/user_customization-packages.ssi:212
 msgid "3~ Tasks"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:210
+#: en/user_customization-packages.ssi:214
 msgid "%FIXME"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:212
+#: en/user_customization-packages.ssi:216
 msgid "2~ Installing modified or third-party packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:214
+#: en/user_customization-packages.ssi:218
 msgid ""
 "Whilst it is against the philosophy of Debian Live, it may sometimes be "
 "necessary to build a Live system with modified versions of packages that are "
@@ -585,7 +599,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:216
+#: en/user_customization-packages.ssi:220
 msgid ""
 "This section does not cover advice regarding building or maintaining "
 "modified packages. Joachim Breitner's 'How to fork privately' method from "
@@ -596,22 +610,22 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:218
+#: en/user_customization-packages.ssi:222
 msgid "There are two ways of installing modified custom packages:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:220
+#: en/user_customization-packages.ssi:224
 msgid "_* #{chroot_local-packages}#"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:222
+#: en/user_customization-packages.ssi:226
 msgid "_* Using a custom APT repository"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:224
+#: en/user_customization-packages.ssi:228
 msgid ""
 "The #{chroot_local-packages}# is simpler to achieve and useful for \"one-off"
 "\" customizations but has a number of drawbacks, whilst using a custom APT "
@@ -619,12 +633,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:226
+#: en/user_customization-packages.ssi:230
 msgid "3~ Using #{chroot_local-packages}# to install custom packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:228
+#: en/user_customization-packages.ssi:232
 msgid ""
 "To install a custom package, simply copy it to the #{config/chroot_local-"
 "packages}# directory. Packages that are inside this directory will be "
@@ -633,45 +647,45 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:230
+#: en/user_customization-packages.ssi:234
 msgid ""
 "Packages *{must}* be named in the prescribed way. One simple way to do this "
 "is to use #{dpkg-name}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:232
+#: en/user_customization-packages.ssi:236
 msgid ""
 "Using #{chroot_local-packages}# for installation of custom packages has "
 "disadvantages:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:234
+#: en/user_customization-packages.ssi:238
 msgid "_* It is not possible to use secure APT"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:236
+#: en/user_customization-packages.ssi:240
 msgid ""
 "_* You must install all appropriate packages in the #{config/chroot_local-"
 "packages}# directory"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:238
+#: en/user_customization-packages.ssi:242
 msgid ""
 "_* It does not lend itself to storing Debian Live configurations in revision "
 "control"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:240
+#: en/user_customization-packages.ssi:244
 msgid "3~ Using an APT repository to install custom packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:242
+#: en/user_customization-packages.ssi:246
 msgid ""
 "Unlike using #{chroot_local-packages}#, when using a custom APT repository "
 "you must ensure that you specify the packages elsewhere. See lb-packages for "
@@ -679,12 +693,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:244
+#: en/user_customization-packages.ssi:248
 msgid "% FIXME: <xref linkend=\"lb-packages\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:246
+#: en/user_customization-packages.ssi:250
 msgid ""
 "Whilst it may seem unnecessary effort to create an APT repository to install "
 "custom packages, the infrastructure can be easily re-used at a later date to "
@@ -692,12 +706,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:248
+#: en/user_customization-packages.ssi:252
 msgid "3~ Custom packages and APT"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:250
+#: en/user_customization-packages.ssi:254
 msgid ""
 "live-build uses APT to install all packages into the live system so will "
 "therefore inherit behaviours from this program. One relevant example is that "
@@ -707,7 +721,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:252
+#: en/user_customization-packages.ssi:256
 msgid ""
 "Because of this, you may wish to increment the version number in your custom "
 "packages' #{debian/changelog}# files to ensure that your modified version is "
@@ -717,17 +731,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:254
+#: en/user_customization-packages.ssi:258
 msgid "% FIXME: <xref linkend=\"apt-preferences\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:256
+#: en/user_customization-packages.ssi:260
 msgid "3~ Altering APT preferences during Live system"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:257
+#: en/user_customization-packages.ssi:261
 msgid ""
 "Whilst it may seem unnecessary effort to create an APT repository to install "
 "custom packages, the infrastructure can be easily re-used at a later date to "
diff --git a/manual/po/ro/live-manual.ssm.po b/manual/po/ro/live-manual.ssm.po
index efe11e2..12351d0 100644
--- a/manual/po/ro/live-manual.ssm.po
+++ b/manual/po/ro/live-manual.ssm.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-11-04 16:34-0400\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-23 00:04+0300\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -46,7 +46,7 @@ msgstr ""
 #, no-wrap
 msgid ""
 "@date:\n"
-" :published: 2010-11-04\n"
+" :published: 2010-11-07\n"
 msgstr ""
 
 #. type: Plain text
diff --git a/manual/po/ro/user_customization-overview.ssi.po b/manual/po/ro/user_customization-overview.ssi.po
index 5bb900a..470c37b 100644
--- a/manual/po/ro/user_customization-overview.ssi.po
+++ b/manual/po/ro/user_customization-overview.ssi.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-29 17:14-0200\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-22 08:57-0200\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -36,40 +36,86 @@ msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:8
-msgid ""
-"It is important to understand the different layers of a Live system to know "
-"where configurations must occur, and particular, to know when they are "
-"applied. Of course, all configurations are in some way processed by live-"
-"build at build time, but some parts of setting up the Live system don't "
-"actually occur until boot time, either early in the boot by live-boot, or "
-"later by live-config. Thus, it is necessary to have a way to specify boot-"
-"time customizations. In particular, while most #{lb config}# options control "
-"aspects of the build, #{--bootappend-live}# will pass additional options "
-"through the kernel command line to set things up at boot time, such as "
-"persistence, keyboard layouts, or timezone."
+msgid "2~ Build time vs. boot time configuration"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:10
 msgid ""
-"Therefore, in addition to the man pages included in live-build, you should "
-"keep near at hand the man pages for live-boot and live-config. Although the "
-"live-boot and live-config packages are installed within the live system you "
-"are building, it is recommended that you also install them on your build "
-"system for easy reference when you are working on your configuration. It is "
-"safe to do so, as none of the scripts contained within them are executed "
-"unless the system is configured as a live system."
+"Live system configuration options are divided into those that are applied at "
+"build time and those that are applied at boot time. Boot-time options are "
+"further divided into those occurring early in the boot, applied by the live-"
+"boot package, and those that happen later in the boot, applied by live-"
+"config. Any boot-time option may be modified by the user by specifying it at "
+"the boot prompt. The image may also be built with default boot parameters so "
+"users can normally just boot directly to the live system without specifying "
+"any options when all of the defaults are suitable. In particular, the "
+"argument to #{lb --bootappend-live}# consists of any default kernel command "
+"line options for the Live system, such as persistence, keyboard layouts, or "
+"timezone. See {Customizing locale and language}#customizing-locale-and-"
+"language, for example."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:12
 msgid ""
-"You should also be aware of the kinds of material that go into a Debian live "
-"configuration. Although #{lb config}# does create a skeletal configuration "
-"in the config/ directory, to accomplish your goals, you may need to provide "
-"additional files in subdirectories of config/. Depending on where the files "
-"are stored in the configuration, they may be copied into the live system's "
-"filesystem or into the binary image filesystem, or may provide build-time "
+"Build-time configuration options are described in the #{lb config}# man "
+"page. Boot-time options are described in the man pages for live-boot and "
+"live-config. Although the live-boot and live-config packages are installed "
+"within the live system you are building, it is recommended that you also "
+"install them on your build system for easy reference when you are working on "
+"your configuration. It is safe to do so, as none of the scripts contained "
+"within them are executed unless the system is configured as a live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:14
+msgid "2~stages-of-the-build Stages of the build"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:16
+msgid ""
+"The build process is divided into stages, with various customizations "
+"applied in sequence in each. The first stage to run is the *{bootstrap}* "
+"stage. This is the initial phase of populating the chroot directory with "
+"packages to make a barebones Debian system. This is followed by the *{chroot}"
+"* stage, which completes the construction of chroot directory, populating it "
+"with all of the packages listed in the configuration, along with any other "
+"materials. Most customization of content occurs in this stage. The final "
+"stage of preparing the live image is the *{binary}* stage, which builds a "
+"bootable image, using the contents of the chroot directory to construct the "
+"root filesystem for the Live system, and including the installer and any "
+"other additional material on the target media outside of the Live system's "
+"filesystem. After the live image is built, if enabled, the source tarball is "
+"built in the *{source}* stage."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:18
+msgid ""
+"Within each of these stages, there is a particular sequence in which "
+"commands are applied. These are arranged in such a way as to ensure "
+"customizations can be layered in a reasonable fashion. For example, within "
+"the *{chroot}* stage, preseeds are applied before any packages are "
+"installed, packages are installed before any locally included files or "
+"patches are applied, and hooks are run later, after all of the materials are "
+"in place."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:20
+msgid "2~ Supplement #{lb config}# with files"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:22
+msgid ""
+"Although #{lb config}# does create a skeletal configuration in the config/ "
+"directory, to accomplish your goals, you may need to provide additional "
+"files in subdirectories of config/. Depending on where the files are stored "
+"in the configuration, they may be copied into the live system's filesystem "
+"or into the binary image filesystem, or may provide build-time "
 "configurations of the system that would be cumbersome to pass as command-"
 "line options. You may include things such as custom lists of packages, "
 "custom artwork, or hook scripts to run either at build time or at boot time, "
@@ -78,7 +124,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-overview.ssi:14
+#: en/user_customization-overview.ssi:24
+msgid "2~ Customization tasks"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:26
 msgid ""
 "The following chapters are organized by the kinds of customization task "
 "users typically perform: {Customizing package installation}#customizing-"
diff --git a/manual/po/ro/user_customization-packages.ssi.po b/manual/po/ro/user_customization-packages.ssi.po
index 939dfaf..3a3a931 100644
--- a/manual/po/ro/user_customization-packages.ssi.po
+++ b/manual/po/ro/user_customization-packages.ssi.po
@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-22 08:58-0200\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\n"
 "PO-Revision-Date: 2010-10-22 08:58-0200\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -40,40 +40,38 @@ msgstr ""
 #: 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:36
-#: en/user_basics.ssi:48 en/user_basics.ssi:62 en/user_basics.ssi:74
-#: en/user_basics.ssi:86 en/user_basics.ssi:98 en/user_basics.ssi:114
-#: en/user_basics.ssi:122 en/user_basics.ssi:130 en/user_basics.ssi:140
-#: en/user_basics.ssi:152 en/user_basics.ssi:164 en/user_basics.ssi:172
-#: en/user_basics.ssi:180 en/user_basics.ssi:194 en/user_basics.ssi:202
-#: en/user_basics.ssi:212 en/user_basics.ssi:232 en/user_basics.ssi:265
-#: en/user_basics.ssi:281 en/user_basics.ssi:289 en/user_basics.ssi:309
-#: en/user_basics.ssi:334 en/user_customization-contents.ssi:34
+#: en/other_procedures.ssi:58 en/project_bugs.ssi:58 en/user_basics.ssi:32
+#: en/user_basics.ssi:42 en/user_basics.ssi:54 en/user_basics.ssi:66
+#: en/user_basics.ssi:78 en/user_basics.ssi:88 en/user_basics.ssi:102
+#: en/user_basics.ssi:110 en/user_basics.ssi:118 en/user_basics.ssi:128
+#: en/user_basics.ssi:140 en/user_basics.ssi:152 en/user_basics.ssi:160
+#: en/user_basics.ssi:168 en/user_basics.ssi:182 en/user_basics.ssi:190
+#: en/user_basics.ssi:200 en/user_basics.ssi:220 en/user_basics.ssi:253
+#: en/user_basics.ssi:269 en/user_basics.ssi:277 en/user_basics.ssi:297
+#: en/user_basics.ssi:322 en/user_customization-contents.ssi:34
 #: en/user_customization-contents.ssi:43 en/user_customization-contents.ssi:66
 #: en/user_customization-internationalization.ssi:10
 #: en/user_customization-internationalization.ssi:18
 #: en/user_customization-internationalization.ssi:26
 #: en/user_customization-internationalization.ssi:38
-#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:24
-#: en/user_customization-packages.ssi:36 en/user_customization-packages.ssi:45
-#: en/user_customization-packages.ssi:59 en/user_customization-packages.ssi:73
-#: en/user_customization-packages.ssi:103
-#: en/user_customization-packages.ssi:111
-#: en/user_customization-packages.ssi:131
-#: en/user_customization-packages.ssi:166
-#: en/user_customization-packages.ssi:176
-#: en/user_customization-packages.ssi:186
-#: en/user_customization-packages.ssi:196 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:106
-#: en/user_installation.ssi:120 en/user_installation.ssi:137
-#: en/user_managing_a_configuration.ssi:24
+#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:28
+#: en/user_customization-packages.ssi:40 en/user_customization-packages.ssi:49
+#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
+#: en/user_customization-packages.ssi:107
+#: en/user_customization-packages.ssi:115
+#: en/user_customization-packages.ssi:135
+#: en/user_customization-packages.ssi:170
+#: en/user_customization-packages.ssi:180
+#: en/user_customization-packages.ssi:190
+#: en/user_customization-packages.ssi:200 en/user_examples.ssi:24
+#: 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:135 en/user_managing_a_configuration.ssi:24
 #: en/user_managing_a_configuration.ssi:35
-#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:46
-#: en/user_overview.ssi:90 en/user_overview.ssi:98
+#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:36
+#: en/user_overview.ssi:80 en/user_overview.ssi:88
 msgid "code{"
 msgstr "code{"
 
@@ -100,45 +98,43 @@ msgstr "code{"
 #: 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:40 en/user_basics.ssi:52
-#: en/user_basics.ssi:68 en/user_basics.ssi:78 en/user_basics.ssi:92
-#: en/user_basics.ssi:104 en/user_basics.ssi:118 en/user_basics.ssi:126
-#: en/user_basics.ssi:134 en/user_basics.ssi:144 en/user_basics.ssi:158
-#: en/user_basics.ssi:168 en/user_basics.ssi:176 en/user_basics.ssi:184
-#: en/user_basics.ssi:198 en/user_basics.ssi:206 en/user_basics.ssi:216
-#: en/user_basics.ssi:257 en/user_basics.ssi:269 en/user_basics.ssi:285
-#: en/user_basics.ssi:293 en/user_basics.ssi:320 en/user_basics.ssi:359
+#: en/project_bugs.ssi:62 en/user_basics.ssi:36 en/user_basics.ssi:46
+#: en/user_basics.ssi:60 en/user_basics.ssi:72 en/user_basics.ssi:82
+#: en/user_basics.ssi:94 en/user_basics.ssi:106 en/user_basics.ssi:114
+#: en/user_basics.ssi:122 en/user_basics.ssi:132 en/user_basics.ssi:146
+#: en/user_basics.ssi:156 en/user_basics.ssi:164 en/user_basics.ssi:172
+#: en/user_basics.ssi:186 en/user_basics.ssi:194 en/user_basics.ssi:204
+#: en/user_basics.ssi:245 en/user_basics.ssi:257 en/user_basics.ssi:273
+#: en/user_basics.ssi:281 en/user_basics.ssi:308 en/user_basics.ssi:347
 #: en/user_customization-contents.ssi:39 en/user_customization-contents.ssi:54
 #: en/user_customization-contents.ssi:70
 #: en/user_customization-internationalization.ssi:14
 #: en/user_customization-internationalization.ssi:22
 #: en/user_customization-internationalization.ssi:30
 #: en/user_customization-internationalization.ssi:42
-#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:28
-#: en/user_customization-packages.ssi:41 en/user_customization-packages.ssi:49
-#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
-#: en/user_customization-packages.ssi:107
-#: en/user_customization-packages.ssi:115
-#: en/user_customization-packages.ssi:135
-#: en/user_customization-packages.ssi:172
-#: en/user_customization-packages.ssi:182
-#: en/user_customization-packages.ssi:192
-#: en/user_customization-packages.ssi:202 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:88 en/user_installation.ssi:110
-#: en/user_installation.ssi:125 en/user_installation.ssi:140
-#: en/user_managing_a_configuration.ssi:31
+#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:32
+#: en/user_customization-packages.ssi:45 en/user_customization-packages.ssi:53
+#: en/user_customization-packages.ssi:67 en/user_customization-packages.ssi:81
+#: en/user_customization-packages.ssi:111
+#: en/user_customization-packages.ssi:119
+#: en/user_customization-packages.ssi:139
+#: en/user_customization-packages.ssi:176
+#: en/user_customization-packages.ssi:186
+#: en/user_customization-packages.ssi:196
+#: en/user_customization-packages.ssi:206 en/user_examples.ssi:33
+#: 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:88
+#: en/user_installation.ssi:108 en/user_installation.ssi:123
+#: en/user_installation.ssi:138 en/user_managing_a_configuration.ssi:31
 #: en/user_managing_a_configuration.ssi:43
-#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:84
-#: en/user_overview.ssi:94 en/user_overview.ssi:102
+#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:74
+#: en/user_overview.ssi:84 en/user_overview.ssi:92
 msgid "}code"
 msgstr "}code"
 
 #. type: Plain text
-#: en/user_basics.ssi:230 en/user_customization-packages.ssi:153
+#: en/user_basics.ssi:218 en/user_customization-packages.ssi:157
 msgid "% FIXME"
 msgstr ""
 
@@ -174,65 +170,83 @@ msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:14
-msgid "To set a local mirror (used to 'build' the live system)"
+msgid "To set a local mirror to be used to at build time:"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:18
-msgid ""
-"$ lb config --mirror-bootstrap http://localhost/debian/ --mirror-chroot "
-"http://localhost/debian/"
+msgid "$ lb config --mirror-bootstrap http://localhost/debian/"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:22
-msgid "The generic mirror is added to the live system's /etc/apt/sources.list."
+msgid ""
+"The chroot repository, specified by --mirror-chroot, defaults to the same as "
+"--mirror-bootstrap."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:24
+msgid ""
+"Each of the --mirror-* options governs which repository is used at various "
+"stages of the build. Recall from {Stages of the build}#stages-of-the-build "
+"that the *bootstrap* stage is when the chroot is initially populated by "
+"debootstrap with a minimal system, and the *chroot* stage is when the chroot "
+"used to construct the live system's filesystem is built. Thus, the "
+"corresponding mirror switches are used for those stages, and later, when the "
+"binary image is constructed, the --mirror-binary value is used, superceding "
+"any earlier repositories."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:26
-msgid "$ lb config --mirror-binary http://ftp.debian.org/debian/"
+msgid "The generic mirror is added to the live system's /etc/apt/sources.list."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:30
+msgid "$ lb config --mirror-binary http://ftp.debian.org/debian/"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:34
 msgid ""
 "Note: It is not used for building the live system but to install new "
 "software while using the live system."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:32
+#: en/user_customization-packages.ssi:36
 msgid ""
 "It can be disabled by setting the binary mirror to the same value as the "
 "chroot mirror."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:34
+#: en/user_customization-packages.ssi:38
 msgid ""
 "Note: the same applies for mirror chroot security and mirror binary security"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:39
+#: en/user_customization-packages.ssi:43
 msgid ""
 "$ lb config --mirror-chroot-security {URL} $ lb config --mirror-binary-"
 "security {URL}"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:43
+#: en/user_customization-packages.ssi:47
 msgid "If you don't want to include apt indices, you can skip those with:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:47
+#: en/user_customization-packages.ssi:51
 msgid "$ lb config --binary-indices false"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:51
+#: en/user_customization-packages.ssi:55
 msgid ""
 "This will not influence the entries in /etc/apt/sources.list, but only if /"
 "var/lib/apt contains the indices files or not (and by that making the image "
@@ -240,12 +254,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:53
+#: en/user_customization-packages.ssi:57
 msgid "3~ Own repository"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:55
+#: en/user_customization-packages.ssi:59
 msgid ""
 "To add more repositories (e.g. backports, experimental or custom packages, "
 "etc.), create #{config/chroot_sources/your-repository.{chroot,binary}}# "
@@ -253,7 +267,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:57
+#: en/user_customization-packages.ssi:61
 msgid ""
 "e.g. #{config/chroot_sources/live.chroot}# allows you to install packages "
 "from the debian live snapshot repository at live system build time (you have "
@@ -261,31 +275,31 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:61
+#: en/user_customization-packages.ssi:65
 msgid "deb http://live.debian.net/ sid-snapshots main contrib non-free"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:65
+#: en/user_customization-packages.ssi:69
 msgid ""
 "If you add the line to #{config/chroot_sources/live.binary}# the repository "
 "will be added to your live-system's #{/etc/apt/sources.list}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:67
+#: en/user_customization-packages.ssi:71
 msgid "If such files exist, they will be picked up automatically."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:69
+#: en/user_customization-packages.ssi:73
 msgid ""
 "You can also put the gpg-key used to sign the repository into config/"
 "chroot_sources/your-repository.{binary,chroot}.gpg"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:71
+#: en/user_customization-packages.ssi:75
 msgid ""
 "Note: some preconfigured package repositories are available for easy "
 "selection through the --repository switch, e.g. for enabling live snapshots, "
@@ -293,17 +307,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:75
+#: en/user_customization-packages.ssi:79
 msgid "$ lb config --repository live.debian.net"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:79
+#: en/user_customization-packages.ssi:83
 msgid "3~ Package installation"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:81
+#: en/user_customization-packages.ssi:85
 msgid ""
 "You can elect to use either #{apt}# or #{aptitude}# when installing "
 "packages. Which utility is used is governed by the #{LB_APT}# variable in #"
@@ -311,7 +325,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:83
+#: en/user_customization-packages.ssi:87
 msgid ""
 "_* #{apt}#: Specifying a missing package causes package installation to "
 "fail, which may not be the desired behaviour. This is the default setting "
@@ -319,7 +333,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:85
+#: en/user_customization-packages.ssi:89
 msgid ""
 "_* #{aptitude}#: Specifying a missing package causes package installation to "
 "succeed, which may not be the desired behaviour. This is the default setting "
@@ -327,66 +341,66 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:87
+#: en/user_customization-packages.ssi:91
 msgid "2~ Installing additional packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:89
+#: en/user_customization-packages.ssi:93
 msgid ""
 "live-helper has a number of mechanisms for indicating that additional "
 "packages should be installed, including:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:91
+#: en/user_customization-packages.ssi:95
 msgid "_* The #{LB_PACKAGES}# variable"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:93
+#: en/user_customization-packages.ssi:97
 msgid "_* Package lists"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:95
+#: en/user_customization-packages.ssi:99
 msgid "_* Local packages (#{chroot_local-packages/}#)"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:97
+#: en/user_customization-packages.ssi:101
 msgid "_* Tasks"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:99
+#: en/user_customization-packages.ssi:103
 msgid "3~ The #{LB_PACKAGES}# variable"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:101
+#: en/user_customization-packages.ssi:105
 msgid ""
 "To install additional packages, simply add them to the #{LB_PACKAGES}# "
 "variable in #{config/chroot}#. For example:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:105
+#: en/user_customization-packages.ssi:109
 msgid "LB_PACKAGES=\"package1 package2 package3 ... \""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:109
+#: en/user_customization-packages.ssi:113
 msgid "You can also specify initial values on the command line:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:113
+#: en/user_customization-packages.ssi:117
 msgid "$ lb config --packages \"package1 package2 package3\""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:117
+#: en/user_customization-packages.ssi:121
 msgid ""
 "The behaviour of live-build when specifying a package that does not exist is "
 "determined by your choice of APT utility. See package-installation for more "
@@ -394,12 +408,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:119
+#: en/user_customization-packages.ssi:123
 msgid "% FIXME: <xref linkend=\"package-installation\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:121
+#: en/user_customization-packages.ssi:125
 msgid ""
 "If you need to specify a large number of packages to be installed or you "
 "need flexibility regarding which packages to install, you should probably be "
@@ -407,17 +421,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:123
+#: en/user_customization-packages.ssi:127
 msgid "% FIXME: <xref linkend=\"package-lists\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:125
+#: en/user_customization-packages.ssi:129
 msgid "3~ Package lists"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:127
+#: en/user_customization-packages.ssi:131
 msgid ""
 "Package lists are a powerful way of expressing which packages should be "
 "installed. live-build ships with a number of predefined package lists which "
@@ -426,37 +440,37 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:129
+#: en/user_customization-packages.ssi:133
 msgid "To specify one or more package list, you can use:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:133
+#: en/user_customization-packages.ssi:137
 msgid "$ lb config --packages-lists \"list1 list2 list3\""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:137
+#: en/user_customization-packages.ssi:141
 msgid ""
 "Note: Package lists that are distributed with live-build reside in the #{/"
 "usr/share/live/build/lists}# directory."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:139
+#: en/user_customization-packages.ssi:143
 #, no-wrap
 msgid "*{Local packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:141
+#: en/user_customization-packages.ssi:145
 msgid ""
 "You may supplement the supplied lists using local package lists stored in #"
 "{config/chroot_local-packageslists}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:143
+#: en/user_customization-packages.ssi:147
 msgid ""
 "Package lists that exist in this directory need to have a #{.list}# suffix "
 "in order to be processed. Local packages lists always override package lists "
@@ -465,13 +479,13 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:145
+#: en/user_customization-packages.ssi:149
 #, no-wrap
 msgid "*{Local binary packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:147
+#: en/user_customization-packages.ssi:151
 msgid ""
 "In case you want to include some required .deb packages to live media's "
 "pool/ (without installing them onto the live image) you may need to use "
@@ -481,25 +495,25 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:149
+#: en/user_customization-packages.ssi:153
 msgid ""
 "Package lists that exist in this directory need to have a .list suffix in "
 "order to be processed."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:151
+#: en/user_customization-packages.ssi:155
 #, no-wrap
 msgid "*{Extending a provided package list using includes}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:160
+#: en/user_customization-packages.ssi:164
 msgid "% code{ % % #include <gnome> % iceweasel % % }code"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:162
+#: en/user_customization-packages.ssi:166
 msgid ""
 "The package lists that are included with live-build make extensive use of "
 "includes. They are available to view in the #{/usr/share/live/build/lists}# "
@@ -507,75 +521,75 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:164
+#: en/user_customization-packages.ssi:168
 #, no-wrap
 msgid "*{Using conditionals inside packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:170
+#: en/user_customization-packages.ssi:174
 msgid "#if ARCHITECTURE amd64 ia32-libs #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:174
+#: en/user_customization-packages.ssi:178
 msgid "or if #{LB_ARCHITECTURE}# is set to #{i386}# or #{amd64}#:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:180
+#: en/user_customization-packages.ssi:184
 msgid "#if ARCHITECTURE i386 amd64 memtest86+ #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:184
+#: en/user_customization-packages.ssi:188
 msgid "or if #{LB_ARCHIVE_AREAS}# contains either #{contrib}# or #{non-free}#:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:190
+#: en/user_customization-packages.ssi:194
 msgid "#if ARCHIVE_AREAS contrib non-free vrms #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:194
+#: en/user_customization-packages.ssi:198
 msgid "A conditional may surround an #{#include}# directive:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:200
+#: en/user_customization-packages.ssi:204
 msgid "#if ARCHITECTURE amd64 #include <gnome-full> #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:204
+#: en/user_customization-packages.ssi:208
 msgid ""
 "Any live-build configuration variable that begins with #{LB_}# can be tested "
 "in this way."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:206
+#: en/user_customization-packages.ssi:210
 msgid "The nesting of conditionals is not supported."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:208
+#: en/user_customization-packages.ssi:212
 msgid "3~ Tasks"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:210
+#: en/user_customization-packages.ssi:214
 msgid "%FIXME"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:212
+#: en/user_customization-packages.ssi:216
 msgid "2~ Installing modified or third-party packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:214
+#: en/user_customization-packages.ssi:218
 msgid ""
 "Whilst it is against the philosophy of Debian Live, it may sometimes be "
 "necessary to build a Live system with modified versions of packages that are "
@@ -586,7 +600,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:216
+#: en/user_customization-packages.ssi:220
 msgid ""
 "This section does not cover advice regarding building or maintaining "
 "modified packages. Joachim Breitner's 'How to fork privately' method from "
@@ -597,22 +611,22 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:218
+#: en/user_customization-packages.ssi:222
 msgid "There are two ways of installing modified custom packages:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:220
+#: en/user_customization-packages.ssi:224
 msgid "_* #{chroot_local-packages}#"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:222
+#: en/user_customization-packages.ssi:226
 msgid "_* Using a custom APT repository"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:224
+#: en/user_customization-packages.ssi:228
 msgid ""
 "The #{chroot_local-packages}# is simpler to achieve and useful for \"one-off"
 "\" customizations but has a number of drawbacks, whilst using a custom APT "
@@ -620,12 +634,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:226
+#: en/user_customization-packages.ssi:230
 msgid "3~ Using #{chroot_local-packages}# to install custom packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:228
+#: en/user_customization-packages.ssi:232
 msgid ""
 "To install a custom package, simply copy it to the #{config/chroot_local-"
 "packages}# directory. Packages that are inside this directory will be "
@@ -634,45 +648,45 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:230
+#: en/user_customization-packages.ssi:234
 msgid ""
 "Packages *{must}* be named in the prescribed way. One simple way to do this "
 "is to use #{dpkg-name}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:232
+#: en/user_customization-packages.ssi:236
 msgid ""
 "Using #{chroot_local-packages}# for installation of custom packages has "
 "disadvantages:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:234
+#: en/user_customization-packages.ssi:238
 msgid "_* It is not possible to use secure APT"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:236
+#: en/user_customization-packages.ssi:240
 msgid ""
 "_* You must install all appropriate packages in the #{config/chroot_local-"
 "packages}# directory"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:238
+#: en/user_customization-packages.ssi:242
 msgid ""
 "_* It does not lend itself to storing Debian Live configurations in revision "
 "control"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:240
+#: en/user_customization-packages.ssi:244
 msgid "3~ Using an APT repository to install custom packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:242
+#: en/user_customization-packages.ssi:246
 msgid ""
 "Unlike using #{chroot_local-packages}#, when using a custom APT repository "
 "you must ensure that you specify the packages elsewhere. See lb-packages for "
@@ -680,12 +694,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:244
+#: en/user_customization-packages.ssi:248
 msgid "% FIXME: <xref linkend=\"lb-packages\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:246
+#: en/user_customization-packages.ssi:250
 msgid ""
 "Whilst it may seem unnecessary effort to create an APT repository to install "
 "custom packages, the infrastructure can be easily re-used at a later date to "
@@ -693,12 +707,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:248
+#: en/user_customization-packages.ssi:252
 msgid "3~ Custom packages and APT"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:250
+#: en/user_customization-packages.ssi:254
 msgid ""
 "live-build uses APT to install all packages into the live system so will "
 "therefore inherit behaviours from this program. One relevant example is that "
@@ -708,7 +722,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:252
+#: en/user_customization-packages.ssi:256
 msgid ""
 "Because of this, you may wish to increment the version number in your custom "
 "packages' #{debian/changelog}# files to ensure that your modified version is "
@@ -718,17 +732,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:254
+#: en/user_customization-packages.ssi:258
 msgid "% FIXME: <xref linkend=\"apt-preferences\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:256
+#: en/user_customization-packages.ssi:260
 msgid "3~ Altering APT preferences during Live system"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:257
+#: en/user_customization-packages.ssi:261
 msgid ""
 "Whilst it may seem unnecessary effort to create an APT repository to install "
 "custom packages, the infrastructure can be easily re-used at a later date to "
diff --git a/manual/pot/live-manual.ssm.pot b/manual/pot/live-manual.ssm.pot
index b50d2a4..df2cb92 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-11-04 16:34-0400\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\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"
@@ -45,7 +45,7 @@ msgstr ""
 #, no-wrap
 msgid ""
 "@date:\n"
-" :published: 2010-11-04\n"
+" :published: 2010-11-07\n"
 msgstr ""
 
 #. type: Plain text
diff --git a/manual/pot/user_customization-overview.ssi.pot b/manual/pot/user_customization-overview.ssi.pot
index d894eda..9665c68 100644
--- a/manual/pot/user_customization-overview.ssi.pot
+++ b/manual/pot/user_customization-overview.ssi.pot
@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-29 17:14-0200\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\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"
@@ -35,40 +35,86 @@ msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:8
-msgid ""
-"It is important to understand the different layers of a Live system to know "
-"where configurations must occur, and particular, to know when they are "
-"applied. Of course, all configurations are in some way processed by live-"
-"build at build time, but some parts of setting up the Live system don't "
-"actually occur until boot time, either early in the boot by live-boot, or "
-"later by live-config. Thus, it is necessary to have a way to specify boot-"
-"time customizations. In particular, while most #{lb config}# options control "
-"aspects of the build, #{--bootappend-live}# will pass additional options "
-"through the kernel command line to set things up at boot time, such as "
-"persistence, keyboard layouts, or timezone."
+msgid "2~ Build time vs. boot time configuration"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:10
 msgid ""
-"Therefore, in addition to the man pages included in live-build, you should "
-"keep near at hand the man pages for live-boot and live-config. Although the "
-"live-boot and live-config packages are installed within the live system you "
-"are building, it is recommended that you also install them on your build "
-"system for easy reference when you are working on your configuration. It is "
-"safe to do so, as none of the scripts contained within them are executed "
-"unless the system is configured as a live system."
+"Live system configuration options are divided into those that are applied at "
+"build time and those that are applied at boot time. Boot-time options are "
+"further divided into those occurring early in the boot, applied by the live-"
+"boot package, and those that happen later in the boot, applied by live-"
+"config. Any boot-time option may be modified by the user by specifying it at "
+"the boot prompt. The image may also be built with default boot parameters so "
+"users can normally just boot directly to the live system without specifying "
+"any options when all of the defaults are suitable. In particular, the "
+"argument to #{lb --bootappend-live}# consists of any default kernel command "
+"line options for the Live system, such as persistence, keyboard layouts, or "
+"timezone. See {Customizing locale and language}#customizing-locale-and-"
+"language, for example."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-overview.ssi:12
 msgid ""
-"You should also be aware of the kinds of material that go into a Debian live "
-"configuration. Although #{lb config}# does create a skeletal configuration "
-"in the config/ directory, to accomplish your goals, you may need to provide "
-"additional files in subdirectories of config/. Depending on where the files "
-"are stored in the configuration, they may be copied into the live system's "
-"filesystem or into the binary image filesystem, or may provide build-time "
+"Build-time configuration options are described in the #{lb config}# man "
+"page. Boot-time options are described in the man pages for live-boot and "
+"live-config. Although the live-boot and live-config packages are installed "
+"within the live system you are building, it is recommended that you also "
+"install them on your build system for easy reference when you are working on "
+"your configuration. It is safe to do so, as none of the scripts contained "
+"within them are executed unless the system is configured as a live system."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:14
+msgid "2~stages-of-the-build Stages of the build"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:16
+msgid ""
+"The build process is divided into stages, with various customizations "
+"applied in sequence in each. The first stage to run is the *{bootstrap}* "
+"stage. This is the initial phase of populating the chroot directory with "
+"packages to make a barebones Debian system. This is followed by the *{chroot}"
+"* stage, which completes the construction of chroot directory, populating it "
+"with all of the packages listed in the configuration, along with any other "
+"materials. Most customization of content occurs in this stage. The final "
+"stage of preparing the live image is the *{binary}* stage, which builds a "
+"bootable image, using the contents of the chroot directory to construct the "
+"root filesystem for the Live system, and including the installer and any "
+"other additional material on the target media outside of the Live system's "
+"filesystem. After the live image is built, if enabled, the source tarball is "
+"built in the *{source}* stage."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:18
+msgid ""
+"Within each of these stages, there is a particular sequence in which "
+"commands are applied. These are arranged in such a way as to ensure "
+"customizations can be layered in a reasonable fashion. For example, within "
+"the *{chroot}* stage, preseeds are applied before any packages are "
+"installed, packages are installed before any locally included files or "
+"patches are applied, and hooks are run later, after all of the materials are "
+"in place."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:20
+msgid "2~ Supplement #{lb config}# with files"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:22
+msgid ""
+"Although #{lb config}# does create a skeletal configuration in the config/ "
+"directory, to accomplish your goals, you may need to provide additional "
+"files in subdirectories of config/. Depending on where the files are stored "
+"in the configuration, they may be copied into the live system's filesystem "
+"or into the binary image filesystem, or may provide build-time "
 "configurations of the system that would be cumbersome to pass as command-"
 "line options. You may include things such as custom lists of packages, "
 "custom artwork, or hook scripts to run either at build time or at boot time, "
@@ -77,7 +123,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-overview.ssi:14
+#: en/user_customization-overview.ssi:24
+msgid "2~ Customization tasks"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-overview.ssi:26
 msgid ""
 "The following chapters are organized by the kinds of customization task "
 "users typically perform: {Customizing package installation}#customizing-"
diff --git a/manual/pot/user_customization-packages.ssi.pot b/manual/pot/user_customization-packages.ssi.pot
index 57cdfdb..fc29e0a 100644
--- a/manual/pot/user_customization-packages.ssi.pot
+++ b/manual/pot/user_customization-packages.ssi.pot
@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-22 08:58-0200\n"
+"POT-Creation-Date: 2010-11-07 15:32-0400\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"
@@ -39,40 +39,38 @@ msgstr ""
 #: 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:36
-#: en/user_basics.ssi:48 en/user_basics.ssi:62 en/user_basics.ssi:74
-#: en/user_basics.ssi:86 en/user_basics.ssi:98 en/user_basics.ssi:114
-#: en/user_basics.ssi:122 en/user_basics.ssi:130 en/user_basics.ssi:140
-#: en/user_basics.ssi:152 en/user_basics.ssi:164 en/user_basics.ssi:172
-#: en/user_basics.ssi:180 en/user_basics.ssi:194 en/user_basics.ssi:202
-#: en/user_basics.ssi:212 en/user_basics.ssi:232 en/user_basics.ssi:265
-#: en/user_basics.ssi:281 en/user_basics.ssi:289 en/user_basics.ssi:309
-#: en/user_basics.ssi:334 en/user_customization-contents.ssi:34
+#: en/other_procedures.ssi:58 en/project_bugs.ssi:58 en/user_basics.ssi:32
+#: en/user_basics.ssi:42 en/user_basics.ssi:54 en/user_basics.ssi:66
+#: en/user_basics.ssi:78 en/user_basics.ssi:88 en/user_basics.ssi:102
+#: en/user_basics.ssi:110 en/user_basics.ssi:118 en/user_basics.ssi:128
+#: en/user_basics.ssi:140 en/user_basics.ssi:152 en/user_basics.ssi:160
+#: en/user_basics.ssi:168 en/user_basics.ssi:182 en/user_basics.ssi:190
+#: en/user_basics.ssi:200 en/user_basics.ssi:220 en/user_basics.ssi:253
+#: en/user_basics.ssi:269 en/user_basics.ssi:277 en/user_basics.ssi:297
+#: en/user_basics.ssi:322 en/user_customization-contents.ssi:34
 #: en/user_customization-contents.ssi:43 en/user_customization-contents.ssi:66
 #: en/user_customization-internationalization.ssi:10
 #: en/user_customization-internationalization.ssi:18
 #: en/user_customization-internationalization.ssi:26
 #: en/user_customization-internationalization.ssi:38
-#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:24
-#: en/user_customization-packages.ssi:36 en/user_customization-packages.ssi:45
-#: en/user_customization-packages.ssi:59 en/user_customization-packages.ssi:73
-#: en/user_customization-packages.ssi:103
-#: en/user_customization-packages.ssi:111
-#: en/user_customization-packages.ssi:131
-#: en/user_customization-packages.ssi:166
-#: en/user_customization-packages.ssi:176
-#: en/user_customization-packages.ssi:186
-#: en/user_customization-packages.ssi:196 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:106
-#: en/user_installation.ssi:120 en/user_installation.ssi:137
-#: en/user_managing_a_configuration.ssi:24
+#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:28
+#: en/user_customization-packages.ssi:40 en/user_customization-packages.ssi:49
+#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
+#: en/user_customization-packages.ssi:107
+#: en/user_customization-packages.ssi:115
+#: en/user_customization-packages.ssi:135
+#: en/user_customization-packages.ssi:170
+#: en/user_customization-packages.ssi:180
+#: en/user_customization-packages.ssi:190
+#: en/user_customization-packages.ssi:200 en/user_examples.ssi:24
+#: 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:135 en/user_managing_a_configuration.ssi:24
 #: en/user_managing_a_configuration.ssi:35
-#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:46
-#: en/user_overview.ssi:90 en/user_overview.ssi:98
+#: en/user_managing_a_configuration.ssi:47 en/user_overview.ssi:36
+#: en/user_overview.ssi:80 en/user_overview.ssi:88
 msgid "code{"
 msgstr ""
 
@@ -99,45 +97,43 @@ msgstr ""
 #: 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:40 en/user_basics.ssi:52
-#: en/user_basics.ssi:68 en/user_basics.ssi:78 en/user_basics.ssi:92
-#: en/user_basics.ssi:104 en/user_basics.ssi:118 en/user_basics.ssi:126
-#: en/user_basics.ssi:134 en/user_basics.ssi:144 en/user_basics.ssi:158
-#: en/user_basics.ssi:168 en/user_basics.ssi:176 en/user_basics.ssi:184
-#: en/user_basics.ssi:198 en/user_basics.ssi:206 en/user_basics.ssi:216
-#: en/user_basics.ssi:257 en/user_basics.ssi:269 en/user_basics.ssi:285
-#: en/user_basics.ssi:293 en/user_basics.ssi:320 en/user_basics.ssi:359
+#: en/project_bugs.ssi:62 en/user_basics.ssi:36 en/user_basics.ssi:46
+#: en/user_basics.ssi:60 en/user_basics.ssi:72 en/user_basics.ssi:82
+#: en/user_basics.ssi:94 en/user_basics.ssi:106 en/user_basics.ssi:114
+#: en/user_basics.ssi:122 en/user_basics.ssi:132 en/user_basics.ssi:146
+#: en/user_basics.ssi:156 en/user_basics.ssi:164 en/user_basics.ssi:172
+#: en/user_basics.ssi:186 en/user_basics.ssi:194 en/user_basics.ssi:204
+#: en/user_basics.ssi:245 en/user_basics.ssi:257 en/user_basics.ssi:273
+#: en/user_basics.ssi:281 en/user_basics.ssi:308 en/user_basics.ssi:347
 #: en/user_customization-contents.ssi:39 en/user_customization-contents.ssi:54
 #: en/user_customization-contents.ssi:70
 #: en/user_customization-internationalization.ssi:14
 #: en/user_customization-internationalization.ssi:22
 #: en/user_customization-internationalization.ssi:30
 #: en/user_customization-internationalization.ssi:42
-#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:28
-#: en/user_customization-packages.ssi:41 en/user_customization-packages.ssi:49
-#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
-#: en/user_customization-packages.ssi:107
-#: en/user_customization-packages.ssi:115
-#: en/user_customization-packages.ssi:135
-#: en/user_customization-packages.ssi:172
-#: en/user_customization-packages.ssi:182
-#: en/user_customization-packages.ssi:192
-#: en/user_customization-packages.ssi:202 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:88 en/user_installation.ssi:110
-#: en/user_installation.ssi:125 en/user_installation.ssi:140
-#: en/user_managing_a_configuration.ssi:31
+#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:32
+#: en/user_customization-packages.ssi:45 en/user_customization-packages.ssi:53
+#: en/user_customization-packages.ssi:67 en/user_customization-packages.ssi:81
+#: en/user_customization-packages.ssi:111
+#: en/user_customization-packages.ssi:119
+#: en/user_customization-packages.ssi:139
+#: en/user_customization-packages.ssi:176
+#: en/user_customization-packages.ssi:186
+#: en/user_customization-packages.ssi:196
+#: en/user_customization-packages.ssi:206 en/user_examples.ssi:33
+#: 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:88
+#: en/user_installation.ssi:108 en/user_installation.ssi:123
+#: en/user_installation.ssi:138 en/user_managing_a_configuration.ssi:31
 #: en/user_managing_a_configuration.ssi:43
-#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:84
-#: en/user_overview.ssi:94 en/user_overview.ssi:102
+#: en/user_managing_a_configuration.ssi:52 en/user_overview.ssi:74
+#: en/user_overview.ssi:84 en/user_overview.ssi:92
 msgid "}code"
 msgstr ""
 
 #. type: Plain text
-#: en/user_basics.ssi:230 en/user_customization-packages.ssi:153
+#: en/user_basics.ssi:218 en/user_customization-packages.ssi:157
 msgid "% FIXME"
 msgstr ""
 
@@ -173,65 +169,83 @@ msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:14
-msgid "To set a local mirror (used to 'build' the live system)"
+msgid "To set a local mirror to be used to at build time:"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:18
-msgid ""
-"$ lb config --mirror-bootstrap http://localhost/debian/ --mirror-chroot "
-"http://localhost/debian/"
+msgid "$ lb config --mirror-bootstrap http://localhost/debian/"
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:22
-msgid "The generic mirror is added to the live system's /etc/apt/sources.list."
+msgid ""
+"The chroot repository, specified by --mirror-chroot, defaults to the same as "
+"--mirror-bootstrap."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:24
+msgid ""
+"Each of the --mirror-* options governs which repository is used at various "
+"stages of the build. Recall from {Stages of the build}#stages-of-the-build "
+"that the *bootstrap* stage is when the chroot is initially populated by "
+"debootstrap with a minimal system, and the *chroot* stage is when the chroot "
+"used to construct the live system's filesystem is built. Thus, the "
+"corresponding mirror switches are used for those stages, and later, when the "
+"binary image is constructed, the --mirror-binary value is used, superceding "
+"any earlier repositories."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:26
-msgid "$ lb config --mirror-binary http://ftp.debian.org/debian/"
+msgid "The generic mirror is added to the live system's /etc/apt/sources.list."
 msgstr ""
 
 #. type: Plain text
 #: en/user_customization-packages.ssi:30
+msgid "$ lb config --mirror-binary http://ftp.debian.org/debian/"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:34
 msgid ""
 "Note: It is not used for building the live system but to install new "
 "software while using the live system."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:32
+#: en/user_customization-packages.ssi:36
 msgid ""
 "It can be disabled by setting the binary mirror to the same value as the "
 "chroot mirror."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:34
+#: en/user_customization-packages.ssi:38
 msgid ""
 "Note: the same applies for mirror chroot security and mirror binary security"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:39
+#: en/user_customization-packages.ssi:43
 msgid ""
 "$ lb config --mirror-chroot-security {URL} $ lb config --mirror-binary-"
 "security {URL}"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:43
+#: en/user_customization-packages.ssi:47
 msgid "If you don't want to include apt indices, you can skip those with:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:47
+#: en/user_customization-packages.ssi:51
 msgid "$ lb config --binary-indices false"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:51
+#: en/user_customization-packages.ssi:55
 msgid ""
 "This will not influence the entries in /etc/apt/sources.list, but only if /"
 "var/lib/apt contains the indices files or not (and by that making the image "
@@ -239,12 +253,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:53
+#: en/user_customization-packages.ssi:57
 msgid "3~ Own repository"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:55
+#: en/user_customization-packages.ssi:59
 msgid ""
 "To add more repositories (e.g. backports, experimental or custom packages, "
 "etc.), create #{config/chroot_sources/your-repository.{chroot,binary}}# "
@@ -252,7 +266,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:57
+#: en/user_customization-packages.ssi:61
 msgid ""
 "e.g. #{config/chroot_sources/live.chroot}# allows you to install packages "
 "from the debian live snapshot repository at live system build time (you have "
@@ -260,31 +274,31 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:61
+#: en/user_customization-packages.ssi:65
 msgid "deb http://live.debian.net/ sid-snapshots main contrib non-free"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:65
+#: en/user_customization-packages.ssi:69
 msgid ""
 "If you add the line to #{config/chroot_sources/live.binary}# the repository "
 "will be added to your live-system's #{/etc/apt/sources.list}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:67
+#: en/user_customization-packages.ssi:71
 msgid "If such files exist, they will be picked up automatically."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:69
+#: en/user_customization-packages.ssi:73
 msgid ""
 "You can also put the gpg-key used to sign the repository into config/"
 "chroot_sources/your-repository.{binary,chroot}.gpg"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:71
+#: en/user_customization-packages.ssi:75
 msgid ""
 "Note: some preconfigured package repositories are available for easy "
 "selection through the --repository switch, e.g. for enabling live snapshots, "
@@ -292,17 +306,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:75
+#: en/user_customization-packages.ssi:79
 msgid "$ lb config --repository live.debian.net"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:79
+#: en/user_customization-packages.ssi:83
 msgid "3~ Package installation"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:81
+#: en/user_customization-packages.ssi:85
 msgid ""
 "You can elect to use either #{apt}# or #{aptitude}# when installing "
 "packages. Which utility is used is governed by the #{LB_APT}# variable in #"
@@ -310,7 +324,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:83
+#: en/user_customization-packages.ssi:87
 msgid ""
 "_* #{apt}#: Specifying a missing package causes package installation to "
 "fail, which may not be the desired behaviour. This is the default setting "
@@ -318,7 +332,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:85
+#: en/user_customization-packages.ssi:89
 msgid ""
 "_* #{aptitude}#: Specifying a missing package causes package installation to "
 "succeed, which may not be the desired behaviour. This is the default setting "
@@ -326,66 +340,66 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:87
+#: en/user_customization-packages.ssi:91
 msgid "2~ Installing additional packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:89
+#: en/user_customization-packages.ssi:93
 msgid ""
 "live-helper has a number of mechanisms for indicating that additional "
 "packages should be installed, including:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:91
+#: en/user_customization-packages.ssi:95
 msgid "_* The #{LB_PACKAGES}# variable"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:93
+#: en/user_customization-packages.ssi:97
 msgid "_* Package lists"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:95
+#: en/user_customization-packages.ssi:99
 msgid "_* Local packages (#{chroot_local-packages/}#)"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:97
+#: en/user_customization-packages.ssi:101
 msgid "_* Tasks"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:99
+#: en/user_customization-packages.ssi:103
 msgid "3~ The #{LB_PACKAGES}# variable"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:101
+#: en/user_customization-packages.ssi:105
 msgid ""
 "To install additional packages, simply add them to the #{LB_PACKAGES}# "
 "variable in #{config/chroot}#. For example:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:105
+#: en/user_customization-packages.ssi:109
 msgid "LB_PACKAGES=\"package1 package2 package3 ... \""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:109
+#: en/user_customization-packages.ssi:113
 msgid "You can also specify initial values on the command line:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:113
+#: en/user_customization-packages.ssi:117
 msgid "$ lb config --packages \"package1 package2 package3\""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:117
+#: en/user_customization-packages.ssi:121
 msgid ""
 "The behaviour of live-build when specifying a package that does not exist is "
 "determined by your choice of APT utility. See package-installation for more "
@@ -393,12 +407,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:119
+#: en/user_customization-packages.ssi:123
 msgid "% FIXME: <xref linkend=\"package-installation\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:121
+#: en/user_customization-packages.ssi:125
 msgid ""
 "If you need to specify a large number of packages to be installed or you "
 "need flexibility regarding which packages to install, you should probably be "
@@ -406,17 +420,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:123
+#: en/user_customization-packages.ssi:127
 msgid "% FIXME: <xref linkend=\"package-lists\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:125
+#: en/user_customization-packages.ssi:129
 msgid "3~ Package lists"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:127
+#: en/user_customization-packages.ssi:131
 msgid ""
 "Package lists are a powerful way of expressing which packages should be "
 "installed. live-build ships with a number of predefined package lists which "
@@ -425,37 +439,37 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:129
+#: en/user_customization-packages.ssi:133
 msgid "To specify one or more package list, you can use:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:133
+#: en/user_customization-packages.ssi:137
 msgid "$ lb config --packages-lists \"list1 list2 list3\""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:137
+#: en/user_customization-packages.ssi:141
 msgid ""
 "Note: Package lists that are distributed with live-build reside in the #{/"
 "usr/share/live/build/lists}# directory."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:139
+#: en/user_customization-packages.ssi:143
 #, no-wrap
 msgid "*{Local packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:141
+#: en/user_customization-packages.ssi:145
 msgid ""
 "You may supplement the supplied lists using local package lists stored in #"
 "{config/chroot_local-packageslists}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:143
+#: en/user_customization-packages.ssi:147
 msgid ""
 "Package lists that exist in this directory need to have a #{.list}# suffix "
 "in order to be processed. Local packages lists always override package lists "
@@ -464,13 +478,13 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:145
+#: en/user_customization-packages.ssi:149
 #, no-wrap
 msgid "*{Local binary packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:147
+#: en/user_customization-packages.ssi:151
 msgid ""
 "In case you want to include some required .deb packages to live media's "
 "pool/ (without installing them onto the live image) you may need to use "
@@ -480,25 +494,25 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:149
+#: en/user_customization-packages.ssi:153
 msgid ""
 "Package lists that exist in this directory need to have a .list suffix in "
 "order to be processed."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:151
+#: en/user_customization-packages.ssi:155
 #, no-wrap
 msgid "*{Extending a provided package list using includes}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:160
+#: en/user_customization-packages.ssi:164
 msgid "% code{ % % #include <gnome> % iceweasel % % }code"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:162
+#: en/user_customization-packages.ssi:166
 msgid ""
 "The package lists that are included with live-build make extensive use of "
 "includes. They are available to view in the #{/usr/share/live/build/lists}# "
@@ -506,75 +520,75 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:164
+#: en/user_customization-packages.ssi:168
 #, no-wrap
 msgid "*{Using conditionals inside packages lists}*\n"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:170
+#: en/user_customization-packages.ssi:174
 msgid "#if ARCHITECTURE amd64 ia32-libs #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:174
+#: en/user_customization-packages.ssi:178
 msgid "or if #{LB_ARCHITECTURE}# is set to #{i386}# or #{amd64}#:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:180
+#: en/user_customization-packages.ssi:184
 msgid "#if ARCHITECTURE i386 amd64 memtest86+ #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:184
+#: en/user_customization-packages.ssi:188
 msgid "or if #{LB_ARCHIVE_AREAS}# contains either #{contrib}# or #{non-free}#:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:190
+#: en/user_customization-packages.ssi:194
 msgid "#if ARCHIVE_AREAS contrib non-free vrms #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:194
+#: en/user_customization-packages.ssi:198
 msgid "A conditional may surround an #{#include}# directive:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:200
+#: en/user_customization-packages.ssi:204
 msgid "#if ARCHITECTURE amd64 #include <gnome-full> #endif"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:204
+#: en/user_customization-packages.ssi:208
 msgid ""
 "Any live-build configuration variable that begins with #{LB_}# can be tested "
 "in this way."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:206
+#: en/user_customization-packages.ssi:210
 msgid "The nesting of conditionals is not supported."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:208
+#: en/user_customization-packages.ssi:212
 msgid "3~ Tasks"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:210
+#: en/user_customization-packages.ssi:214
 msgid "%FIXME"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:212
+#: en/user_customization-packages.ssi:216
 msgid "2~ Installing modified or third-party packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:214
+#: en/user_customization-packages.ssi:218
 msgid ""
 "Whilst it is against the philosophy of Debian Live, it may sometimes be "
 "necessary to build a Live system with modified versions of packages that are "
@@ -585,7 +599,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:216
+#: en/user_customization-packages.ssi:220
 msgid ""
 "This section does not cover advice regarding building or maintaining "
 "modified packages. Joachim Breitner's 'How to fork privately' method from "
@@ -596,22 +610,22 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:218
+#: en/user_customization-packages.ssi:222
 msgid "There are two ways of installing modified custom packages:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:220
+#: en/user_customization-packages.ssi:224
 msgid "_* #{chroot_local-packages}#"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:222
+#: en/user_customization-packages.ssi:226
 msgid "_* Using a custom APT repository"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:224
+#: en/user_customization-packages.ssi:228
 msgid ""
 "The #{chroot_local-packages}# is simpler to achieve and useful for \"one-off"
 "\" customizations but has a number of drawbacks, whilst using a custom APT "
@@ -619,12 +633,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:226
+#: en/user_customization-packages.ssi:230
 msgid "3~ Using #{chroot_local-packages}# to install custom packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:228
+#: en/user_customization-packages.ssi:232
 msgid ""
 "To install a custom package, simply copy it to the #{config/chroot_local-"
 "packages}# directory. Packages that are inside this directory will be "
@@ -633,45 +647,45 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:230
+#: en/user_customization-packages.ssi:234
 msgid ""
 "Packages *{must}* be named in the prescribed way. One simple way to do this "
 "is to use #{dpkg-name}#."
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:232
+#: en/user_customization-packages.ssi:236
 msgid ""
 "Using #{chroot_local-packages}# for installation of custom packages has "
 "disadvantages:"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:234
+#: en/user_customization-packages.ssi:238
 msgid "_* It is not possible to use secure APT"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:236
+#: en/user_customization-packages.ssi:240
 msgid ""
 "_* You must install all appropriate packages in the #{config/chroot_local-"
 "packages}# directory"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:238
+#: en/user_customization-packages.ssi:242
 msgid ""
 "_* It does not lend itself to storing Debian Live configurations in revision "
 "control"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:240
+#: en/user_customization-packages.ssi:244
 msgid "3~ Using an APT repository to install custom packages"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:242
+#: en/user_customization-packages.ssi:246
 msgid ""
 "Unlike using #{chroot_local-packages}#, when using a custom APT repository "
 "you must ensure that you specify the packages elsewhere. See lb-packages for "
@@ -679,12 +693,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:244
+#: en/user_customization-packages.ssi:248
 msgid "% FIXME: <xref linkend=\"lb-packages\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:246
+#: en/user_customization-packages.ssi:250
 msgid ""
 "Whilst it may seem unnecessary effort to create an APT repository to install "
 "custom packages, the infrastructure can be easily re-used at a later date to "
@@ -692,12 +706,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:248
+#: en/user_customization-packages.ssi:252
 msgid "3~ Custom packages and APT"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:250
+#: en/user_customization-packages.ssi:254
 msgid ""
 "live-build uses APT to install all packages into the live system so will "
 "therefore inherit behaviours from this program. One relevant example is that "
@@ -707,7 +721,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:252
+#: en/user_customization-packages.ssi:256
 msgid ""
 "Because of this, you may wish to increment the version number in your custom "
 "packages' #{debian/changelog}# files to ensure that your modified version is "
@@ -717,17 +731,17 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:254
+#: en/user_customization-packages.ssi:258
 msgid "% FIXME: <xref linkend=\"apt-preferences\"/>"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:256
+#: en/user_customization-packages.ssi:260
 msgid "3~ Altering APT preferences during Live system"
 msgstr ""
 
 #. type: Plain text
-#: en/user_customization-packages.ssi:257
+#: en/user_customization-packages.ssi:261
 msgid ""
 "Whilst it may seem unnecessary effort to create an APT repository to install "
 "custom packages, the infrastructure can be easily re-used at a later date to "
diff --git a/manual/pt_BR/live-manual.ssm b/manual/pt_BR/live-manual.ssm
index d2a738c..aaa863d 100644
--- a/manual/pt_BR/live-manual.ssm
+++ b/manual/pt_BR/live-manual.ssm
@@ -9,7 +9,7 @@
  :license: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.<br><br>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.<br><br>You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/. <br><br>On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3 file.
 
 @date:
- :published: 2010-11-04
+ :published: 2010-11-07
 
 @publisher: Debian Live Project <debian-live at lists.debian.org>
 
diff --git a/manual/pt_BR/user_customization-overview.ssi b/manual/pt_BR/user_customization-overview.ssi
index 0871fe5..1900889 100644
--- a/manual/pt_BR/user_customization-overview.ssi
+++ b/manual/pt_BR/user_customization-overview.ssi
@@ -5,37 +5,68 @@ B~ Customizing contents
 This chapter gives an overview of the various ways in which you may
 customize a Debian Live system.
 
-It is important to understand the different layers of a Live system to know
-where configurations must occur, and particular, to know when they are
-applied. Of course, all configurations are in some way processed by
-live-build at build time, but some parts of setting up the Live system don't
-actually occur until boot time, either early in the boot by live-boot, or
-later by live-config. Thus, it is necessary to have a way to specify
-boot-time customizations. In particular, while most #{lb config}# options
-control aspects of the build, #{--bootappend-live}# will pass additional
-options through the kernel command line to set things up at boot time, such
-as persistence, keyboard layouts, or timezone.
-
-Therefore, in addition to the man pages included in live-build, you should
-keep near at hand the man pages for live-boot and live-config. Although the
-live-boot and live-config packages are installed within the live system you
-are building, it is recommended that you also install them on your build
-system for easy reference when you are working on your configuration. It is
-safe to do so, as none of the scripts contained within them are executed
-unless the system is configured as a live system.
-
-You should also be aware of the kinds of material that go into a Debian live
-configuration. Although #{lb config}# does create a skeletal configuration
-in the config/ directory, to accomplish your goals, you may need to provide
-additional files in subdirectories of config/. Depending on where the files
-are stored in the configuration, they may be copied into the live system's
-filesystem or into the binary image filesystem, or may provide build-time
+2~ Build time vs. boot time configuration
+
+Live system configuration options are divided into those that are applied at
+build time and those that are applied at boot time. Boot-time options are
+further divided into those occurring early in the boot, applied by the
+live-boot package, and those that happen later in the boot, applied by
+live-config. Any boot-time option may be modified by the user by specifying
+it at the boot prompt. The image may also be built with default boot
+parameters so users can normally just boot directly to the live system
+without specifying any options when all of the defaults are suitable. In
+particular, the argument to #{lb --bootappend-live}# consists of any default
+kernel command line options for the Live system, such as persistence,
+keyboard layouts, or timezone. See {Customizing locale and
+language}#customizing-locale-and-language, for example.
+
+Build-time configuration options are described in the #{lb config}# man
+page. Boot-time options are described in the man pages for live-boot and
+live-config. Although the live-boot and live-config packages are installed
+within the live system you are building, it is recommended that you also
+install them on your build system for easy reference when you are working on
+your configuration. It is safe to do so, as none of the scripts contained
+within them are executed unless the system is configured as a live system.
+
+2~stages-of-the-build Stages of the build
+
+The build process is divided into stages, with various customizations
+applied in sequence in each. The first stage to run is the *{bootstrap}*
+stage. This is the initial phase of populating the chroot directory with
+packages to make a barebones Debian system. This is followed by the
+*{chroot}* stage, which completes the construction of chroot directory,
+populating it with all of the packages listed in the configuration, along
+with any other materials. Most customization of content occurs in this
+stage. The final stage of preparing the live image is the *{binary}* stage,
+which builds a bootable image, using the contents of the chroot directory to
+construct the root filesystem for the Live system, and including the
+installer and any other additional material on the target media outside of
+the Live system's filesystem. After the live image is built, if enabled, the
+source tarball is built in the *{source}* stage.
+
+Within each of these stages, there is a particular sequence in which
+commands are applied. These are arranged in such a way as to ensure
+customizations can be layered in a reasonable fashion. For example, within
+the *{chroot}* stage, preseeds are applied before any packages are
+installed, packages are installed before any locally included files or
+patches are applied, and hooks are run later, after all of the materials are
+in place.
+
+2~ Supplement #{lb config}# with files
+
+Although #{lb config}# does create a skeletal configuration in the config/
+directory, to accomplish your goals, you may need to provide additional
+files in subdirectories of config/. Depending on where the files are stored
+in the configuration, they may be copied into the live system's filesystem
+or into the binary image filesystem, or may provide build-time
 configurations of the system that would be cumbersome to pass as
 command-line options. You may include things such as custom lists of
 packages, custom artwork, or hook scripts to run either at build time or at
 boot time, boosting the already considerable flexibility of debian-live with
 code of your own.
 
+2~ Customization tasks
+
 The following chapters are organized by the kinds of customization task
 users typically perform: {Customizing package
 installation}#customizing-package-installation, {Customizing
diff --git a/manual/pt_BR/user_customization-packages.ssi b/manual/pt_BR/user_customization-packages.ssi
index 29fb5eb..530d9eb 100644
--- a/manual/pt_BR/user_customization-packages.ssi
+++ b/manual/pt_BR/user_customization-packages.ssi
@@ -10,15 +10,26 @@ _* Installing modified packages
 
 3~ Debian repositories
 
-To set a local mirror (used to 'build' the live system)
+To set a local mirror to be used to at build time:
 
 code{
 
-$ lb config --mirror-bootstrap http://localhost/debian/ --mirror-chroot
-http://localhost/debian/
+$ lb config --mirror-bootstrap http://localhost/debian/
 
 }code
 
+The chroot repository, specified by --mirror-chroot, defaults to the same as
+--mirror-bootstrap.
+
+Each of the --mirror-* options governs which repository is used at various
+stages of the build. Recall from {Stages of the build}#stages-of-the-build
+that the *bootstrap* stage is when the chroot is initially populated by
+debootstrap with a minimal system, and the *chroot* stage is when the chroot
+used to construct the live system's filesystem is built. Thus, the
+corresponding mirror switches are used for those stages, and later, when the
+binary image is constructed, the --mirror-binary value is used, superceding
+any earlier repositories.
+
 The generic mirror is added to the live system's /etc/apt/sources.list.
 
 code{
diff --git a/manual/ro/live-manual.ssm b/manual/ro/live-manual.ssm
index d2a738c..aaa863d 100644
--- a/manual/ro/live-manual.ssm
+++ b/manual/ro/live-manual.ssm
@@ -9,7 +9,7 @@
  :license: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.<br><br>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.<br><br>You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/. <br><br>On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3 file.
 
 @date:
- :published: 2010-11-04
+ :published: 2010-11-07
 
 @publisher: Debian Live Project <debian-live at lists.debian.org>
 
diff --git a/manual/ro/user_customization-overview.ssi b/manual/ro/user_customization-overview.ssi
index 0871fe5..1900889 100644
--- a/manual/ro/user_customization-overview.ssi
+++ b/manual/ro/user_customization-overview.ssi
@@ -5,37 +5,68 @@ B~ Customizing contents
 This chapter gives an overview of the various ways in which you may
 customize a Debian Live system.
 
-It is important to understand the different layers of a Live system to know
-where configurations must occur, and particular, to know when they are
-applied. Of course, all configurations are in some way processed by
-live-build at build time, but some parts of setting up the Live system don't
-actually occur until boot time, either early in the boot by live-boot, or
-later by live-config. Thus, it is necessary to have a way to specify
-boot-time customizations. In particular, while most #{lb config}# options
-control aspects of the build, #{--bootappend-live}# will pass additional
-options through the kernel command line to set things up at boot time, such
-as persistence, keyboard layouts, or timezone.
-
-Therefore, in addition to the man pages included in live-build, you should
-keep near at hand the man pages for live-boot and live-config. Although the
-live-boot and live-config packages are installed within the live system you
-are building, it is recommended that you also install them on your build
-system for easy reference when you are working on your configuration. It is
-safe to do so, as none of the scripts contained within them are executed
-unless the system is configured as a live system.
-
-You should also be aware of the kinds of material that go into a Debian live
-configuration. Although #{lb config}# does create a skeletal configuration
-in the config/ directory, to accomplish your goals, you may need to provide
-additional files in subdirectories of config/. Depending on where the files
-are stored in the configuration, they may be copied into the live system's
-filesystem or into the binary image filesystem, or may provide build-time
+2~ Build time vs. boot time configuration
+
+Live system configuration options are divided into those that are applied at
+build time and those that are applied at boot time. Boot-time options are
+further divided into those occurring early in the boot, applied by the
+live-boot package, and those that happen later in the boot, applied by
+live-config. Any boot-time option may be modified by the user by specifying
+it at the boot prompt. The image may also be built with default boot
+parameters so users can normally just boot directly to the live system
+without specifying any options when all of the defaults are suitable. In
+particular, the argument to #{lb --bootappend-live}# consists of any default
+kernel command line options for the Live system, such as persistence,
+keyboard layouts, or timezone. See {Customizing locale and
+language}#customizing-locale-and-language, for example.
+
+Build-time configuration options are described in the #{lb config}# man
+page. Boot-time options are described in the man pages for live-boot and
+live-config. Although the live-boot and live-config packages are installed
+within the live system you are building, it is recommended that you also
+install them on your build system for easy reference when you are working on
+your configuration. It is safe to do so, as none of the scripts contained
+within them are executed unless the system is configured as a live system.
+
+2~stages-of-the-build Stages of the build
+
+The build process is divided into stages, with various customizations
+applied in sequence in each. The first stage to run is the *{bootstrap}*
+stage. This is the initial phase of populating the chroot directory with
+packages to make a barebones Debian system. This is followed by the
+*{chroot}* stage, which completes the construction of chroot directory,
+populating it with all of the packages listed in the configuration, along
+with any other materials. Most customization of content occurs in this
+stage. The final stage of preparing the live image is the *{binary}* stage,
+which builds a bootable image, using the contents of the chroot directory to
+construct the root filesystem for the Live system, and including the
+installer and any other additional material on the target media outside of
+the Live system's filesystem. After the live image is built, if enabled, the
+source tarball is built in the *{source}* stage.
+
+Within each of these stages, there is a particular sequence in which
+commands are applied. These are arranged in such a way as to ensure
+customizations can be layered in a reasonable fashion. For example, within
+the *{chroot}* stage, preseeds are applied before any packages are
+installed, packages are installed before any locally included files or
+patches are applied, and hooks are run later, after all of the materials are
+in place.
+
+2~ Supplement #{lb config}# with files
+
+Although #{lb config}# does create a skeletal configuration in the config/
+directory, to accomplish your goals, you may need to provide additional
+files in subdirectories of config/. Depending on where the files are stored
+in the configuration, they may be copied into the live system's filesystem
+or into the binary image filesystem, or may provide build-time
 configurations of the system that would be cumbersome to pass as
 command-line options. You may include things such as custom lists of
 packages, custom artwork, or hook scripts to run either at build time or at
 boot time, boosting the already considerable flexibility of debian-live with
 code of your own.
 
+2~ Customization tasks
+
 The following chapters are organized by the kinds of customization task
 users typically perform: {Customizing package
 installation}#customizing-package-installation, {Customizing
diff --git a/manual/ro/user_customization-packages.ssi b/manual/ro/user_customization-packages.ssi
index 29fb5eb..530d9eb 100644
--- a/manual/ro/user_customization-packages.ssi
+++ b/manual/ro/user_customization-packages.ssi
@@ -10,15 +10,26 @@ _* Installing modified packages
 
 3~ Debian repositories
 
-To set a local mirror (used to 'build' the live system)
+To set a local mirror to be used to at build time:
 
 code{
 
-$ lb config --mirror-bootstrap http://localhost/debian/ --mirror-chroot
-http://localhost/debian/
+$ lb config --mirror-bootstrap http://localhost/debian/
 
 }code
 
+The chroot repository, specified by --mirror-chroot, defaults to the same as
+--mirror-bootstrap.
+
+Each of the --mirror-* options governs which repository is used at various
+stages of the build. Recall from {Stages of the build}#stages-of-the-build
+that the *bootstrap* stage is when the chroot is initially populated by
+debootstrap with a minimal system, and the *chroot* stage is when the chroot
+used to construct the live system's filesystem is built. Thus, the
+corresponding mirror switches are used for those stages, and later, when the
+binary image is constructed, the --mirror-binary value is used, superceding
+any earlier repositories.
+
 The generic mirror is added to the live system's /etc/apt/sources.list.
 
 code{

-- 
live-manual