[SCM] live-manual branch, debian, updated. debian/2.0_a9-1-14-g531d6b3
Ben Armstrong
synrg at debian.org
Thu Oct 28 19:36:34 UTC 2010
The following commit has been merged in the debian branch:
commit 531d6b39b788ca10ad36956b7ed0f9e05b846ebc
Author: Ben Armstrong <synrg at debian.org>
Date: Thu Oct 28 16:35:42 2010 -0300
Focusing section on configuration via lb config, not by editing files.
diff --git a/manual/de/user_managing_a_configuration.ssi b/manual/de/user_managing_a_configuration.ssi
index 3047ef0..bc03008 100644
--- a/manual/de/user_managing_a_configuration.ssi
+++ b/manual/de/user_managing_a_configuration.ssi
@@ -1,6 +1,6 @@
:B~ Managing a configuration
-1~ Managing a configuration
+1~managing-a-configuration Managing a configuration
This chapter explains how to manage a live configuration from initial
creation, through successive revisions and successive releases of both the
diff --git a/manual/de/user_overview.ssi b/manual/de/user_overview.ssi
index e9df877..cf9f187 100644
--- a/manual/de/user_overview.ssi
+++ b/manual/de/user_overview.ssi
@@ -32,37 +32,6 @@ configuration directory, #{lb config}#. This could be considered to be
similar to tools such as #{dh-make}#. For more information about #{lb
config}#, please see {The lb config command}#lb-config.
-Besides the common config/common, which is used by all live-build commands,
-some additional files can be used to configure the behavior of specific
-helper commands. These files are typically named config/command or
-config/stage (where "stage", of course, is replaced with the name of the
-stage that they belong to, and "command" with the name of the command).
-
-For example, the #{lb_bootstrap_debootstrap}# command uses files named
-config/bootstrap and config/bootstrap_debootstrap to read the options it
-will use. Generally, these files contain variables with values assigned, one
-variable per line. Some commands of live-buil use pairs of values or
-slightly more complicated variable assignments.
-
-live-build respects environment variables which are present in the context
-of the shell it is running. If variables can be read from config files, then
-they override environment variables, and if command line options are used,
-they override values from config files. If no value for a given variable can
-be found (and is thus unset), live-build will automatically set it to a
-default value.
-
-All config files are shell scripts which are sourced by a live-build
-command. That means they have to follow the normal shell syntax. You can
-also put comments in these files; lines beginning with "#" are ignored.
-
-In some rare cases you may want to have different versions of these files
-for different architectures or distributions. If files named
-config/stage.arch or config/stage_command.arch, and config/stage.dist or
-config/stage_command.dist exist (where "arch" is the same as the output of
-dpkg --print-architecture and "dist" is the same as the codename of the
-target distribution), then they will be used in preference to the other,
-more general files.
-
The remainder of this section discusses the three most important commands:
_* *{lb config}*: Responsible for initializing a Live system configuration
@@ -117,12 +86,12 @@ drwxr-xr-x 2 user user 4096 Sep 7 13:02 templates
}code
Using #{lb config}# without any arguments would be suitable for users who
-are either happy editing the generated files, or are simply happy with the
-defaults it creates.
+need a very basic image, or who intend to later provide a more complete
+configuration via auto/config (see {Managing a
+configuration}#managing-a-configuration for details).
-You can ask #{lb config}# to generate a config/ directory "preseeded" with
-various options. This might be suitable if you do not require the default
-settings but do not need to change a large number of options. For example:
+Normally, you will want to specify some options. For example, to include the
+'gnome' package list in your configuration:
code{
@@ -130,8 +99,7 @@ $ lb config -p gnome
}code
-will build a config/ directory configured to include the 'gnome' package
-list. It is possible to specify many options:
+It is possible to specify many options, such as:
code{
@@ -140,8 +108,7 @@ $ lb config --binary-images net --hostname live-machine --username live-user
}code
-A full list of options is available in the #{lb_config}# man page. Most
-options have a parallel with an "LB_" prefixed variable.
+A full list of options is available in the #{lb_config}# man page.
3~lb-build The #{lb build}# command
diff --git a/manual/en/user_managing_a_configuration.ssi b/manual/en/user_managing_a_configuration.ssi
index 81c5eea..7c68d73 100644
--- a/manual/en/user_managing_a_configuration.ssi
+++ b/manual/en/user_managing_a_configuration.ssi
@@ -1,6 +1,6 @@
:B~ Managing a configuration
-1~ Managing a configuration
+1~managing-a-configuration Managing a configuration
This chapter explains how to manage a live configuration from initial creation, through successive revisions and successive releases of both the live-build software and the live image itself.
diff --git a/manual/en/user_overview.ssi b/manual/en/user_overview.ssi
index 9fcb95a..5767950 100644
--- a/manual/en/user_overview.ssi
+++ b/manual/en/user_overview.ssi
@@ -18,16 +18,6 @@ _* The scripts are independent - that is to say, it is always safe to run each c
Unlike debhelper, live-build contains a tool to generate a skeleton configuration directory, #{lb config}#. This could be considered to be similar to tools such as #{dh-make}#. For more information about #{lb config}#, please see {The lb config command}#lb-config.
-Besides the common config/common, which is used by all live-build commands, some additional files can be used to configure the behavior of specific helper commands. These files are typically named config/command or config/stage (where "stage", of course, is replaced with the name of the stage that they belong to, and "command" with the name of the command).
-
-For example, the #{lb_bootstrap_debootstrap}# command uses files named config/bootstrap and config/bootstrap_debootstrap to read the options it will use. Generally, these files contain variables with values assigned, one variable per line. Some commands of live-buil use pairs of values or slightly more complicated variable assignments.
-
-live-build respects environment variables which are present in the context of the shell it is running. If variables can be read from config files, then they override environment variables, and if command line options are used, they override values from config files. If no value for a given variable can be found (and is thus unset), live-build will automatically set it to a default value.
-
-All config files are shell scripts which are sourced by a live-build command. That means they have to follow the normal shell syntax. You can also put comments in these files; lines beginning with "#" are ignored.
-
-In some rare cases you may want to have different versions of these files for different architectures or distributions. If files named config/stage.arch or config/stage_command.arch, and config/stage.dist or config/stage_command.dist exist (where "arch" is the same as the output of dpkg --print-architecture and "dist" is the same as the codename of the target distribution), then they will be used in preference to the other, more general files.
-
The remainder of this section discusses the three most important commands:
_* *{lb config}*: Responsible for initializing a Live system configuration directory. See {The lb config command}#lb-config for more information.
@@ -82,9 +72,9 @@ drwxr-xr-x 2 user user 4096 Sep 7 13:02 templates
}code
-Using #{lb config}# without any arguments would be suitable for users who are either happy editing the generated files, or are simply happy with the defaults it creates.
+Using #{lb config}# without any arguments would be suitable for users who need a very basic image, or who intend to later provide a more complete configuration via auto/config (see {Managing a configuration}#managing-a-configuration for details).
-You can ask #{lb config}# to generate a config/ directory "preseeded" with various options. This might be suitable if you do not require the default settings but do not need to change a large number of options. For example:
+Normally, you will want to specify some options. For example, to include the 'gnome' package list in your configuration:
code{
@@ -92,7 +82,7 @@ $ lb config -p gnome
}code
-will build a config/ directory configured to include the 'gnome' package list. It is possible to specify many options:
+It is possible to specify many options, such as:
code{
@@ -100,7 +90,7 @@ $ lb config --binary-images net --hostname live-machine --username live-user ...
}code
-A full list of options is available in the #{lb_config}# man page. Most options have a parallel with an "LB_" prefixed variable.
+A full list of options is available in the #{lb_config}# man page.
3~lb-build The #{lb build}# command
diff --git a/manual/fr/user_managing_a_configuration.ssi b/manual/fr/user_managing_a_configuration.ssi
index 3047ef0..bc03008 100644
--- a/manual/fr/user_managing_a_configuration.ssi
+++ b/manual/fr/user_managing_a_configuration.ssi
@@ -1,6 +1,6 @@
:B~ Managing a configuration
-1~ Managing a configuration
+1~managing-a-configuration Managing a configuration
This chapter explains how to manage a live configuration from initial
creation, through successive revisions and successive releases of both the
diff --git a/manual/fr/user_overview.ssi b/manual/fr/user_overview.ssi
index e9df877..cf9f187 100644
--- a/manual/fr/user_overview.ssi
+++ b/manual/fr/user_overview.ssi
@@ -32,37 +32,6 @@ configuration directory, #{lb config}#. This could be considered to be
similar to tools such as #{dh-make}#. For more information about #{lb
config}#, please see {The lb config command}#lb-config.
-Besides the common config/common, which is used by all live-build commands,
-some additional files can be used to configure the behavior of specific
-helper commands. These files are typically named config/command or
-config/stage (where "stage", of course, is replaced with the name of the
-stage that they belong to, and "command" with the name of the command).
-
-For example, the #{lb_bootstrap_debootstrap}# command uses files named
-config/bootstrap and config/bootstrap_debootstrap to read the options it
-will use. Generally, these files contain variables with values assigned, one
-variable per line. Some commands of live-buil use pairs of values or
-slightly more complicated variable assignments.
-
-live-build respects environment variables which are present in the context
-of the shell it is running. If variables can be read from config files, then
-they override environment variables, and if command line options are used,
-they override values from config files. If no value for a given variable can
-be found (and is thus unset), live-build will automatically set it to a
-default value.
-
-All config files are shell scripts which are sourced by a live-build
-command. That means they have to follow the normal shell syntax. You can
-also put comments in these files; lines beginning with "#" are ignored.
-
-In some rare cases you may want to have different versions of these files
-for different architectures or distributions. If files named
-config/stage.arch or config/stage_command.arch, and config/stage.dist or
-config/stage_command.dist exist (where "arch" is the same as the output of
-dpkg --print-architecture and "dist" is the same as the codename of the
-target distribution), then they will be used in preference to the other,
-more general files.
-
The remainder of this section discusses the three most important commands:
_* *{lb config}*: Responsible for initializing a Live system configuration
@@ -117,12 +86,12 @@ drwxr-xr-x 2 user user 4096 Sep 7 13:02 templates
}code
Using #{lb config}# without any arguments would be suitable for users who
-are either happy editing the generated files, or are simply happy with the
-defaults it creates.
+need a very basic image, or who intend to later provide a more complete
+configuration via auto/config (see {Managing a
+configuration}#managing-a-configuration for details).
-You can ask #{lb config}# to generate a config/ directory "preseeded" with
-various options. This might be suitable if you do not require the default
-settings but do not need to change a large number of options. For example:
+Normally, you will want to specify some options. For example, to include the
+'gnome' package list in your configuration:
code{
@@ -130,8 +99,7 @@ $ lb config -p gnome
}code
-will build a config/ directory configured to include the 'gnome' package
-list. It is possible to specify many options:
+It is possible to specify many options, such as:
code{
@@ -140,8 +108,7 @@ $ lb config --binary-images net --hostname live-machine --username live-user
}code
-A full list of options is available in the #{lb_config}# man page. Most
-options have a parallel with an "LB_" prefixed variable.
+A full list of options is available in the #{lb_config}# man page.
3~lb-build The #{lb build}# command
diff --git a/manual/po/de/user_managing_a_configuration.ssi.po b/manual/po/de/user_managing_a_configuration.ssi.po
index 5b045c7..416e9eb 100644
--- a/manual/po/de/user_managing_a_configuration.ssi.po
+++ b/manual/po/de/user_managing_a_configuration.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-13 17:00+0300\n"
+"POT-Creation-Date: 2010-10-28 16:34-0200\n"
"PO-Revision-Date: 2010-10-13 17:00+0300\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -17,8 +17,8 @@ msgstr ""
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#. type: Plain text
-#: en/about_manual.ssi:82 en/about_manual.ssi:90 en/about_manual.ssi:98
-#: en/about_manual.ssi:110 en/about_manual.ssi:121 en/about_manual.ssi:134
+#: en/about_manual.ssi:80 en/about_manual.ssi:88 en/about_manual.ssi:96
+#: en/about_manual.ssi:108 en/about_manual.ssi:121 en/about_manual.ssi:134
#: en/about_manual.ssi:142 en/about_manual.ssi:150 en/about_manual.ssi:158
#: en/other_coding-style.ssi:28 en/other_coding-style.ssi:38
#: en/other_coding-style.ssi:51 en/other_coding-style.ssi:61
@@ -41,14 +41,15 @@ msgstr ""
#: 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:88 en/user_basics.ssi:104 en/user_basics.ssi:112
-#: en/user_basics.ssi:120 en/user_basics.ssi:130 en/user_basics.ssi:142
-#: en/user_basics.ssi:154 en/user_basics.ssi:162 en/user_basics.ssi:170
-#: en/user_basics.ssi:184 en/user_basics.ssi:192 en/user_basics.ssi:202
-#: en/user_basics.ssi:222 en/user_basics.ssi:255 en/user_basics.ssi:271
-#: en/user_basics.ssi:279 en/user_basics.ssi:299 en/user_basics.ssi:324
+#: en/other_use-cases.ssi:103 en/other_use-cases.ssi:111
+#: 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
@@ -67,17 +68,17 @@ msgstr ""
#: 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:105
-#: en/user_installation.ssi:119 en/user_installation.ssi:136
+#: 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:60
-#: en/user_overview.ssi:104 en/user_overview.ssi:112
+#: 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 ""
#. type: Plain text
-#: en/about_manual.ssi:86 en/about_manual.ssi:94 en/about_manual.ssi:102
+#: en/about_manual.ssi:84 en/about_manual.ssi:92 en/about_manual.ssi:100
#: en/about_manual.ssi:117 en/about_manual.ssi:130 en/about_manual.ssi:138
#: en/about_manual.ssi:146 en/about_manual.ssi:154 en/about_manual.ssi:161
#: en/other_coding-style.ssi:34 en/other_coding-style.ssi:45
@@ -101,14 +102,15 @@ msgstr ""
#: 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:94
-#: en/user_basics.ssi:108 en/user_basics.ssi:116 en/user_basics.ssi:124
-#: en/user_basics.ssi:134 en/user_basics.ssi:148 en/user_basics.ssi:158
-#: en/user_basics.ssi:166 en/user_basics.ssi:174 en/user_basics.ssi:188
-#: en/user_basics.ssi:196 en/user_basics.ssi:206 en/user_basics.ssi:247
-#: en/user_basics.ssi:275 en/user_basics.ssi:283 en/user_basics.ssi:310
-#: en/user_basics.ssi:349 en/user_customization-contents.ssi:39
+#: en/other_use-cases.ssi:137 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
@@ -126,11 +128,12 @@ msgstr ""
#: 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:109 en/user_installation.ssi:124
-#: en/user_installation.ssi:139 en/user_managing_a_configuration.ssi:31
+#: 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:98
-#: en/user_overview.ssi:108 en/user_overview.ssi:116
+#: 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 ""
@@ -141,7 +144,7 @@ msgstr ""
#. type: Plain text
#: en/user_managing_a_configuration.ssi:4
-msgid "1~ Managing a configuration"
+msgid "1~managing-a-configuration Managing a configuration"
msgstr ""
#. type: Plain text
diff --git a/manual/po/de/user_overview.ssi.po b/manual/po/de/user_overview.ssi.po
index 2ed9db3..93192b9 100644
--- a/manual/po/de/user_overview.ssi.po
+++ b/manual/po/de/user_overview.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-28 07:47-0200\n"
+"POT-Creation-Date: 2010-10-28 16:34-0200\n"
"PO-Revision-Date: 2010-10-03 20:30+0300\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -72,8 +72,8 @@ msgstr ""
#: 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 ""
@@ -132,8 +132,8 @@ msgstr ""
#: 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 ""
@@ -211,88 +211,37 @@ msgstr ""
#. type: Plain text
#: en/user_overview.ssi:22
msgid ""
-"Besides the common config/common, which is used by all live-build commands, "
-"some additional files can be used to configure the behavior of specific "
-"helper commands. These files are typically named config/command or config/"
-"stage (where \"stage\", of course, is replaced with the name of the stage "
-"that they belong to, and \"command\" with the name of the command)."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:24
-msgid ""
-"For example, the #{lb_bootstrap_debootstrap}# command uses files named "
-"config/bootstrap and config/bootstrap_debootstrap to read the options it "
-"will use. Generally, these files contain variables with values assigned, one "
-"variable per line. Some commands of live-buil use pairs of values or "
-"slightly more complicated variable assignments."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:26
-msgid ""
-"live-build respects environment variables which are present in the context "
-"of the shell it is running. If variables can be read from config files, then "
-"they override environment variables, and if command line options are used, "
-"they override values from config files. If no value for a given variable can "
-"be found (and is thus unset), live-build will automatically set it to a "
-"default value."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:28
-msgid ""
-"All config files are shell scripts which are sourced by a live-build "
-"command. That means they have to follow the normal shell syntax. You can "
-"also put comments in these files; lines beginning with \"#\" are ignored."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:30
-msgid ""
-"In some rare cases you may want to have different versions of these files "
-"for different architectures or distributions. If files named config/stage."
-"arch or config/stage_command.arch, and config/stage.dist or config/"
-"stage_command.dist exist (where \"arch\" is the same as the output of dpkg --"
-"print-architecture and \"dist\" is the same as the codename of the target "
-"distribution), then they will be used in preference to the other, more "
-"general files."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:32
-msgid ""
"The remainder of this section discusses the three most important commands:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:34
+#: en/user_overview.ssi:24
msgid ""
"_* *{lb config}*: Responsible for initializing a Live system configuration "
"directory. See {The lb config command}#lb-config for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:36
+#: en/user_overview.ssi:26
msgid ""
"_* *{lb build}*: Responsible for starting a Live system build. See {The lb "
"build command}#lb-build for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:38
+#: en/user_overview.ssi:28
msgid ""
"_* *{lb clean}*: Responsible for removing parts of a Live system build. See "
"{The lb clean command}#lb-clean for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:40
+#: en/user_overview.ssi:30
msgid "3~lb-config The #{lb config}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:42
+#: en/user_overview.ssi:32
msgid ""
"As discussed in {live-build}#live-build, the scripts that make up live-build "
"source their configuration from a single directory named config/. As "
@@ -302,26 +251,26 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:44
+#: en/user_overview.ssi:34
msgid ""
"Issuing #{lb config}# without any arguments creates a config subdirectory "
"which it populates with some default settings:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:49
+#: en/user_overview.ssi:39
msgid "$ lb config P: Creating config tree"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:54
+#: en/user_overview.ssi:44
msgid ""
"$ ls -l total 8 drwxr-xr-x 3 user user 4096 Sep 7 13:02 auto drwxr-xr-x 22 "
"user user 4096 Sep 7 13:02 config"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:82
+#: en/user_overview.ssi:72
msgid ""
"$ ls -l config/ total 104 -rw-r--r-- 1 user user 4197 Sep 7 13:02 binary "
"drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_debian-installer drwxr-xr-x 2 "
@@ -346,54 +295,50 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:86
+#: en/user_overview.ssi:76
msgid ""
"Using #{lb config}# without any arguments would be suitable for users who "
-"are either happy editing the generated files, or are simply happy with the "
-"defaults it creates."
+"need a very basic image, or who intend to later provide a more complete "
+"configuration via auto/config (see {Managing a configuration}#managing-a-"
+"configuration for details)."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:88
+#: en/user_overview.ssi:78
msgid ""
-"You can ask #{lb config}# to generate a config/ directory \"preseeded\" with "
-"various options. This might be suitable if you do not require the default "
-"settings but do not need to change a large number of options. For example:"
+"Normally, you will want to specify some options. For example, to include the "
+"'gnome' package list in your configuration:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:92
+#: en/user_overview.ssi:82
msgid "$ lb config -p gnome"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:96
-msgid ""
-"will build a config/ directory configured to include the 'gnome' package "
-"list. It is possible to specify many options:"
+#: en/user_overview.ssi:86
+msgid "It is possible to specify many options, such as:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:100
+#: en/user_overview.ssi:90
msgid ""
"$ lb config --binary-images net --hostname live-machine --username live-"
"user ..."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:104
-msgid ""
-"A full list of options is available in the #{lb_config}# man page. Most "
-"options have a parallel with an \"LB_\" prefixed variable."
+#: en/user_overview.ssi:94
+msgid "A full list of options is available in the #{lb_config}# man page."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:106
+#: en/user_overview.ssi:96
msgid "3~lb-build The #{lb build}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:108
+#: en/user_overview.ssi:98
msgid ""
"The #{lb build}# command reads in your configuration from the config/ "
"directory. It then runs the lower lower level commands needed to build your "
@@ -401,24 +346,24 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:110
+#: en/user_overview.ssi:100
msgid "3~lb-clean The #{lb clean}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:112
+#: en/user_overview.ssi:102
msgid ""
"It is the job of the #{lb clean}# command to remove various parts of a build "
"so subsequent builds can start from a clean state."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:114
+#: en/user_overview.ssi:104
msgid "2~live-boot The live-boot package"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:116
+#: en/user_overview.ssi:106
msgid ""
"live-boot is a collection of scripts providing hooks for the initramfs-"
"tools, used to generate an initramfs capable of booting live systems, such "
@@ -427,7 +372,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:118
+#: en/user_overview.ssi:108
msgid ""
"At boot time it will look for read-only media containing a \"/live\" "
"directory where a root filesystem (often a compressed filesystem image like "
@@ -436,7 +381,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:120
+#: en/user_overview.ssi:110
msgid ""
"More information on initial ramfs in Debian can be found in the Debian Linux "
"Kernel Handbook at http://kernel-handbook.alioth.debian.org/ in the chapter "
@@ -444,12 +389,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:122
+#: en/user_overview.ssi:112
msgid "2~live-config The live-config package"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:124
+#: en/user_overview.ssi:114
msgid ""
"live-config consists of the scripts that run at boot time after live-boot to "
"configure the live system automatically. It handles such tasks as setting "
diff --git a/manual/po/fr/user_managing_a_configuration.ssi.po b/manual/po/fr/user_managing_a_configuration.ssi.po
index cd76359..a2ca66a 100644
--- a/manual/po/fr/user_managing_a_configuration.ssi.po
+++ b/manual/po/fr/user_managing_a_configuration.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-13 17:00+0300\n"
+"POT-Creation-Date: 2010-10-28 16:34-0200\n"
"PO-Revision-Date: 2010-10-13 17:00+0300\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -17,8 +17,8 @@ msgstr ""
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
#. type: Plain text
-#: en/about_manual.ssi:82 en/about_manual.ssi:90 en/about_manual.ssi:98
-#: en/about_manual.ssi:110 en/about_manual.ssi:121 en/about_manual.ssi:134
+#: en/about_manual.ssi:80 en/about_manual.ssi:88 en/about_manual.ssi:96
+#: en/about_manual.ssi:108 en/about_manual.ssi:121 en/about_manual.ssi:134
#: en/about_manual.ssi:142 en/about_manual.ssi:150 en/about_manual.ssi:158
#: en/other_coding-style.ssi:28 en/other_coding-style.ssi:38
#: en/other_coding-style.ssi:51 en/other_coding-style.ssi:61
@@ -41,14 +41,15 @@ msgstr ""
#: 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:88 en/user_basics.ssi:104 en/user_basics.ssi:112
-#: en/user_basics.ssi:120 en/user_basics.ssi:130 en/user_basics.ssi:142
-#: en/user_basics.ssi:154 en/user_basics.ssi:162 en/user_basics.ssi:170
-#: en/user_basics.ssi:184 en/user_basics.ssi:192 en/user_basics.ssi:202
-#: en/user_basics.ssi:222 en/user_basics.ssi:255 en/user_basics.ssi:271
-#: en/user_basics.ssi:279 en/user_basics.ssi:299 en/user_basics.ssi:324
+#: en/other_use-cases.ssi:103 en/other_use-cases.ssi:111
+#: 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
@@ -67,17 +68,17 @@ msgstr ""
#: 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:105
-#: en/user_installation.ssi:119 en/user_installation.ssi:136
+#: 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:60
-#: en/user_overview.ssi:104 en/user_overview.ssi:112
+#: 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{"
#. type: Plain text
-#: en/about_manual.ssi:86 en/about_manual.ssi:94 en/about_manual.ssi:102
+#: en/about_manual.ssi:84 en/about_manual.ssi:92 en/about_manual.ssi:100
#: en/about_manual.ssi:117 en/about_manual.ssi:130 en/about_manual.ssi:138
#: en/about_manual.ssi:146 en/about_manual.ssi:154 en/about_manual.ssi:161
#: en/other_coding-style.ssi:34 en/other_coding-style.ssi:45
@@ -101,14 +102,15 @@ msgstr "code{"
#: 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:94
-#: en/user_basics.ssi:108 en/user_basics.ssi:116 en/user_basics.ssi:124
-#: en/user_basics.ssi:134 en/user_basics.ssi:148 en/user_basics.ssi:158
-#: en/user_basics.ssi:166 en/user_basics.ssi:174 en/user_basics.ssi:188
-#: en/user_basics.ssi:196 en/user_basics.ssi:206 en/user_basics.ssi:247
-#: en/user_basics.ssi:275 en/user_basics.ssi:283 en/user_basics.ssi:310
-#: en/user_basics.ssi:349 en/user_customization-contents.ssi:39
+#: en/other_use-cases.ssi:137 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
@@ -126,11 +128,12 @@ msgstr "code{"
#: 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:109 en/user_installation.ssi:124
-#: en/user_installation.ssi:139 en/user_managing_a_configuration.ssi:31
+#: 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:98
-#: en/user_overview.ssi:108 en/user_overview.ssi:116
+#: 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"
@@ -141,7 +144,7 @@ msgstr ""
#. type: Plain text
#: en/user_managing_a_configuration.ssi:4
-msgid "1~ Managing a configuration"
+msgid "1~managing-a-configuration Managing a configuration"
msgstr ""
#. type: Plain text
diff --git a/manual/po/fr/user_overview.ssi.po b/manual/po/fr/user_overview.ssi.po
index 372c989..9c055a4 100644
--- a/manual/po/fr/user_overview.ssi.po
+++ b/manual/po/fr/user_overview.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-28 07:47-0200\n"
+"POT-Creation-Date: 2010-10-28 16:34-0200\n"
"PO-Revision-Date: 2010-10-21 07:06-0200\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -72,8 +72,8 @@ msgstr ""
#: 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{"
@@ -132,8 +132,8 @@ msgstr "code{"
#: 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"
@@ -211,88 +211,37 @@ msgstr ""
#. type: Plain text
#: en/user_overview.ssi:22
msgid ""
-"Besides the common config/common, which is used by all live-build commands, "
-"some additional files can be used to configure the behavior of specific "
-"helper commands. These files are typically named config/command or config/"
-"stage (where \"stage\", of course, is replaced with the name of the stage "
-"that they belong to, and \"command\" with the name of the command)."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:24
-msgid ""
-"For example, the #{lb_bootstrap_debootstrap}# command uses files named "
-"config/bootstrap and config/bootstrap_debootstrap to read the options it "
-"will use. Generally, these files contain variables with values assigned, one "
-"variable per line. Some commands of live-buil use pairs of values or "
-"slightly more complicated variable assignments."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:26
-msgid ""
-"live-build respects environment variables which are present in the context "
-"of the shell it is running. If variables can be read from config files, then "
-"they override environment variables, and if command line options are used, "
-"they override values from config files. If no value for a given variable can "
-"be found (and is thus unset), live-build will automatically set it to a "
-"default value."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:28
-msgid ""
-"All config files are shell scripts which are sourced by a live-build "
-"command. That means they have to follow the normal shell syntax. You can "
-"also put comments in these files; lines beginning with \"#\" are ignored."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:30
-msgid ""
-"In some rare cases you may want to have different versions of these files "
-"for different architectures or distributions. If files named config/stage."
-"arch or config/stage_command.arch, and config/stage.dist or config/"
-"stage_command.dist exist (where \"arch\" is the same as the output of dpkg --"
-"print-architecture and \"dist\" is the same as the codename of the target "
-"distribution), then they will be used in preference to the other, more "
-"general files."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:32
-msgid ""
"The remainder of this section discusses the three most important commands:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:34
+#: en/user_overview.ssi:24
msgid ""
"_* *{lb config}*: Responsible for initializing a Live system configuration "
"directory. See {The lb config command}#lb-config for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:36
+#: en/user_overview.ssi:26
msgid ""
"_* *{lb build}*: Responsible for starting a Live system build. See {The lb "
"build command}#lb-build for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:38
+#: en/user_overview.ssi:28
msgid ""
"_* *{lb clean}*: Responsible for removing parts of a Live system build. See "
"{The lb clean command}#lb-clean for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:40
+#: en/user_overview.ssi:30
msgid "3~lb-config The #{lb config}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:42
+#: en/user_overview.ssi:32
msgid ""
"As discussed in {live-build}#live-build, the scripts that make up live-build "
"source their configuration from a single directory named config/. As "
@@ -302,26 +251,26 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:44
+#: en/user_overview.ssi:34
msgid ""
"Issuing #{lb config}# without any arguments creates a config subdirectory "
"which it populates with some default settings:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:49
+#: en/user_overview.ssi:39
msgid "$ lb config P: Creating config tree"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:54
+#: en/user_overview.ssi:44
msgid ""
"$ ls -l total 8 drwxr-xr-x 3 user user 4096 Sep 7 13:02 auto drwxr-xr-x 22 "
"user user 4096 Sep 7 13:02 config"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:82
+#: en/user_overview.ssi:72
msgid ""
"$ ls -l config/ total 104 -rw-r--r-- 1 user user 4197 Sep 7 13:02 binary "
"drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_debian-installer drwxr-xr-x 2 "
@@ -346,54 +295,50 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:86
+#: en/user_overview.ssi:76
msgid ""
"Using #{lb config}# without any arguments would be suitable for users who "
-"are either happy editing the generated files, or are simply happy with the "
-"defaults it creates."
+"need a very basic image, or who intend to later provide a more complete "
+"configuration via auto/config (see {Managing a configuration}#managing-a-"
+"configuration for details)."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:88
+#: en/user_overview.ssi:78
msgid ""
-"You can ask #{lb config}# to generate a config/ directory \"preseeded\" with "
-"various options. This might be suitable if you do not require the default "
-"settings but do not need to change a large number of options. For example:"
+"Normally, you will want to specify some options. For example, to include the "
+"'gnome' package list in your configuration:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:92
+#: en/user_overview.ssi:82
msgid "$ lb config -p gnome"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:96
-msgid ""
-"will build a config/ directory configured to include the 'gnome' package "
-"list. It is possible to specify many options:"
+#: en/user_overview.ssi:86
+msgid "It is possible to specify many options, such as:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:100
+#: en/user_overview.ssi:90
msgid ""
"$ lb config --binary-images net --hostname live-machine --username live-"
"user ..."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:104
-msgid ""
-"A full list of options is available in the #{lb_config}# man page. Most "
-"options have a parallel with an \"LB_\" prefixed variable."
+#: en/user_overview.ssi:94
+msgid "A full list of options is available in the #{lb_config}# man page."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:106
+#: en/user_overview.ssi:96
msgid "3~lb-build The #{lb build}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:108
+#: en/user_overview.ssi:98
msgid ""
"The #{lb build}# command reads in your configuration from the config/ "
"directory. It then runs the lower lower level commands needed to build your "
@@ -401,24 +346,24 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:110
+#: en/user_overview.ssi:100
msgid "3~lb-clean The #{lb clean}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:112
+#: en/user_overview.ssi:102
msgid ""
"It is the job of the #{lb clean}# command to remove various parts of a build "
"so subsequent builds can start from a clean state."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:114
+#: en/user_overview.ssi:104
msgid "2~live-boot The live-boot package"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:116
+#: en/user_overview.ssi:106
msgid ""
"live-boot is a collection of scripts providing hooks for the initramfs-"
"tools, used to generate an initramfs capable of booting live systems, such "
@@ -427,7 +372,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:118
+#: en/user_overview.ssi:108
msgid ""
"At boot time it will look for read-only media containing a \"/live\" "
"directory where a root filesystem (often a compressed filesystem image like "
@@ -436,7 +381,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:120
+#: en/user_overview.ssi:110
msgid ""
"More information on initial ramfs in Debian can be found in the Debian Linux "
"Kernel Handbook at http://kernel-handbook.alioth.debian.org/ in the chapter "
@@ -444,12 +389,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:122
+#: en/user_overview.ssi:112
msgid "2~live-config The live-config package"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:124
+#: en/user_overview.ssi:114
msgid ""
"live-config consists of the scripts that run at boot time after live-boot to "
"configure the live system automatically. It handles such tasks as setting "
diff --git a/manual/po/pt_BR/user_managing_a_configuration.ssi.po b/manual/po/pt_BR/user_managing_a_configuration.ssi.po
index 010cb70..dc370cb 100644
--- a/manual/po/pt_BR/user_managing_a_configuration.ssi.po
+++ b/manual/po/pt_BR/user_managing_a_configuration.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-13 17:00+0300\n"
+"POT-Creation-Date: 2010-10-28 16:34-0200\n"
"PO-Revision-Date: 2010-10-13 17:00+0300\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -17,8 +17,8 @@ msgstr ""
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
#. type: Plain text
-#: en/about_manual.ssi:82 en/about_manual.ssi:90 en/about_manual.ssi:98
-#: en/about_manual.ssi:110 en/about_manual.ssi:121 en/about_manual.ssi:134
+#: en/about_manual.ssi:80 en/about_manual.ssi:88 en/about_manual.ssi:96
+#: en/about_manual.ssi:108 en/about_manual.ssi:121 en/about_manual.ssi:134
#: en/about_manual.ssi:142 en/about_manual.ssi:150 en/about_manual.ssi:158
#: en/other_coding-style.ssi:28 en/other_coding-style.ssi:38
#: en/other_coding-style.ssi:51 en/other_coding-style.ssi:61
@@ -41,14 +41,15 @@ msgstr ""
#: 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:88 en/user_basics.ssi:104 en/user_basics.ssi:112
-#: en/user_basics.ssi:120 en/user_basics.ssi:130 en/user_basics.ssi:142
-#: en/user_basics.ssi:154 en/user_basics.ssi:162 en/user_basics.ssi:170
-#: en/user_basics.ssi:184 en/user_basics.ssi:192 en/user_basics.ssi:202
-#: en/user_basics.ssi:222 en/user_basics.ssi:255 en/user_basics.ssi:271
-#: en/user_basics.ssi:279 en/user_basics.ssi:299 en/user_basics.ssi:324
+#: en/other_use-cases.ssi:103 en/other_use-cases.ssi:111
+#: 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
@@ -67,17 +68,17 @@ msgstr ""
#: 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:105
-#: en/user_installation.ssi:119 en/user_installation.ssi:136
+#: 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:60
-#: en/user_overview.ssi:104 en/user_overview.ssi:112
+#: 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{"
#. type: Plain text
-#: en/about_manual.ssi:86 en/about_manual.ssi:94 en/about_manual.ssi:102
+#: en/about_manual.ssi:84 en/about_manual.ssi:92 en/about_manual.ssi:100
#: en/about_manual.ssi:117 en/about_manual.ssi:130 en/about_manual.ssi:138
#: en/about_manual.ssi:146 en/about_manual.ssi:154 en/about_manual.ssi:161
#: en/other_coding-style.ssi:34 en/other_coding-style.ssi:45
@@ -101,14 +102,15 @@ msgstr "code{"
#: 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:94
-#: en/user_basics.ssi:108 en/user_basics.ssi:116 en/user_basics.ssi:124
-#: en/user_basics.ssi:134 en/user_basics.ssi:148 en/user_basics.ssi:158
-#: en/user_basics.ssi:166 en/user_basics.ssi:174 en/user_basics.ssi:188
-#: en/user_basics.ssi:196 en/user_basics.ssi:206 en/user_basics.ssi:247
-#: en/user_basics.ssi:275 en/user_basics.ssi:283 en/user_basics.ssi:310
-#: en/user_basics.ssi:349 en/user_customization-contents.ssi:39
+#: en/other_use-cases.ssi:137 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
@@ -126,11 +128,12 @@ msgstr "code{"
#: 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:109 en/user_installation.ssi:124
-#: en/user_installation.ssi:139 en/user_managing_a_configuration.ssi:31
+#: 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:98
-#: en/user_overview.ssi:108 en/user_overview.ssi:116
+#: 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"
@@ -141,7 +144,7 @@ msgstr ""
#. type: Plain text
#: en/user_managing_a_configuration.ssi:4
-msgid "1~ Managing a configuration"
+msgid "1~managing-a-configuration Managing a configuration"
msgstr ""
#. type: Plain text
diff --git a/manual/po/pt_BR/user_overview.ssi.po b/manual/po/pt_BR/user_overview.ssi.po
index b6532e7..0e0a6f2 100644
--- a/manual/po/pt_BR/user_overview.ssi.po
+++ b/manual/po/pt_BR/user_overview.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-28 07:47-0200\n"
+"POT-Creation-Date: 2010-10-28 16:34-0200\n"
"PO-Revision-Date: 2010-10-22 07:52-0200\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -72,8 +72,8 @@ msgstr ""
#: 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{"
@@ -132,8 +132,8 @@ msgstr "code{"
#: 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"
@@ -211,88 +211,37 @@ msgstr ""
#. type: Plain text
#: en/user_overview.ssi:22
msgid ""
-"Besides the common config/common, which is used by all live-build commands, "
-"some additional files can be used to configure the behavior of specific "
-"helper commands. These files are typically named config/command or config/"
-"stage (where \"stage\", of course, is replaced with the name of the stage "
-"that they belong to, and \"command\" with the name of the command)."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:24
-msgid ""
-"For example, the #{lb_bootstrap_debootstrap}# command uses files named "
-"config/bootstrap and config/bootstrap_debootstrap to read the options it "
-"will use. Generally, these files contain variables with values assigned, one "
-"variable per line. Some commands of live-buil use pairs of values or "
-"slightly more complicated variable assignments."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:26
-msgid ""
-"live-build respects environment variables which are present in the context "
-"of the shell it is running. If variables can be read from config files, then "
-"they override environment variables, and if command line options are used, "
-"they override values from config files. If no value for a given variable can "
-"be found (and is thus unset), live-build will automatically set it to a "
-"default value."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:28
-msgid ""
-"All config files are shell scripts which are sourced by a live-build "
-"command. That means they have to follow the normal shell syntax. You can "
-"also put comments in these files; lines beginning with \"#\" are ignored."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:30
-msgid ""
-"In some rare cases you may want to have different versions of these files "
-"for different architectures or distributions. If files named config/stage."
-"arch or config/stage_command.arch, and config/stage.dist or config/"
-"stage_command.dist exist (where \"arch\" is the same as the output of dpkg --"
-"print-architecture and \"dist\" is the same as the codename of the target "
-"distribution), then they will be used in preference to the other, more "
-"general files."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:32
-msgid ""
"The remainder of this section discusses the three most important commands:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:34
+#: en/user_overview.ssi:24
msgid ""
"_* *{lb config}*: Responsible for initializing a Live system configuration "
"directory. See {The lb config command}#lb-config for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:36
+#: en/user_overview.ssi:26
msgid ""
"_* *{lb build}*: Responsible for starting a Live system build. See {The lb "
"build command}#lb-build for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:38
+#: en/user_overview.ssi:28
msgid ""
"_* *{lb clean}*: Responsible for removing parts of a Live system build. See "
"{The lb clean command}#lb-clean for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:40
+#: en/user_overview.ssi:30
msgid "3~lb-config The #{lb config}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:42
+#: en/user_overview.ssi:32
msgid ""
"As discussed in {live-build}#live-build, the scripts that make up live-build "
"source their configuration from a single directory named config/. As "
@@ -302,26 +251,26 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:44
+#: en/user_overview.ssi:34
msgid ""
"Issuing #{lb config}# without any arguments creates a config subdirectory "
"which it populates with some default settings:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:49
+#: en/user_overview.ssi:39
msgid "$ lb config P: Creating config tree"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:54
+#: en/user_overview.ssi:44
msgid ""
"$ ls -l total 8 drwxr-xr-x 3 user user 4096 Sep 7 13:02 auto drwxr-xr-x 22 "
"user user 4096 Sep 7 13:02 config"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:82
+#: en/user_overview.ssi:72
msgid ""
"$ ls -l config/ total 104 -rw-r--r-- 1 user user 4197 Sep 7 13:02 binary "
"drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_debian-installer drwxr-xr-x 2 "
@@ -346,54 +295,50 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:86
+#: en/user_overview.ssi:76
msgid ""
"Using #{lb config}# without any arguments would be suitable for users who "
-"are either happy editing the generated files, or are simply happy with the "
-"defaults it creates."
+"need a very basic image, or who intend to later provide a more complete "
+"configuration via auto/config (see {Managing a configuration}#managing-a-"
+"configuration for details)."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:88
+#: en/user_overview.ssi:78
msgid ""
-"You can ask #{lb config}# to generate a config/ directory \"preseeded\" with "
-"various options. This might be suitable if you do not require the default "
-"settings but do not need to change a large number of options. For example:"
+"Normally, you will want to specify some options. For example, to include the "
+"'gnome' package list in your configuration:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:92
+#: en/user_overview.ssi:82
msgid "$ lb config -p gnome"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:96
-msgid ""
-"will build a config/ directory configured to include the 'gnome' package "
-"list. It is possible to specify many options:"
+#: en/user_overview.ssi:86
+msgid "It is possible to specify many options, such as:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:100
+#: en/user_overview.ssi:90
msgid ""
"$ lb config --binary-images net --hostname live-machine --username live-"
"user ..."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:104
-msgid ""
-"A full list of options is available in the #{lb_config}# man page. Most "
-"options have a parallel with an \"LB_\" prefixed variable."
+#: en/user_overview.ssi:94
+msgid "A full list of options is available in the #{lb_config}# man page."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:106
+#: en/user_overview.ssi:96
msgid "3~lb-build The #{lb build}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:108
+#: en/user_overview.ssi:98
msgid ""
"The #{lb build}# command reads in your configuration from the config/ "
"directory. It then runs the lower lower level commands needed to build your "
@@ -401,24 +346,24 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:110
+#: en/user_overview.ssi:100
msgid "3~lb-clean The #{lb clean}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:112
+#: en/user_overview.ssi:102
msgid ""
"It is the job of the #{lb clean}# command to remove various parts of a build "
"so subsequent builds can start from a clean state."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:114
+#: en/user_overview.ssi:104
msgid "2~live-boot The live-boot package"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:116
+#: en/user_overview.ssi:106
msgid ""
"live-boot is a collection of scripts providing hooks for the initramfs-"
"tools, used to generate an initramfs capable of booting live systems, such "
@@ -427,7 +372,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:118
+#: en/user_overview.ssi:108
msgid ""
"At boot time it will look for read-only media containing a \"/live\" "
"directory where a root filesystem (often a compressed filesystem image like "
@@ -436,7 +381,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:120
+#: en/user_overview.ssi:110
msgid ""
"More information on initial ramfs in Debian can be found in the Debian Linux "
"Kernel Handbook at http://kernel-handbook.alioth.debian.org/ in the chapter "
@@ -444,12 +389,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:122
+#: en/user_overview.ssi:112
msgid "2~live-config The live-config package"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:124
+#: en/user_overview.ssi:114
msgid ""
"live-config consists of the scripts that run at boot time after live-boot to "
"configure the live system automatically. It handles such tasks as setting "
diff --git a/manual/po/ro/user_managing_a_configuration.ssi.po b/manual/po/ro/user_managing_a_configuration.ssi.po
index bbe1905..6c3247f 100644
--- a/manual/po/ro/user_managing_a_configuration.ssi.po
+++ b/manual/po/ro/user_managing_a_configuration.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-13 17:00+0300\n"
+"POT-Creation-Date: 2010-10-28 16:34-0200\n"
"PO-Revision-Date: 2010-10-13 17:00+0300\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -18,8 +18,8 @@ msgstr ""
"20)) ? 1 : 2;\n"
#. type: Plain text
-#: en/about_manual.ssi:82 en/about_manual.ssi:90 en/about_manual.ssi:98
-#: en/about_manual.ssi:110 en/about_manual.ssi:121 en/about_manual.ssi:134
+#: en/about_manual.ssi:80 en/about_manual.ssi:88 en/about_manual.ssi:96
+#: en/about_manual.ssi:108 en/about_manual.ssi:121 en/about_manual.ssi:134
#: en/about_manual.ssi:142 en/about_manual.ssi:150 en/about_manual.ssi:158
#: en/other_coding-style.ssi:28 en/other_coding-style.ssi:38
#: en/other_coding-style.ssi:51 en/other_coding-style.ssi:61
@@ -42,14 +42,15 @@ msgstr ""
#: 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:88 en/user_basics.ssi:104 en/user_basics.ssi:112
-#: en/user_basics.ssi:120 en/user_basics.ssi:130 en/user_basics.ssi:142
-#: en/user_basics.ssi:154 en/user_basics.ssi:162 en/user_basics.ssi:170
-#: en/user_basics.ssi:184 en/user_basics.ssi:192 en/user_basics.ssi:202
-#: en/user_basics.ssi:222 en/user_basics.ssi:255 en/user_basics.ssi:271
-#: en/user_basics.ssi:279 en/user_basics.ssi:299 en/user_basics.ssi:324
+#: en/other_use-cases.ssi:103 en/other_use-cases.ssi:111
+#: 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
@@ -68,17 +69,17 @@ msgstr ""
#: 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:105
-#: en/user_installation.ssi:119 en/user_installation.ssi:136
+#: 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:60
-#: en/user_overview.ssi:104 en/user_overview.ssi:112
+#: 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{"
#. type: Plain text
-#: en/about_manual.ssi:86 en/about_manual.ssi:94 en/about_manual.ssi:102
+#: en/about_manual.ssi:84 en/about_manual.ssi:92 en/about_manual.ssi:100
#: en/about_manual.ssi:117 en/about_manual.ssi:130 en/about_manual.ssi:138
#: en/about_manual.ssi:146 en/about_manual.ssi:154 en/about_manual.ssi:161
#: en/other_coding-style.ssi:34 en/other_coding-style.ssi:45
@@ -102,14 +103,15 @@ msgstr "code{"
#: 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:94
-#: en/user_basics.ssi:108 en/user_basics.ssi:116 en/user_basics.ssi:124
-#: en/user_basics.ssi:134 en/user_basics.ssi:148 en/user_basics.ssi:158
-#: en/user_basics.ssi:166 en/user_basics.ssi:174 en/user_basics.ssi:188
-#: en/user_basics.ssi:196 en/user_basics.ssi:206 en/user_basics.ssi:247
-#: en/user_basics.ssi:275 en/user_basics.ssi:283 en/user_basics.ssi:310
-#: en/user_basics.ssi:349 en/user_customization-contents.ssi:39
+#: en/other_use-cases.ssi:137 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
@@ -127,11 +129,12 @@ msgstr "code{"
#: 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:109 en/user_installation.ssi:124
-#: en/user_installation.ssi:139 en/user_managing_a_configuration.ssi:31
+#: 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:98
-#: en/user_overview.ssi:108 en/user_overview.ssi:116
+#: 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"
@@ -142,7 +145,7 @@ msgstr ""
#. type: Plain text
#: en/user_managing_a_configuration.ssi:4
-msgid "1~ Managing a configuration"
+msgid "1~managing-a-configuration Managing a configuration"
msgstr ""
#. type: Plain text
diff --git a/manual/po/ro/user_overview.ssi.po b/manual/po/ro/user_overview.ssi.po
index a605607..c39a513 100644
--- a/manual/po/ro/user_overview.ssi.po
+++ b/manual/po/ro/user_overview.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-28 07:47-0200\n"
+"POT-Creation-Date: 2010-10-28 16:34-0200\n"
"PO-Revision-Date: 2010-10-22 07:52-0200\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -73,8 +73,8 @@ msgstr ""
#: 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{"
@@ -133,8 +133,8 @@ msgstr "code{"
#: 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"
@@ -212,88 +212,37 @@ msgstr ""
#. type: Plain text
#: en/user_overview.ssi:22
msgid ""
-"Besides the common config/common, which is used by all live-build commands, "
-"some additional files can be used to configure the behavior of specific "
-"helper commands. These files are typically named config/command or config/"
-"stage (where \"stage\", of course, is replaced with the name of the stage "
-"that they belong to, and \"command\" with the name of the command)."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:24
-msgid ""
-"For example, the #{lb_bootstrap_debootstrap}# command uses files named "
-"config/bootstrap and config/bootstrap_debootstrap to read the options it "
-"will use. Generally, these files contain variables with values assigned, one "
-"variable per line. Some commands of live-buil use pairs of values or "
-"slightly more complicated variable assignments."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:26
-msgid ""
-"live-build respects environment variables which are present in the context "
-"of the shell it is running. If variables can be read from config files, then "
-"they override environment variables, and if command line options are used, "
-"they override values from config files. If no value for a given variable can "
-"be found (and is thus unset), live-build will automatically set it to a "
-"default value."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:28
-msgid ""
-"All config files are shell scripts which are sourced by a live-build "
-"command. That means they have to follow the normal shell syntax. You can "
-"also put comments in these files; lines beginning with \"#\" are ignored."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:30
-msgid ""
-"In some rare cases you may want to have different versions of these files "
-"for different architectures or distributions. If files named config/stage."
-"arch or config/stage_command.arch, and config/stage.dist or config/"
-"stage_command.dist exist (where \"arch\" is the same as the output of dpkg --"
-"print-architecture and \"dist\" is the same as the codename of the target "
-"distribution), then they will be used in preference to the other, more "
-"general files."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:32
-msgid ""
"The remainder of this section discusses the three most important commands:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:34
+#: en/user_overview.ssi:24
msgid ""
"_* *{lb config}*: Responsible for initializing a Live system configuration "
"directory. See {The lb config command}#lb-config for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:36
+#: en/user_overview.ssi:26
msgid ""
"_* *{lb build}*: Responsible for starting a Live system build. See {The lb "
"build command}#lb-build for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:38
+#: en/user_overview.ssi:28
msgid ""
"_* *{lb clean}*: Responsible for removing parts of a Live system build. See "
"{The lb clean command}#lb-clean for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:40
+#: en/user_overview.ssi:30
msgid "3~lb-config The #{lb config}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:42
+#: en/user_overview.ssi:32
msgid ""
"As discussed in {live-build}#live-build, the scripts that make up live-build "
"source their configuration from a single directory named config/. As "
@@ -303,26 +252,26 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:44
+#: en/user_overview.ssi:34
msgid ""
"Issuing #{lb config}# without any arguments creates a config subdirectory "
"which it populates with some default settings:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:49
+#: en/user_overview.ssi:39
msgid "$ lb config P: Creating config tree"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:54
+#: en/user_overview.ssi:44
msgid ""
"$ ls -l total 8 drwxr-xr-x 3 user user 4096 Sep 7 13:02 auto drwxr-xr-x 22 "
"user user 4096 Sep 7 13:02 config"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:82
+#: en/user_overview.ssi:72
msgid ""
"$ ls -l config/ total 104 -rw-r--r-- 1 user user 4197 Sep 7 13:02 binary "
"drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_debian-installer drwxr-xr-x 2 "
@@ -347,54 +296,50 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:86
+#: en/user_overview.ssi:76
msgid ""
"Using #{lb config}# without any arguments would be suitable for users who "
-"are either happy editing the generated files, or are simply happy with the "
-"defaults it creates."
+"need a very basic image, or who intend to later provide a more complete "
+"configuration via auto/config (see {Managing a configuration}#managing-a-"
+"configuration for details)."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:88
+#: en/user_overview.ssi:78
msgid ""
-"You can ask #{lb config}# to generate a config/ directory \"preseeded\" with "
-"various options. This might be suitable if you do not require the default "
-"settings but do not need to change a large number of options. For example:"
+"Normally, you will want to specify some options. For example, to include the "
+"'gnome' package list in your configuration:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:92
+#: en/user_overview.ssi:82
msgid "$ lb config -p gnome"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:96
-msgid ""
-"will build a config/ directory configured to include the 'gnome' package "
-"list. It is possible to specify many options:"
+#: en/user_overview.ssi:86
+msgid "It is possible to specify many options, such as:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:100
+#: en/user_overview.ssi:90
msgid ""
"$ lb config --binary-images net --hostname live-machine --username live-"
"user ..."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:104
-msgid ""
-"A full list of options is available in the #{lb_config}# man page. Most "
-"options have a parallel with an \"LB_\" prefixed variable."
+#: en/user_overview.ssi:94
+msgid "A full list of options is available in the #{lb_config}# man page."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:106
+#: en/user_overview.ssi:96
msgid "3~lb-build The #{lb build}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:108
+#: en/user_overview.ssi:98
msgid ""
"The #{lb build}# command reads in your configuration from the config/ "
"directory. It then runs the lower lower level commands needed to build your "
@@ -402,24 +347,24 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:110
+#: en/user_overview.ssi:100
msgid "3~lb-clean The #{lb clean}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:112
+#: en/user_overview.ssi:102
msgid ""
"It is the job of the #{lb clean}# command to remove various parts of a build "
"so subsequent builds can start from a clean state."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:114
+#: en/user_overview.ssi:104
msgid "2~live-boot The live-boot package"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:116
+#: en/user_overview.ssi:106
msgid ""
"live-boot is a collection of scripts providing hooks for the initramfs-"
"tools, used to generate an initramfs capable of booting live systems, such "
@@ -428,7 +373,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:118
+#: en/user_overview.ssi:108
msgid ""
"At boot time it will look for read-only media containing a \"/live\" "
"directory where a root filesystem (often a compressed filesystem image like "
@@ -437,7 +382,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:120
+#: en/user_overview.ssi:110
msgid ""
"More information on initial ramfs in Debian can be found in the Debian Linux "
"Kernel Handbook at http://kernel-handbook.alioth.debian.org/ in the chapter "
@@ -445,12 +390,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:122
+#: en/user_overview.ssi:112
msgid "2~live-config The live-config package"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:124
+#: en/user_overview.ssi:114
msgid ""
"live-config consists of the scripts that run at boot time after live-boot to "
"configure the live system automatically. It handles such tasks as setting "
diff --git a/manual/pot/user_managing_a_configuration.ssi.pot b/manual/pot/user_managing_a_configuration.ssi.pot
index 228a192..1872562 100644
--- a/manual/pot/user_managing_a_configuration.ssi.pot
+++ b/manual/pot/user_managing_a_configuration.ssi.pot
@@ -7,7 +7,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-13 17:00+0300\n"
+"POT-Creation-Date: 2010-10-28 16:34-0200\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"
@@ -17,8 +17,8 @@ msgstr ""
"Content-Transfer-Encoding: 8bit\n"
#. type: Plain text
-#: en/about_manual.ssi:82 en/about_manual.ssi:90 en/about_manual.ssi:98
-#: en/about_manual.ssi:110 en/about_manual.ssi:121 en/about_manual.ssi:134
+#: en/about_manual.ssi:80 en/about_manual.ssi:88 en/about_manual.ssi:96
+#: en/about_manual.ssi:108 en/about_manual.ssi:121 en/about_manual.ssi:134
#: en/about_manual.ssi:142 en/about_manual.ssi:150 en/about_manual.ssi:158
#: en/other_coding-style.ssi:28 en/other_coding-style.ssi:38
#: en/other_coding-style.ssi:51 en/other_coding-style.ssi:61
@@ -41,14 +41,15 @@ msgstr ""
#: 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:88 en/user_basics.ssi:104 en/user_basics.ssi:112
-#: en/user_basics.ssi:120 en/user_basics.ssi:130 en/user_basics.ssi:142
-#: en/user_basics.ssi:154 en/user_basics.ssi:162 en/user_basics.ssi:170
-#: en/user_basics.ssi:184 en/user_basics.ssi:192 en/user_basics.ssi:202
-#: en/user_basics.ssi:222 en/user_basics.ssi:255 en/user_basics.ssi:271
-#: en/user_basics.ssi:279 en/user_basics.ssi:299 en/user_basics.ssi:324
+#: en/other_use-cases.ssi:103 en/other_use-cases.ssi:111
+#: 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
@@ -67,17 +68,17 @@ msgstr ""
#: 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:105
-#: en/user_installation.ssi:119 en/user_installation.ssi:136
+#: 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:60
-#: en/user_overview.ssi:104 en/user_overview.ssi:112
+#: 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 ""
#. type: Plain text
-#: en/about_manual.ssi:86 en/about_manual.ssi:94 en/about_manual.ssi:102
+#: en/about_manual.ssi:84 en/about_manual.ssi:92 en/about_manual.ssi:100
#: en/about_manual.ssi:117 en/about_manual.ssi:130 en/about_manual.ssi:138
#: en/about_manual.ssi:146 en/about_manual.ssi:154 en/about_manual.ssi:161
#: en/other_coding-style.ssi:34 en/other_coding-style.ssi:45
@@ -101,14 +102,15 @@ msgstr ""
#: 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:94
-#: en/user_basics.ssi:108 en/user_basics.ssi:116 en/user_basics.ssi:124
-#: en/user_basics.ssi:134 en/user_basics.ssi:148 en/user_basics.ssi:158
-#: en/user_basics.ssi:166 en/user_basics.ssi:174 en/user_basics.ssi:188
-#: en/user_basics.ssi:196 en/user_basics.ssi:206 en/user_basics.ssi:247
-#: en/user_basics.ssi:275 en/user_basics.ssi:283 en/user_basics.ssi:310
-#: en/user_basics.ssi:349 en/user_customization-contents.ssi:39
+#: en/other_use-cases.ssi:137 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
@@ -126,11 +128,12 @@ msgstr ""
#: 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:109 en/user_installation.ssi:124
-#: en/user_installation.ssi:139 en/user_managing_a_configuration.ssi:31
+#: 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:98
-#: en/user_overview.ssi:108 en/user_overview.ssi:116
+#: 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 ""
@@ -141,7 +144,7 @@ msgstr ""
#. type: Plain text
#: en/user_managing_a_configuration.ssi:4
-msgid "1~ Managing a configuration"
+msgid "1~managing-a-configuration Managing a configuration"
msgstr ""
#. type: Plain text
diff --git a/manual/pot/user_overview.ssi.pot b/manual/pot/user_overview.ssi.pot
index 73e3e78..2a2bb48 100644
--- a/manual/pot/user_overview.ssi.pot
+++ b/manual/pot/user_overview.ssi.pot
@@ -7,7 +7,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-28 07:47-0200\n"
+"POT-Creation-Date: 2010-10-28 16:34-0200\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"
@@ -72,8 +72,8 @@ msgstr ""
#: 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 ""
@@ -132,8 +132,8 @@ msgstr ""
#: 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 ""
@@ -211,88 +211,37 @@ msgstr ""
#. type: Plain text
#: en/user_overview.ssi:22
msgid ""
-"Besides the common config/common, which is used by all live-build commands, "
-"some additional files can be used to configure the behavior of specific "
-"helper commands. These files are typically named config/command or config/"
-"stage (where \"stage\", of course, is replaced with the name of the stage "
-"that they belong to, and \"command\" with the name of the command)."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:24
-msgid ""
-"For example, the #{lb_bootstrap_debootstrap}# command uses files named "
-"config/bootstrap and config/bootstrap_debootstrap to read the options it "
-"will use. Generally, these files contain variables with values assigned, one "
-"variable per line. Some commands of live-buil use pairs of values or "
-"slightly more complicated variable assignments."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:26
-msgid ""
-"live-build respects environment variables which are present in the context "
-"of the shell it is running. If variables can be read from config files, then "
-"they override environment variables, and if command line options are used, "
-"they override values from config files. If no value for a given variable can "
-"be found (and is thus unset), live-build will automatically set it to a "
-"default value."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:28
-msgid ""
-"All config files are shell scripts which are sourced by a live-build "
-"command. That means they have to follow the normal shell syntax. You can "
-"also put comments in these files; lines beginning with \"#\" are ignored."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:30
-msgid ""
-"In some rare cases you may want to have different versions of these files "
-"for different architectures or distributions. If files named config/stage."
-"arch or config/stage_command.arch, and config/stage.dist or config/"
-"stage_command.dist exist (where \"arch\" is the same as the output of dpkg --"
-"print-architecture and \"dist\" is the same as the codename of the target "
-"distribution), then they will be used in preference to the other, more "
-"general files."
-msgstr ""
-
-#. type: Plain text
-#: en/user_overview.ssi:32
-msgid ""
"The remainder of this section discusses the three most important commands:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:34
+#: en/user_overview.ssi:24
msgid ""
"_* *{lb config}*: Responsible for initializing a Live system configuration "
"directory. See {The lb config command}#lb-config for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:36
+#: en/user_overview.ssi:26
msgid ""
"_* *{lb build}*: Responsible for starting a Live system build. See {The lb "
"build command}#lb-build for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:38
+#: en/user_overview.ssi:28
msgid ""
"_* *{lb clean}*: Responsible for removing parts of a Live system build. See "
"{The lb clean command}#lb-clean for more information."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:40
+#: en/user_overview.ssi:30
msgid "3~lb-config The #{lb config}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:42
+#: en/user_overview.ssi:32
msgid ""
"As discussed in {live-build}#live-build, the scripts that make up live-build "
"source their configuration from a single directory named config/. As "
@@ -302,26 +251,26 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:44
+#: en/user_overview.ssi:34
msgid ""
"Issuing #{lb config}# without any arguments creates a config subdirectory "
"which it populates with some default settings:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:49
+#: en/user_overview.ssi:39
msgid "$ lb config P: Creating config tree"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:54
+#: en/user_overview.ssi:44
msgid ""
"$ ls -l total 8 drwxr-xr-x 3 user user 4096 Sep 7 13:02 auto drwxr-xr-x 22 "
"user user 4096 Sep 7 13:02 config"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:82
+#: en/user_overview.ssi:72
msgid ""
"$ ls -l config/ total 104 -rw-r--r-- 1 user user 4197 Sep 7 13:02 binary "
"drwxr-xr-x 2 user user 4096 Sep 7 13:02 binary_debian-installer drwxr-xr-x 2 "
@@ -346,54 +295,50 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:86
+#: en/user_overview.ssi:76
msgid ""
"Using #{lb config}# without any arguments would be suitable for users who "
-"are either happy editing the generated files, or are simply happy with the "
-"defaults it creates."
+"need a very basic image, or who intend to later provide a more complete "
+"configuration via auto/config (see {Managing a configuration}#managing-a-"
+"configuration for details)."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:88
+#: en/user_overview.ssi:78
msgid ""
-"You can ask #{lb config}# to generate a config/ directory \"preseeded\" with "
-"various options. This might be suitable if you do not require the default "
-"settings but do not need to change a large number of options. For example:"
+"Normally, you will want to specify some options. For example, to include the "
+"'gnome' package list in your configuration:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:92
+#: en/user_overview.ssi:82
msgid "$ lb config -p gnome"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:96
-msgid ""
-"will build a config/ directory configured to include the 'gnome' package "
-"list. It is possible to specify many options:"
+#: en/user_overview.ssi:86
+msgid "It is possible to specify many options, such as:"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:100
+#: en/user_overview.ssi:90
msgid ""
"$ lb config --binary-images net --hostname live-machine --username live-"
"user ..."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:104
-msgid ""
-"A full list of options is available in the #{lb_config}# man page. Most "
-"options have a parallel with an \"LB_\" prefixed variable."
+#: en/user_overview.ssi:94
+msgid "A full list of options is available in the #{lb_config}# man page."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:106
+#: en/user_overview.ssi:96
msgid "3~lb-build The #{lb build}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:108
+#: en/user_overview.ssi:98
msgid ""
"The #{lb build}# command reads in your configuration from the config/ "
"directory. It then runs the lower lower level commands needed to build your "
@@ -401,24 +346,24 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:110
+#: en/user_overview.ssi:100
msgid "3~lb-clean The #{lb clean}# command"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:112
+#: en/user_overview.ssi:102
msgid ""
"It is the job of the #{lb clean}# command to remove various parts of a build "
"so subsequent builds can start from a clean state."
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:114
+#: en/user_overview.ssi:104
msgid "2~live-boot The live-boot package"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:116
+#: en/user_overview.ssi:106
msgid ""
"live-boot is a collection of scripts providing hooks for the initramfs-"
"tools, used to generate an initramfs capable of booting live systems, such "
@@ -427,7 +372,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:118
+#: en/user_overview.ssi:108
msgid ""
"At boot time it will look for read-only media containing a \"/live\" "
"directory where a root filesystem (often a compressed filesystem image like "
@@ -436,7 +381,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:120
+#: en/user_overview.ssi:110
msgid ""
"More information on initial ramfs in Debian can be found in the Debian Linux "
"Kernel Handbook at http://kernel-handbook.alioth.debian.org/ in the chapter "
@@ -444,12 +389,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:122
+#: en/user_overview.ssi:112
msgid "2~live-config The live-config package"
msgstr ""
#. type: Plain text
-#: en/user_overview.ssi:124
+#: en/user_overview.ssi:114
msgid ""
"live-config consists of the scripts that run at boot time after live-boot to "
"configure the live system automatically. It handles such tasks as setting "
diff --git a/manual/pt_BR/user_managing_a_configuration.ssi b/manual/pt_BR/user_managing_a_configuration.ssi
index 3047ef0..bc03008 100644
--- a/manual/pt_BR/user_managing_a_configuration.ssi
+++ b/manual/pt_BR/user_managing_a_configuration.ssi
@@ -1,6 +1,6 @@
:B~ Managing a configuration
-1~ Managing a configuration
+1~managing-a-configuration Managing a configuration
This chapter explains how to manage a live configuration from initial
creation, through successive revisions and successive releases of both the
diff --git a/manual/pt_BR/user_overview.ssi b/manual/pt_BR/user_overview.ssi
index e9df877..cf9f187 100644
--- a/manual/pt_BR/user_overview.ssi
+++ b/manual/pt_BR/user_overview.ssi
@@ -32,37 +32,6 @@ configuration directory, #{lb config}#. This could be considered to be
similar to tools such as #{dh-make}#. For more information about #{lb
config}#, please see {The lb config command}#lb-config.
-Besides the common config/common, which is used by all live-build commands,
-some additional files can be used to configure the behavior of specific
-helper commands. These files are typically named config/command or
-config/stage (where "stage", of course, is replaced with the name of the
-stage that they belong to, and "command" with the name of the command).
-
-For example, the #{lb_bootstrap_debootstrap}# command uses files named
-config/bootstrap and config/bootstrap_debootstrap to read the options it
-will use. Generally, these files contain variables with values assigned, one
-variable per line. Some commands of live-buil use pairs of values or
-slightly more complicated variable assignments.
-
-live-build respects environment variables which are present in the context
-of the shell it is running. If variables can be read from config files, then
-they override environment variables, and if command line options are used,
-they override values from config files. If no value for a given variable can
-be found (and is thus unset), live-build will automatically set it to a
-default value.
-
-All config files are shell scripts which are sourced by a live-build
-command. That means they have to follow the normal shell syntax. You can
-also put comments in these files; lines beginning with "#" are ignored.
-
-In some rare cases you may want to have different versions of these files
-for different architectures or distributions. If files named
-config/stage.arch or config/stage_command.arch, and config/stage.dist or
-config/stage_command.dist exist (where "arch" is the same as the output of
-dpkg --print-architecture and "dist" is the same as the codename of the
-target distribution), then they will be used in preference to the other,
-more general files.
-
The remainder of this section discusses the three most important commands:
_* *{lb config}*: Responsible for initializing a Live system configuration
@@ -117,12 +86,12 @@ drwxr-xr-x 2 user user 4096 Sep 7 13:02 templates
}code
Using #{lb config}# without any arguments would be suitable for users who
-are either happy editing the generated files, or are simply happy with the
-defaults it creates.
+need a very basic image, or who intend to later provide a more complete
+configuration via auto/config (see {Managing a
+configuration}#managing-a-configuration for details).
-You can ask #{lb config}# to generate a config/ directory "preseeded" with
-various options. This might be suitable if you do not require the default
-settings but do not need to change a large number of options. For example:
+Normally, you will want to specify some options. For example, to include the
+'gnome' package list in your configuration:
code{
@@ -130,8 +99,7 @@ $ lb config -p gnome
}code
-will build a config/ directory configured to include the 'gnome' package
-list. It is possible to specify many options:
+It is possible to specify many options, such as:
code{
@@ -140,8 +108,7 @@ $ lb config --binary-images net --hostname live-machine --username live-user
}code
-A full list of options is available in the #{lb_config}# man page. Most
-options have a parallel with an "LB_" prefixed variable.
+A full list of options is available in the #{lb_config}# man page.
3~lb-build The #{lb build}# command
diff --git a/manual/ro/user_managing_a_configuration.ssi b/manual/ro/user_managing_a_configuration.ssi
index 3047ef0..bc03008 100644
--- a/manual/ro/user_managing_a_configuration.ssi
+++ b/manual/ro/user_managing_a_configuration.ssi
@@ -1,6 +1,6 @@
:B~ Managing a configuration
-1~ Managing a configuration
+1~managing-a-configuration Managing a configuration
This chapter explains how to manage a live configuration from initial
creation, through successive revisions and successive releases of both the
diff --git a/manual/ro/user_overview.ssi b/manual/ro/user_overview.ssi
index e9df877..cf9f187 100644
--- a/manual/ro/user_overview.ssi
+++ b/manual/ro/user_overview.ssi
@@ -32,37 +32,6 @@ configuration directory, #{lb config}#. This could be considered to be
similar to tools such as #{dh-make}#. For more information about #{lb
config}#, please see {The lb config command}#lb-config.
-Besides the common config/common, which is used by all live-build commands,
-some additional files can be used to configure the behavior of specific
-helper commands. These files are typically named config/command or
-config/stage (where "stage", of course, is replaced with the name of the
-stage that they belong to, and "command" with the name of the command).
-
-For example, the #{lb_bootstrap_debootstrap}# command uses files named
-config/bootstrap and config/bootstrap_debootstrap to read the options it
-will use. Generally, these files contain variables with values assigned, one
-variable per line. Some commands of live-buil use pairs of values or
-slightly more complicated variable assignments.
-
-live-build respects environment variables which are present in the context
-of the shell it is running. If variables can be read from config files, then
-they override environment variables, and if command line options are used,
-they override values from config files. If no value for a given variable can
-be found (and is thus unset), live-build will automatically set it to a
-default value.
-
-All config files are shell scripts which are sourced by a live-build
-command. That means they have to follow the normal shell syntax. You can
-also put comments in these files; lines beginning with "#" are ignored.
-
-In some rare cases you may want to have different versions of these files
-for different architectures or distributions. If files named
-config/stage.arch or config/stage_command.arch, and config/stage.dist or
-config/stage_command.dist exist (where "arch" is the same as the output of
-dpkg --print-architecture and "dist" is the same as the codename of the
-target distribution), then they will be used in preference to the other,
-more general files.
-
The remainder of this section discusses the three most important commands:
_* *{lb config}*: Responsible for initializing a Live system configuration
@@ -117,12 +86,12 @@ drwxr-xr-x 2 user user 4096 Sep 7 13:02 templates
}code
Using #{lb config}# without any arguments would be suitable for users who
-are either happy editing the generated files, or are simply happy with the
-defaults it creates.
+need a very basic image, or who intend to later provide a more complete
+configuration via auto/config (see {Managing a
+configuration}#managing-a-configuration for details).
-You can ask #{lb config}# to generate a config/ directory "preseeded" with
-various options. This might be suitable if you do not require the default
-settings but do not need to change a large number of options. For example:
+Normally, you will want to specify some options. For example, to include the
+'gnome' package list in your configuration:
code{
@@ -130,8 +99,7 @@ $ lb config -p gnome
}code
-will build a config/ directory configured to include the 'gnome' package
-list. It is possible to specify many options:
+It is possible to specify many options, such as:
code{
@@ -140,8 +108,7 @@ $ lb config --binary-images net --hostname live-machine --username live-user
}code
-A full list of options is available in the #{lb_config}# man page. Most
-options have a parallel with an "LB_" prefixed variable.
+A full list of options is available in the #{lb_config}# man page.
3~lb-build The #{lb build}# command
--
live-manual
More information about the debian-live-changes
mailing list