[SCM] live-manual branch, debian, updated. debian/2.0_a8-1-7-gdfa0455
M. Schneider
ms at it-infrastrukturen.org
Wed Oct 13 15:13:10 UTC 2010
The following commit has been merged in the debian branch:
commit 90203b8d5de74f380c857d5f4603c4125712c09a
Author: M. Schneider <ms at it-infrastrukturen.org>
Date: Wed Oct 13 17:02:00 2010 +0200
Adding a shosrt description for Binary local packages lists.
diff --git a/manual/de/live-manual.ssm b/manual/de/live-manual.ssm
index 9f7cd85..6785c63 100644
--- a/manual/de/live-manual.ssm
+++ b/manual/de/live-manual.ssm
@@ -9,7 +9,7 @@
:license: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.<br><br>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.<br><br>You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/. <br><br>On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3 file.
@date:
- :published: 2010-10-03
+ :published: 2010-10-13
@publisher: Debian Live Project <debian-live at lists.debian.org>
@@ -35,6 +35,8 @@
<< user_overview.ssi
+<< user_managing_a_configuration.ssi
+
<< user_customization-packages.ssi
<< user_customization-contents.ssi
diff --git a/manual/de/user_customization-packages.ssi b/manual/de/user_customization-packages.ssi
index b848d7f..287a53f 100644
--- a/manual/de/user_customization-packages.ssi
+++ b/manual/de/user_customization-packages.ssi
@@ -174,6 +174,17 @@ in order to be processed. Local packages lists always override package lists
distributed with live-build. This can cause undesired effects, we therefore
recommend to use unique names for local packages lists.
+*{Local binary packages lists}*
+
+In case you want to include some required .deb packages to live media´s
+pool/ (without installing them onto the live image) you may need to use
+lists using binary local package lists stored in
+config/binary_local-packageslists. Such media can be used as a customized
+debian install image for offline installations.
+
+Package lists that exist in this directory need to have a .list suffix in
+order to be processed.
+
*{Extending a provided package list using includes}*
% FIXME
diff --git a/manual/de/user_managing_a_configuration.ssi b/manual/de/user_managing_a_configuration.ssi
new file mode 100644
index 0000000..3047ef0
--- /dev/null
+++ b/manual/de/user_managing_a_configuration.ssi
@@ -0,0 +1,83 @@
+:B~ Managing a configuration
+
+1~ 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.
+
+2~ Use auto to manage configuration changes
+
+Live configurations rarely are perfect on the first try. You'll likely need
+to make a series of revisions until you are satisfied. However,
+inconsistencies can creep into your configuration from one revision to the
+next if you aren't careful. The main problem is, once a variable is given a
+default value, that value will not be recomputed from other variables that
+may change in later revisions.
+
+For example, when the distribution is first set, many 'dependent' variables
+are given default values that suit that distribution. However, if you later
+decide to change the distribution, those dependent variables continue to
+retain old values that are no longer appropriate.
+
+A second, related problem is that if you run #{lb config}# and then upgrade
+to a new version of live-build that has changed one of the variable names,
+you will discover this only by manual review of the variables in your config
+files, which you will then need to use to set the appropriate option again.
+
+All of this would be a terrible nuisance if it weren't for auto/* scripts,
+simple wrappers to the #{lb config}#, #{lb build}# and #{lb clean}# commands
+that are designed to help you manage your configuration. Simply create an
+auto/config script containing #{lb config}# command with all desired
+options, and an auto/clean that removes the files containing configuration
+variable values, and each time you #{lb config}# and #{lb clean}#, these
+files will be executed. This will ensure that your configuration is kept
+internally consistent from one revision to the next and from one live-build
+release to the next (though you will still have to take care and read the
+documentation when you upgrade live-build and make adjustments as needed).
+
+2~ Example auto scripts
+
+Use the following auto script examples as the starting point for your new
+live-build configuration. Take note that when you call the #{lb}# command
+that the auto script wraps, you must specify #{noauto}# as its parameter to
+ensure that the auto script isn't called again, recursively.
+
+auto/config
+
+code{
+
+#!/bin/sh
+lb config noauto \
+ --architecture i386 \
+ ${@}
+
+}code
+
+auto/clean
+
+code{
+
+#!/bin/sh
+lb clean noauto ${@}
+rm -f config/binary config/bootstrap \
+ config/chroot config/common config/source
+rm -f binary.log
+
+}code
+
+auto/build
+
+code{
+
+#!/bin/sh lb build noauto ${@} 2>&1 | tee binary.log
+
+}code
+
+Edit auto/config, changing or adding any options as you see fit. In the
+example above, --architecture is set to i386 so that when the image is built
+on an amd64 system, it will not default to building amd64 images. Change
+this to an appropriate value for your image (or delete it if you want to use
+the default) and add any additional options in continuation lines that
+follow.
+
diff --git a/manual/en/live-manual.ssm b/manual/en/live-manual.ssm
index 110dc10..890d047 100644
--- a/manual/en/live-manual.ssm
+++ b/manual/en/live-manual.ssm
@@ -9,7 +9,7 @@
:license: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.<br><br>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.<br><br>You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/. <br><br>On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3 file.
@date:
- :published: 2010-10-03
+ :published: 2010-10-13
@publisher: Debian Live Project <debian-live at lists.debian.org>
diff --git a/manual/en/user_customization-packages.ssi b/manual/en/user_customization-packages.ssi
index a94ac0f..98bfc2c 100644
--- a/manual/en/user_customization-packages.ssi
+++ b/manual/en/user_customization-packages.ssi
@@ -141,6 +141,12 @@ You may supplement the supplied lists using local package lists stored in #{conf
Package lists that exist in this directory need to have a #{.list}# suffix in order to be processed. Local packages lists always override package lists distributed with live-build. This can cause undesired effects, we therefore recommend to use unique names for local packages lists.
+*{Local binary packages lists}*
+
+In case you want to include some required .deb packages to live media´s pool/ (without installing them onto the live image) you may need to use lists using binary local package lists stored in config/binary_local-packageslists. Such media can be used as a customized debian install image for offline installations.
+
+Package lists that exist in this directory need to have a .list suffix in order to be processed.
+
*{Extending a provided package list using includes}*
% FIXME
diff --git a/manual/po/de/live-manual.ssm.po b/manual/po/de/live-manual.ssm.po
index 04207a4..fa2c3e7 100644
--- a/manual/po/de/live-manual.ssm.po
+++ b/manual/po/de/live-manual.ssm.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-03 21:43+0300\n"
+"POT-Creation-Date: 2010-10-13 17:00+0300\n"
"PO-Revision-Date: 2010-10-03 20:30+0300\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -45,7 +45,7 @@ msgstr ""
#, no-wrap
msgid ""
"@date:\n"
-" :published: 2010-10-03\n"
+" :published: 2010-10-13\n"
msgstr ""
#. type: Plain text
@@ -106,110 +106,115 @@ msgstr ""
#. type: Plain text
#: en/live-manual.ssm:39
-msgid "<< user_customization-packages.ssi"
+msgid "<< user_managing_a_configuration.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:41
-msgid "<< user_customization-contents.ssi"
+msgid "<< user_customization-packages.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:43
-msgid "<< user_customization-internationalization.ssi"
+msgid "<< user_customization-contents.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:45
-msgid ":B~ Development ~#"
+msgid "<< user_customization-internationalization.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:47
-msgid ":B~ Project ~#"
+msgid ":B~ Development ~#"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:49
-msgid ":B~ Other ~#"
+msgid ":B~ Project ~#"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:51
-msgid "<< other_customization-bootup.ssi"
+msgid ":B~ Other ~#"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:53
-msgid "<< other_customization-binary.ssi"
+msgid "<< other_customization-bootup.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:55
-msgid "<< other_customization-backports.ssi"
+msgid "<< other_customization-binary.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:57
-msgid "<< other_common-tasks.ssi"
+msgid "<< other_customization-backports.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:59
-msgid "<< other_live-environment.ssi"
+msgid "<< other_common-tasks.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:61
-msgid "<< other_faq.ssi"
+msgid "<< other_live-environment.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:63
-msgid "<< other_reporting-bugs.ssi"
+msgid "<< other_faq.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:65
-msgid "<< other_howtos.ssi"
+msgid "<< other_reporting-bugs.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:67
-msgid "<< other_coding-style.ssi"
+msgid "<< other_howtos.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:69
-msgid "<< other_procedures.ssi"
+msgid "<< other_coding-style.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:71
-msgid "<< other_resources.ssi"
+msgid "<< other_procedures.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:73
-msgid "<< other_use-cases.ssi"
+msgid "<< other_resources.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:75
-msgid "<< other_success-stories.ssi"
+msgid "<< other_use-cases.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:77
-msgid "<< other_troubleshooting.ssi"
+msgid "<< other_success-stories.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:79
+msgid "<< other_troubleshooting.ssi"
+msgstr ""
+
+#. type: Plain text
+#: en/live-manual.ssm:81
msgid "<< other_configuration-layout.ssi"
msgstr ""
#. type: Plain text
-#: en/live-manual.ssm:80
+#: en/live-manual.ssm:82
msgid "<< other_configuration-files.ssi"
msgstr ""
diff --git a/manual/po/de/user_customization-internationalization.ssi.po b/manual/po/de/user_customization-internationalization.ssi.po
index 2758b3a..1bfcf27 100644
--- a/manual/po/de/user_customization-internationalization.ssi.po
+++ b/manual/po/de/user_customization-internationalization.ssi.po
@@ -12,7 +12,7 @@ msgstr ""
"Language-Team: none\n"
"Language: de\n"
"MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=ASCII\n"
+"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
diff --git a/manual/po/de/user_customization-packages.ssi.po b/manual/po/de/user_customization-packages.ssi.po
index e2d0159..ee54e40 100644
--- a/manual/po/de/user_customization-packages.ssi.po
+++ b/manual/po/de/user_customization-packages.ssi.po
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-03 20:30+0300\n"
+"POT-Creation-Date: 2010-10-13 17:00+0300\n"
"PO-Revision-Date: 2010-10-03 20:30+0300\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -26,51 +26,53 @@ msgstr ""
#: en/other_coding-style.ssi:106 en/other_coding-style.ssi:117
#: en/other_common-tasks.ssi:32 en/other_customization-backports.ssi:8
#: en/other_customization-bootup.ssi:30 en/other_customization-bootup.ssi:39
-#: en/other_customization-internationalization.ssi:10
-#: en/other_customization-internationalization.ssi:18
-#: en/other_customization-internationalization.ssi:26
-#: en/other_customization-internationalization.ssi:34
-#: en/other_customization-internationalization.ssi:46 en/other_faq.ssi:41
-#: en/other_faq.ssi:83 en/other_faq.ssi:103 en/other_faq.ssi:117
-#: en/other_faq.ssi:137 en/other_faq.ssi:151 en/other_faq.ssi:198
-#: en/other_faq.ssi:245 en/other_faq.ssi:261 en/other_faq.ssi:287
-#: en/other_faq.ssi:299 en/other_faq.ssi:314 en/other_faq.ssi:333
-#: en/other_faq.ssi:345 en/other_faq.ssi:353 en/other_faq.ssi:364
-#: en/other_faq.ssi:374 en/other_howtos.ssi:16 en/other_howtos.ssi:43
-#: en/other_live-environment.ssi:14 en/other_live-environment.ssi:30
-#: en/other_live-environment.ssi:51 en/other_live-environment.ssi:61
-#: en/other_live-environment.ssi:69 en/other_live-environment.ssi:77
-#: en/other_live-environment.ssi:85 en/other_live-environment.ssi:93
-#: en/other_live-environment.ssi:116 en/other_live-environment.ssi:124
-#: en/other_live-environment.ssi:133 en/other_procedures.ssi:12
-#: en/other_procedures.ssi:46 en/other_procedures.ssi:58
-#: en/other_use-cases.ssi:24 en/other_use-cases.ssi:49
-#: en/other_use-cases.ssi:75 en/other_use-cases.ssi:103
-#: en/other_use-cases.ssi:111 en/user_basics.ssi: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_faq.ssi:41 en/other_faq.ssi:83 en/other_faq.ssi:103
+#: en/other_faq.ssi:117 en/other_faq.ssi:137 en/other_faq.ssi:151
+#: en/other_faq.ssi:198 en/other_faq.ssi:245 en/other_faq.ssi:261
+#: en/other_faq.ssi:287 en/other_faq.ssi:299 en/other_faq.ssi:314
+#: en/other_faq.ssi:333 en/other_faq.ssi:345 en/other_faq.ssi:353
+#: en/other_faq.ssi:364 en/other_faq.ssi:374 en/other_howtos.ssi:16
+#: en/other_howtos.ssi:43 en/other_live-environment.ssi:14
+#: en/other_live-environment.ssi:30 en/other_live-environment.ssi:51
+#: en/other_live-environment.ssi:61 en/other_live-environment.ssi:69
+#: en/other_live-environment.ssi:77 en/other_live-environment.ssi:85
+#: en/other_live-environment.ssi:93 en/other_live-environment.ssi:116
+#: en/other_live-environment.ssi:124 en/other_live-environment.ssi:133
+#: en/other_procedures.ssi:12 en/other_procedures.ssi:46
+#: en/other_procedures.ssi:58 en/other_use-cases.ssi:24
+#: en/other_use-cases.ssi:49 en/other_use-cases.ssi:75
+#: en/other_use-cases.ssi:103 en/other_use-cases.ssi:111 en/user_basics.ssi: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/user_customization-contents.ssi:34 en/user_customization-contents.ssi:43
-#: en/user_customization-contents.ssi:66 en/user_customization-packages.ssi:16
-#: en/user_customization-packages.ssi:24 en/user_customization-packages.ssi:36
-#: en/user_customization-packages.ssi:45 en/user_customization-packages.ssi:59
-#: en/user_customization-packages.ssi:73
+#: en/user_customization-contents.ssi:66
+#: en/user_customization-internationalization.ssi:10
+#: en/user_customization-internationalization.ssi:18
+#: en/user_customization-internationalization.ssi:26
+#: en/user_customization-internationalization.ssi:38
+#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:24
+#: en/user_customization-packages.ssi:36 en/user_customization-packages.ssi:45
+#: en/user_customization-packages.ssi:59 en/user_customization-packages.ssi:73
#: en/user_customization-packages.ssi:103
#: en/user_customization-packages.ssi:111
#: en/user_customization-packages.ssi:131
-#: en/user_customization-packages.ssi:160
-#: en/user_customization-packages.ssi:170
-#: en/user_customization-packages.ssi:180
-#: en/user_customization-packages.ssi:190 en/user_installation.ssi:38
+#: en/user_customization-packages.ssi:166
+#: en/user_customization-packages.ssi:176
+#: en/user_customization-packages.ssi:186
+#: en/user_customization-packages.ssi:196 en/user_installation.ssi:38
#: en/user_installation.ssi:46 en/user_installation.ssi:56
#: en/user_installation.ssi:64 en/user_installation.ssi:76
#: en/user_installation.ssi:84 en/user_installation.ssi:105
#: en/user_installation.ssi:119 en/user_installation.ssi:136
-#: en/user_overview.ssi:60 en/user_overview.ssi:104 en/user_overview.ssi:112
+#: 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
msgid "code{"
msgstr ""
@@ -84,17 +86,12 @@ msgstr ""
#: en/other_coding-style.ssi:113 en/other_coding-style.ssi:124
#: en/other_common-tasks.ssi:36 en/other_customization-backports.ssi:16
#: en/other_customization-bootup.ssi:35 en/other_customization-bootup.ssi:48
-#: en/other_customization-internationalization.ssi:14
-#: en/other_customization-internationalization.ssi:22
-#: en/other_customization-internationalization.ssi:30
-#: en/other_customization-internationalization.ssi:38
-#: en/other_customization-internationalization.ssi:50 en/other_faq.ssi:37
-#: en/other_faq.ssi:46 en/other_faq.ssi:92 en/other_faq.ssi:108
-#: en/other_faq.ssi:141 en/other_faq.ssi:155 en/other_faq.ssi:207
-#: en/other_faq.ssi:256 en/other_faq.ssi:292 en/other_faq.ssi:307
-#: en/other_faq.ssi:319 en/other_faq.ssi:337 en/other_faq.ssi:349
-#: en/other_faq.ssi:358 en/other_faq.ssi:370 en/other_faq.ssi:381
-#: en/other_howtos.ssi:20 en/other_howtos.ssi:47
+#: en/other_faq.ssi:37 en/other_faq.ssi:46 en/other_faq.ssi:92
+#: en/other_faq.ssi:108 en/other_faq.ssi:141 en/other_faq.ssi:155
+#: en/other_faq.ssi:207 en/other_faq.ssi:256 en/other_faq.ssi:292
+#: en/other_faq.ssi:307 en/other_faq.ssi:319 en/other_faq.ssi:337
+#: en/other_faq.ssi:349 en/other_faq.ssi:358 en/other_faq.ssi:370
+#: en/other_faq.ssi:381 en/other_howtos.ssi:20 en/other_howtos.ssi:47
#: en/other_live-environment.ssi:18 en/other_live-environment.ssi:34
#: en/other_live-environment.ssi:55 en/other_live-environment.ssi:65
#: en/other_live-environment.ssi:73 en/other_live-environment.ssi:81
@@ -113,26 +110,32 @@ msgstr ""
#: 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/user_customization-contents.ssi:54 en/user_customization-contents.ssi:70
+#: en/user_customization-internationalization.ssi:14
+#: en/user_customization-internationalization.ssi:22
+#: en/user_customization-internationalization.ssi:30
+#: en/user_customization-internationalization.ssi:42
#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:28
#: en/user_customization-packages.ssi:41 en/user_customization-packages.ssi:49
#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
#: en/user_customization-packages.ssi:107
#: en/user_customization-packages.ssi:115
#: en/user_customization-packages.ssi:135
-#: en/user_customization-packages.ssi:166
-#: en/user_customization-packages.ssi:176
-#: en/user_customization-packages.ssi:186
-#: en/user_customization-packages.ssi:196 en/user_installation.ssi:42
+#: en/user_customization-packages.ssi:172
+#: en/user_customization-packages.ssi:182
+#: en/user_customization-packages.ssi:192
+#: en/user_customization-packages.ssi:202 en/user_installation.ssi:42
#: en/user_installation.ssi:50 en/user_installation.ssi:60
#: en/user_installation.ssi:72 en/user_installation.ssi:80
#: en/user_installation.ssi:109 en/user_installation.ssi:124
-#: en/user_installation.ssi:139 en/user_overview.ssi:98
+#: en/user_installation.ssi:139 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
msgid "}code"
msgstr ""
#. type: Plain text
-#: en/user_basics.ssi:220 en/user_customization-packages.ssi:147
+#: en/user_basics.ssi:220 en/user_customization-packages.ssi:153
msgid "% FIXME"
msgstr ""
@@ -461,16 +464,39 @@ msgstr ""
#. type: Plain text
#: en/user_customization-packages.ssi:145
#, no-wrap
+msgid "*{Local binary packages lists}*\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:147
+msgid ""
+"In case you want to include some required .deb packages to live medias pool/ "
+"(without installing them onto the live image) you may need to use lists "
+"using binary local package lists stored in config/binary_local-"
+"packageslists. Such media can be used as a customized debian install image "
+"for offline installations."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:149
+msgid ""
+"Package lists that exist in this directory need to have a .list suffix in "
+"order to be processed."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:151
+#, no-wrap
msgid "*{Extending a provided package list using includes}*\n"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:154
+#: en/user_customization-packages.ssi:160
msgid "% code{ % % #include <gnome> % iceweasel % % }code"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:156
+#: en/user_customization-packages.ssi:162
msgid ""
"The package lists that are included with live-build make extensive use of "
"includes. They are available to view in the #{/usr/share/live/build/lists}# "
@@ -478,75 +504,75 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:158
+#: en/user_customization-packages.ssi:164
#, no-wrap
msgid "*{Using conditionals inside packages lists}*\n"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:164
+#: en/user_customization-packages.ssi:170
msgid "#if ARCHITECTURE amd64 ia32-libs #endif"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:168
+#: en/user_customization-packages.ssi:174
msgid "or if #{LB_ARCHITECTURE}# is set to #{i386}# or #{amd64}#:"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:174
+#: en/user_customization-packages.ssi:180
msgid "#if ARCHITECTURE i386 amd64 memtest86+ #endif"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:178
+#: en/user_customization-packages.ssi:184
msgid "or if #{LB_ARCHIVE_AREAS}# contains either #{contrib}# or #{non-free}#:"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:184
+#: en/user_customization-packages.ssi:190
msgid "#if ARCHIVE_AREAS contrib non-free vrms #endif"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:188
+#: en/user_customization-packages.ssi:194
msgid "A conditional may surround an #{#include}# directive:"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:194
+#: en/user_customization-packages.ssi:200
msgid "#if ARCHITECTURE amd64 #include <gnome-full> #endif"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:198
+#: en/user_customization-packages.ssi:204
msgid ""
"Any live-build configuration variable that begins with #{LB_}# can be tested "
"in this way."
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:200
+#: en/user_customization-packages.ssi:206
msgid "The nesting of conditionals is not supported."
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:202
+#: en/user_customization-packages.ssi:208
msgid "3~ Tasks"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:204
+#: en/user_customization-packages.ssi:210
msgid "%FIXME"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:206
+#: en/user_customization-packages.ssi:212
msgid "2~ Installing modified or third-party packages"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:208
+#: en/user_customization-packages.ssi:214
msgid ""
"Whilst it is against the philosophy of Debian Live, it may sometimes be "
"necessary to build a Live system with modified versions of packages that are "
@@ -557,7 +583,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:210
+#: en/user_customization-packages.ssi:216
msgid ""
"This section does not cover advice regarding building or maintaining "
"modified packages. Joachim Breitner's 'How to fork privately' method from "
@@ -568,22 +594,22 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:212
+#: en/user_customization-packages.ssi:218
msgid "There are two ways of installing modified custom packages:"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:214
+#: en/user_customization-packages.ssi:220
msgid "_* #{chroot_local-packages}#"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:216
+#: en/user_customization-packages.ssi:222
msgid "_* Using a custom APT repository"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:218
+#: en/user_customization-packages.ssi:224
msgid ""
"The #{chroot_local-packages}# is simpler to achieve and useful for \"one-off"
"\" customisations but has a number of drawbacks, whilst using a custom APT "
@@ -591,12 +617,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:220
+#: en/user_customization-packages.ssi:226
msgid "3~ Using #{chroot_local-packages}# to install custom packages"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:222
+#: en/user_customization-packages.ssi:228
msgid ""
"To install a custom package, simply copy it to the #{config/chroot_local-"
"packages}# directory. Packages that are inside this directory will be "
@@ -605,45 +631,45 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:224
+#: en/user_customization-packages.ssi:230
msgid ""
"Packages *{must}* be named in the prescribed way. One simple way to do this "
"is to use #{dpkg-name}#."
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:226
+#: en/user_customization-packages.ssi:232
msgid ""
"Using #{chroot_local-packages}# for installation of custom packages has "
"disadvantages:"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:228
+#: en/user_customization-packages.ssi:234
msgid "_* It is not possible to use secure APT"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:230
+#: en/user_customization-packages.ssi:236
msgid ""
"_* You must install all appropriate packages in the #{config/chroot_local-"
"packages}# directory"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:232
+#: en/user_customization-packages.ssi:238
msgid ""
"_* It does not lend itself to storing Debian Live configurations in revision "
"control"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:234
+#: en/user_customization-packages.ssi:240
msgid "3~ Using an APT repository to install custom packages"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:236
+#: en/user_customization-packages.ssi:242
msgid ""
"Unlike using #{chroot_local-packages}#, when using a custom APT repository "
"you must ensure that you specify the packages elsewhere. See lb-packages for "
@@ -651,12 +677,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:238
+#: en/user_customization-packages.ssi:244
msgid "% FIXME: <xref linkend=\"lb-packages\"/>"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:240
+#: en/user_customization-packages.ssi:246
msgid ""
"Whilst it may seem unnecessary effort to create an APT repository to install "
"custom packages, the infrastructure can be easily re-used at a later date to "
@@ -664,12 +690,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:242
+#: en/user_customization-packages.ssi:248
msgid "3~ Custom packages and APT"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:244
+#: en/user_customization-packages.ssi:250
msgid ""
"live-build uses APT to install all packages into the live system so will "
"therefore inherit behaviours from this program. One relevant example is that "
@@ -679,7 +705,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:246
+#: en/user_customization-packages.ssi:252
msgid ""
"Because of this, you may wish to increment the version number in your custom "
"packages' #{debian/changelog}# files to ensure that your modified version is "
@@ -689,17 +715,17 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:248
+#: en/user_customization-packages.ssi:254
msgid "% FIXME: <xref linkend=\"apt-preferences\"/>"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:250
+#: en/user_customization-packages.ssi:256
msgid "3~ Altering APT preferences during Live system"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:251
+#: en/user_customization-packages.ssi:257
msgid ""
"Whilst it may seem unnecessary effort to create an APT repository to install "
"custom packages, the infrastructure can be easily re-used at a later date to "
diff --git a/manual/po/de/user_customization-internationalization.ssi.po b/manual/po/de/user_managing_a_configuration.ssi.po
similarity index 61%
copy from manual/po/de/user_customization-internationalization.ssi.po
copy to manual/po/de/user_managing_a_configuration.ssi.po
index 2758b3a..da9c965 100644
--- a/manual/po/de/user_customization-internationalization.ssi.po
+++ b/manual/po/de/user_managing_a_configuration.ssi.po
@@ -6,8 +6,8 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-03 21:43+0300\n"
-"PO-Revision-Date: 2010-10-03 21:43+0300\n"
+"POT-Creation-Date: 2010-10-13 17:00+0300\n"
+"PO-Revision-Date: 2010-10-13 17:00+0300\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
"Language: de\n"
@@ -61,15 +61,18 @@ msgstr ""
#: en/user_customization-packages.ssi:103
#: en/user_customization-packages.ssi:111
#: en/user_customization-packages.ssi:131
-#: en/user_customization-packages.ssi:160
-#: en/user_customization-packages.ssi:170
-#: en/user_customization-packages.ssi:180
-#: en/user_customization-packages.ssi:190 en/user_installation.ssi:38
+#: en/user_customization-packages.ssi:166
+#: en/user_customization-packages.ssi:176
+#: en/user_customization-packages.ssi:186
+#: en/user_customization-packages.ssi:196 en/user_installation.ssi:38
#: en/user_installation.ssi:46 en/user_installation.ssi:56
#: en/user_installation.ssi:64 en/user_installation.ssi:76
#: en/user_installation.ssi:84 en/user_installation.ssi:105
#: en/user_installation.ssi:119 en/user_installation.ssi:136
-#: en/user_overview.ssi:60 en/user_overview.ssi:104 en/user_overview.ssi:112
+#: 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
msgid "code{"
msgstr ""
@@ -117,95 +120,149 @@ msgstr ""
#: en/user_customization-packages.ssi:107
#: en/user_customization-packages.ssi:115
#: en/user_customization-packages.ssi:135
-#: en/user_customization-packages.ssi:166
-#: en/user_customization-packages.ssi:176
-#: en/user_customization-packages.ssi:186
-#: en/user_customization-packages.ssi:196 en/user_installation.ssi:42
+#: en/user_customization-packages.ssi:172
+#: en/user_customization-packages.ssi:182
+#: en/user_customization-packages.ssi:192
+#: en/user_customization-packages.ssi:202 en/user_installation.ssi:42
#: en/user_installation.ssi:50 en/user_installation.ssi:60
#: en/user_installation.ssi:72 en/user_installation.ssi:80
#: en/user_installation.ssi:109 en/user_installation.ssi:124
-#: en/user_installation.ssi:139 en/user_overview.ssi:98
+#: en/user_installation.ssi:139 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
msgid "}code"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:2
-msgid "B~ Customising Locale And Language"
+#: en/user_managing_a_configuration.ssi:2
+msgid ":B~ Managing a configuration"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:4
-msgid "1~ Customising Locale And Language"
+#: en/user_managing_a_configuration.ssi:4
+msgid "1~ Managing a configuration"
+msgstr ""
+
+#. type: Plain text
+#: en/user_managing_a_configuration.ssi:6
+msgid ""
+"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."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:6
-msgid "2~ Default locale and keyboard"
+#: en/user_managing_a_configuration.ssi:8
+msgid "2~ Use auto to manage configuration changes"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:8
+#: en/user_managing_a_configuration.ssi:10
msgid ""
-"The default locale when building a live cd is \"locales=en_US.UTF-8\", to "
-"set the locale for e.g. Switzerland, you can use \"locales=de_CH.UTF-8\"."
+"Live configurations rarely are perfect on the first try. You'll likely need "
+"to make a series of revisions until you are satisfied. However, "
+"inconsistencies can creep into your configuration from one revision to the "
+"next if you aren't careful. The main problem is, once a variable is given a "
+"default value, that value will not be recomputed from other variables that "
+"may change in later revisions."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:12
-msgid "$ lb config --bootappend-live \"locales=de_CH.UTF-8\""
+#: en/user_managing_a_configuration.ssi:12
+msgid ""
+"For example, when the distribution is first set, many 'dependent' variables "
+"are given default values that suit that distribution. However, if you later "
+"decide to change the distribution, those dependent variables continue to "
+"retain old values that are no longer appropriate."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:16
-msgid "The entry for a Swiss-German keyboard would be:"
+#: en/user_managing_a_configuration.ssi:14
+msgid ""
+"A second, related problem is that if you run #{lb config}# and then upgrade "
+"to a new version of live-build that has changed one of the variable names, "
+"you will discover this only by manual review of the variables in your config "
+"files, which you will then need to use to set the appropriate option again."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:20
-msgid "$ lb config --bootappend-live \"keyboard-layouts=ch\""
+#: en/user_managing_a_configuration.ssi:16
+msgid ""
+"All of this would be a terrible nuisance if it weren't for auto/* scripts, "
+"simple wrappers to the #{lb config}#, #{lb build}# and #{lb clean}# commands "
+"that are designed to help you manage your configuration. Simply create an "
+"auto/config script containing #{lb config}# command with all desired "
+"options, and an auto/clean that removes the files containing configuration "
+"variable values, and each time you #{lb config}# and #{lb clean}#, these "
+"files will be executed. This will ensure that your configuration is kept "
+"internally consistent from one revision to the next and from one live-build "
+"release to the next (though you will still have to take care and read the "
+"documentation when you upgrade live-build and make adjustments as needed)."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:24
-msgid "Combined, the keyboard and locale configured for Switzerland would be:"
+#: en/user_managing_a_configuration.ssi:18
+msgid "2~ Example auto scripts"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:28
+#: en/user_managing_a_configuration.ssi:20
msgid ""
-"$ lb config --bootappend-live =\"locales=de_CH.UTF-8 keyboard-layouts=ch\""
+"Use the following auto script examples as the starting point for your new "
+"live-build configuration. Take note that when you call the #{lb}# command "
+"that the auto script wraps, you must specify #{noauto}# as its parameter to "
+"ensure that the auto script isn't called again, recursively."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:32
+#: en/user_managing_a_configuration.ssi:22
+msgid "auto/config"
+msgstr ""
+
+#. type: Plain text
+#: en/user_managing_a_configuration.ssi:29
+#, no-wrap
msgid ""
-"Note: You can find a list of options in the manpage for live-config. "
-"Currently, only UTF-8 locales are supported."
+"#!/bin/sh\n"
+"lb config noauto \\\n"
+"\t--architecture i386 \\\n"
+"\t${@}\n"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:34
-msgid "2~ l10n Packages"
+#: en/user_managing_a_configuration.ssi:33
+msgid "auto/clean"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:36
+#: en/user_managing_a_configuration.ssi:41
+#, no-wrap
msgid ""
-"An experimental feature of live-build is to automatically check for each "
-"package for which it is know that there are -l10n packages available and "
-"install them. To add German packages the entry would be"
+"#!/bin/sh\n"
+"lb clean noauto ${@}\n"
+"rm -f config/binary config/bootstrap \\\n"
+"\tconfig/chroot config/common config/source\n"
+"rm -f binary.log\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_managing_a_configuration.ssi:45
+msgid "auto/build"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:40
-msgid "$ lh_config --language \"de\""
+#: en/user_managing_a_configuration.ssi:50
+msgid "#!/bin/sh lb build noauto ${@} 2>&1 | tee binary.log"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:43
+#: en/user_managing_a_configuration.ssi:54
msgid ""
-"This will also change the default syslinux language if translations are "
-"available or local translations have been put into #{config/templates/"
-"syslinux/de}#."
+"Edit auto/config, changing or adding any options as you see fit. In the "
+"example above, --architecture is set to i386 so that when the image is built "
+"on an amd64 system, it will not default to building amd64 images. Change "
+"this to an appropriate value for your image (or delete it if you want to use "
+"the default) and add any additional options in continuation lines that "
+"follow."
msgstr ""
diff --git a/manual/po4a.cfg b/manual/po4a.cfg
index 2738a28..7ddd9b8 100644
--- a/manual/po4a.cfg
+++ b/manual/po4a.cfg
@@ -24,5 +24,6 @@
[type: text] en/user_customization-internationalization.ssi $lang:$lang/user_customization-internationalization.ssi
[type: text] en/user_customization-packages.ssi $lang:$lang/user_customization-packages.ssi
[type: text] en/user_installation.ssi $lang:$lang/user_installation.ssi
+[type: text] en/user_managing_a_configuration.ssi $lang:$lang/user_managing_a_configuration.ssi
[type: text] en/user_overview.ssi $lang:$lang/user_overview.ssi
[type: xhtml] en/index.html.in $lang:$lang/index.html.in
diff --git a/manual/pot/live-manual.ssm.pot b/manual/pot/live-manual.ssm.pot
index 55983ab..cb55e3a 100644
--- a/manual/pot/live-manual.ssm.pot
+++ b/manual/pot/live-manual.ssm.pot
@@ -7,7 +7,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-03 21:43+0300\n"
+"POT-Creation-Date: 2010-10-13 17:00+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <LL at li.org>\n"
@@ -45,7 +45,7 @@ msgstr ""
#, no-wrap
msgid ""
"@date:\n"
-" :published: 2010-10-03\n"
+" :published: 2010-10-13\n"
msgstr ""
#. type: Plain text
@@ -106,110 +106,115 @@ msgstr ""
#. type: Plain text
#: en/live-manual.ssm:39
-msgid "<< user_customization-packages.ssi"
+msgid "<< user_managing_a_configuration.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:41
-msgid "<< user_customization-contents.ssi"
+msgid "<< user_customization-packages.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:43
-msgid "<< user_customization-internationalization.ssi"
+msgid "<< user_customization-contents.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:45
-msgid ":B~ Development ~#"
+msgid "<< user_customization-internationalization.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:47
-msgid ":B~ Project ~#"
+msgid ":B~ Development ~#"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:49
-msgid ":B~ Other ~#"
+msgid ":B~ Project ~#"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:51
-msgid "<< other_customization-bootup.ssi"
+msgid ":B~ Other ~#"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:53
-msgid "<< other_customization-binary.ssi"
+msgid "<< other_customization-bootup.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:55
-msgid "<< other_customization-backports.ssi"
+msgid "<< other_customization-binary.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:57
-msgid "<< other_common-tasks.ssi"
+msgid "<< other_customization-backports.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:59
-msgid "<< other_live-environment.ssi"
+msgid "<< other_common-tasks.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:61
-msgid "<< other_faq.ssi"
+msgid "<< other_live-environment.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:63
-msgid "<< other_reporting-bugs.ssi"
+msgid "<< other_faq.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:65
-msgid "<< other_howtos.ssi"
+msgid "<< other_reporting-bugs.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:67
-msgid "<< other_coding-style.ssi"
+msgid "<< other_howtos.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:69
-msgid "<< other_procedures.ssi"
+msgid "<< other_coding-style.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:71
-msgid "<< other_resources.ssi"
+msgid "<< other_procedures.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:73
-msgid "<< other_use-cases.ssi"
+msgid "<< other_resources.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:75
-msgid "<< other_success-stories.ssi"
+msgid "<< other_use-cases.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:77
-msgid "<< other_troubleshooting.ssi"
+msgid "<< other_success-stories.ssi"
msgstr ""
#. type: Plain text
#: en/live-manual.ssm:79
+msgid "<< other_troubleshooting.ssi"
+msgstr ""
+
+#. type: Plain text
+#: en/live-manual.ssm:81
msgid "<< other_configuration-layout.ssi"
msgstr ""
#. type: Plain text
-#: en/live-manual.ssm:80
+#: en/live-manual.ssm:82
msgid "<< other_configuration-files.ssi"
msgstr ""
diff --git a/manual/pot/user_customization-packages.ssi.pot b/manual/pot/user_customization-packages.ssi.pot
index d90eb4a..9a6e083 100644
--- a/manual/pot/user_customization-packages.ssi.pot
+++ b/manual/pot/user_customization-packages.ssi.pot
@@ -7,7 +7,7 @@
msgid ""
msgstr ""
"Project-Id-Version: live-manual VERSION\n"
-"POT-Creation-Date: 2010-10-03 20:30+0300\n"
+"POT-Creation-Date: 2010-10-13 17:00+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <LL at li.org>\n"
@@ -26,51 +26,53 @@ msgstr ""
#: en/other_coding-style.ssi:106 en/other_coding-style.ssi:117
#: en/other_common-tasks.ssi:32 en/other_customization-backports.ssi:8
#: en/other_customization-bootup.ssi:30 en/other_customization-bootup.ssi:39
-#: en/other_customization-internationalization.ssi:10
-#: en/other_customization-internationalization.ssi:18
-#: en/other_customization-internationalization.ssi:26
-#: en/other_customization-internationalization.ssi:34
-#: en/other_customization-internationalization.ssi:46 en/other_faq.ssi:41
-#: en/other_faq.ssi:83 en/other_faq.ssi:103 en/other_faq.ssi:117
-#: en/other_faq.ssi:137 en/other_faq.ssi:151 en/other_faq.ssi:198
-#: en/other_faq.ssi:245 en/other_faq.ssi:261 en/other_faq.ssi:287
-#: en/other_faq.ssi:299 en/other_faq.ssi:314 en/other_faq.ssi:333
-#: en/other_faq.ssi:345 en/other_faq.ssi:353 en/other_faq.ssi:364
-#: en/other_faq.ssi:374 en/other_howtos.ssi:16 en/other_howtos.ssi:43
-#: en/other_live-environment.ssi:14 en/other_live-environment.ssi:30
-#: en/other_live-environment.ssi:51 en/other_live-environment.ssi:61
-#: en/other_live-environment.ssi:69 en/other_live-environment.ssi:77
-#: en/other_live-environment.ssi:85 en/other_live-environment.ssi:93
-#: en/other_live-environment.ssi:116 en/other_live-environment.ssi:124
-#: en/other_live-environment.ssi:133 en/other_procedures.ssi:12
-#: en/other_procedures.ssi:46 en/other_procedures.ssi:58
-#: en/other_use-cases.ssi:24 en/other_use-cases.ssi:49
-#: en/other_use-cases.ssi:75 en/other_use-cases.ssi:103
-#: en/other_use-cases.ssi:111 en/user_basics.ssi: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_faq.ssi:41 en/other_faq.ssi:83 en/other_faq.ssi:103
+#: en/other_faq.ssi:117 en/other_faq.ssi:137 en/other_faq.ssi:151
+#: en/other_faq.ssi:198 en/other_faq.ssi:245 en/other_faq.ssi:261
+#: en/other_faq.ssi:287 en/other_faq.ssi:299 en/other_faq.ssi:314
+#: en/other_faq.ssi:333 en/other_faq.ssi:345 en/other_faq.ssi:353
+#: en/other_faq.ssi:364 en/other_faq.ssi:374 en/other_howtos.ssi:16
+#: en/other_howtos.ssi:43 en/other_live-environment.ssi:14
+#: en/other_live-environment.ssi:30 en/other_live-environment.ssi:51
+#: en/other_live-environment.ssi:61 en/other_live-environment.ssi:69
+#: en/other_live-environment.ssi:77 en/other_live-environment.ssi:85
+#: en/other_live-environment.ssi:93 en/other_live-environment.ssi:116
+#: en/other_live-environment.ssi:124 en/other_live-environment.ssi:133
+#: en/other_procedures.ssi:12 en/other_procedures.ssi:46
+#: en/other_procedures.ssi:58 en/other_use-cases.ssi:24
+#: en/other_use-cases.ssi:49 en/other_use-cases.ssi:75
+#: en/other_use-cases.ssi:103 en/other_use-cases.ssi:111 en/user_basics.ssi: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/user_customization-contents.ssi:34 en/user_customization-contents.ssi:43
-#: en/user_customization-contents.ssi:66 en/user_customization-packages.ssi:16
-#: en/user_customization-packages.ssi:24 en/user_customization-packages.ssi:36
-#: en/user_customization-packages.ssi:45 en/user_customization-packages.ssi:59
-#: en/user_customization-packages.ssi:73
+#: en/user_customization-contents.ssi:66
+#: en/user_customization-internationalization.ssi:10
+#: en/user_customization-internationalization.ssi:18
+#: en/user_customization-internationalization.ssi:26
+#: en/user_customization-internationalization.ssi:38
+#: en/user_customization-packages.ssi:16 en/user_customization-packages.ssi:24
+#: en/user_customization-packages.ssi:36 en/user_customization-packages.ssi:45
+#: en/user_customization-packages.ssi:59 en/user_customization-packages.ssi:73
#: en/user_customization-packages.ssi:103
#: en/user_customization-packages.ssi:111
#: en/user_customization-packages.ssi:131
-#: en/user_customization-packages.ssi:160
-#: en/user_customization-packages.ssi:170
-#: en/user_customization-packages.ssi:180
-#: en/user_customization-packages.ssi:190 en/user_installation.ssi:38
+#: en/user_customization-packages.ssi:166
+#: en/user_customization-packages.ssi:176
+#: en/user_customization-packages.ssi:186
+#: en/user_customization-packages.ssi:196 en/user_installation.ssi:38
#: en/user_installation.ssi:46 en/user_installation.ssi:56
#: en/user_installation.ssi:64 en/user_installation.ssi:76
#: en/user_installation.ssi:84 en/user_installation.ssi:105
#: en/user_installation.ssi:119 en/user_installation.ssi:136
-#: en/user_overview.ssi:60 en/user_overview.ssi:104 en/user_overview.ssi:112
+#: 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
msgid "code{"
msgstr ""
@@ -84,17 +86,12 @@ msgstr ""
#: en/other_coding-style.ssi:113 en/other_coding-style.ssi:124
#: en/other_common-tasks.ssi:36 en/other_customization-backports.ssi:16
#: en/other_customization-bootup.ssi:35 en/other_customization-bootup.ssi:48
-#: en/other_customization-internationalization.ssi:14
-#: en/other_customization-internationalization.ssi:22
-#: en/other_customization-internationalization.ssi:30
-#: en/other_customization-internationalization.ssi:38
-#: en/other_customization-internationalization.ssi:50 en/other_faq.ssi:37
-#: en/other_faq.ssi:46 en/other_faq.ssi:92 en/other_faq.ssi:108
-#: en/other_faq.ssi:141 en/other_faq.ssi:155 en/other_faq.ssi:207
-#: en/other_faq.ssi:256 en/other_faq.ssi:292 en/other_faq.ssi:307
-#: en/other_faq.ssi:319 en/other_faq.ssi:337 en/other_faq.ssi:349
-#: en/other_faq.ssi:358 en/other_faq.ssi:370 en/other_faq.ssi:381
-#: en/other_howtos.ssi:20 en/other_howtos.ssi:47
+#: en/other_faq.ssi:37 en/other_faq.ssi:46 en/other_faq.ssi:92
+#: en/other_faq.ssi:108 en/other_faq.ssi:141 en/other_faq.ssi:155
+#: en/other_faq.ssi:207 en/other_faq.ssi:256 en/other_faq.ssi:292
+#: en/other_faq.ssi:307 en/other_faq.ssi:319 en/other_faq.ssi:337
+#: en/other_faq.ssi:349 en/other_faq.ssi:358 en/other_faq.ssi:370
+#: en/other_faq.ssi:381 en/other_howtos.ssi:20 en/other_howtos.ssi:47
#: en/other_live-environment.ssi:18 en/other_live-environment.ssi:34
#: en/other_live-environment.ssi:55 en/other_live-environment.ssi:65
#: en/other_live-environment.ssi:73 en/other_live-environment.ssi:81
@@ -113,26 +110,32 @@ msgstr ""
#: 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/user_customization-contents.ssi:54 en/user_customization-contents.ssi:70
+#: en/user_customization-internationalization.ssi:14
+#: en/user_customization-internationalization.ssi:22
+#: en/user_customization-internationalization.ssi:30
+#: en/user_customization-internationalization.ssi:42
#: en/user_customization-packages.ssi:20 en/user_customization-packages.ssi:28
#: en/user_customization-packages.ssi:41 en/user_customization-packages.ssi:49
#: en/user_customization-packages.ssi:63 en/user_customization-packages.ssi:77
#: en/user_customization-packages.ssi:107
#: en/user_customization-packages.ssi:115
#: en/user_customization-packages.ssi:135
-#: en/user_customization-packages.ssi:166
-#: en/user_customization-packages.ssi:176
-#: en/user_customization-packages.ssi:186
-#: en/user_customization-packages.ssi:196 en/user_installation.ssi:42
+#: en/user_customization-packages.ssi:172
+#: en/user_customization-packages.ssi:182
+#: en/user_customization-packages.ssi:192
+#: en/user_customization-packages.ssi:202 en/user_installation.ssi:42
#: en/user_installation.ssi:50 en/user_installation.ssi:60
#: en/user_installation.ssi:72 en/user_installation.ssi:80
#: en/user_installation.ssi:109 en/user_installation.ssi:124
-#: en/user_installation.ssi:139 en/user_overview.ssi:98
+#: en/user_installation.ssi:139 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
msgid "}code"
msgstr ""
#. type: Plain text
-#: en/user_basics.ssi:220 en/user_customization-packages.ssi:147
+#: en/user_basics.ssi:220 en/user_customization-packages.ssi:153
msgid "% FIXME"
msgstr ""
@@ -461,16 +464,39 @@ msgstr ""
#. type: Plain text
#: en/user_customization-packages.ssi:145
#, no-wrap
+msgid "*{Local binary packages lists}*\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:147
+msgid ""
+"In case you want to include some required .deb packages to live medias pool/ "
+"(without installing them onto the live image) you may need to use lists "
+"using binary local package lists stored in config/binary_local-"
+"packageslists. Such media can be used as a customized debian install image "
+"for offline installations."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:149
+msgid ""
+"Package lists that exist in this directory need to have a .list suffix in "
+"order to be processed."
+msgstr ""
+
+#. type: Plain text
+#: en/user_customization-packages.ssi:151
+#, no-wrap
msgid "*{Extending a provided package list using includes}*\n"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:154
+#: en/user_customization-packages.ssi:160
msgid "% code{ % % #include <gnome> % iceweasel % % }code"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:156
+#: en/user_customization-packages.ssi:162
msgid ""
"The package lists that are included with live-build make extensive use of "
"includes. They are available to view in the #{/usr/share/live/build/lists}# "
@@ -478,75 +504,75 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:158
+#: en/user_customization-packages.ssi:164
#, no-wrap
msgid "*{Using conditionals inside packages lists}*\n"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:164
+#: en/user_customization-packages.ssi:170
msgid "#if ARCHITECTURE amd64 ia32-libs #endif"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:168
+#: en/user_customization-packages.ssi:174
msgid "or if #{LB_ARCHITECTURE}# is set to #{i386}# or #{amd64}#:"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:174
+#: en/user_customization-packages.ssi:180
msgid "#if ARCHITECTURE i386 amd64 memtest86+ #endif"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:178
+#: en/user_customization-packages.ssi:184
msgid "or if #{LB_ARCHIVE_AREAS}# contains either #{contrib}# or #{non-free}#:"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:184
+#: en/user_customization-packages.ssi:190
msgid "#if ARCHIVE_AREAS contrib non-free vrms #endif"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:188
+#: en/user_customization-packages.ssi:194
msgid "A conditional may surround an #{#include}# directive:"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:194
+#: en/user_customization-packages.ssi:200
msgid "#if ARCHITECTURE amd64 #include <gnome-full> #endif"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:198
+#: en/user_customization-packages.ssi:204
msgid ""
"Any live-build configuration variable that begins with #{LB_}# can be tested "
"in this way."
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:200
+#: en/user_customization-packages.ssi:206
msgid "The nesting of conditionals is not supported."
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:202
+#: en/user_customization-packages.ssi:208
msgid "3~ Tasks"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:204
+#: en/user_customization-packages.ssi:210
msgid "%FIXME"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:206
+#: en/user_customization-packages.ssi:212
msgid "2~ Installing modified or third-party packages"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:208
+#: en/user_customization-packages.ssi:214
msgid ""
"Whilst it is against the philosophy of Debian Live, it may sometimes be "
"necessary to build a Live system with modified versions of packages that are "
@@ -557,7 +583,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:210
+#: en/user_customization-packages.ssi:216
msgid ""
"This section does not cover advice regarding building or maintaining "
"modified packages. Joachim Breitner's 'How to fork privately' method from "
@@ -568,22 +594,22 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:212
+#: en/user_customization-packages.ssi:218
msgid "There are two ways of installing modified custom packages:"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:214
+#: en/user_customization-packages.ssi:220
msgid "_* #{chroot_local-packages}#"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:216
+#: en/user_customization-packages.ssi:222
msgid "_* Using a custom APT repository"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:218
+#: en/user_customization-packages.ssi:224
msgid ""
"The #{chroot_local-packages}# is simpler to achieve and useful for \"one-off"
"\" customisations but has a number of drawbacks, whilst using a custom APT "
@@ -591,12 +617,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:220
+#: en/user_customization-packages.ssi:226
msgid "3~ Using #{chroot_local-packages}# to install custom packages"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:222
+#: en/user_customization-packages.ssi:228
msgid ""
"To install a custom package, simply copy it to the #{config/chroot_local-"
"packages}# directory. Packages that are inside this directory will be "
@@ -605,45 +631,45 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:224
+#: en/user_customization-packages.ssi:230
msgid ""
"Packages *{must}* be named in the prescribed way. One simple way to do this "
"is to use #{dpkg-name}#."
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:226
+#: en/user_customization-packages.ssi:232
msgid ""
"Using #{chroot_local-packages}# for installation of custom packages has "
"disadvantages:"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:228
+#: en/user_customization-packages.ssi:234
msgid "_* It is not possible to use secure APT"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:230
+#: en/user_customization-packages.ssi:236
msgid ""
"_* You must install all appropriate packages in the #{config/chroot_local-"
"packages}# directory"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:232
+#: en/user_customization-packages.ssi:238
msgid ""
"_* It does not lend itself to storing Debian Live configurations in revision "
"control"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:234
+#: en/user_customization-packages.ssi:240
msgid "3~ Using an APT repository to install custom packages"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:236
+#: en/user_customization-packages.ssi:242
msgid ""
"Unlike using #{chroot_local-packages}#, when using a custom APT repository "
"you must ensure that you specify the packages elsewhere. See lb-packages for "
@@ -651,12 +677,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:238
+#: en/user_customization-packages.ssi:244
msgid "% FIXME: <xref linkend=\"lb-packages\"/>"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:240
+#: en/user_customization-packages.ssi:246
msgid ""
"Whilst it may seem unnecessary effort to create an APT repository to install "
"custom packages, the infrastructure can be easily re-used at a later date to "
@@ -664,12 +690,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:242
+#: en/user_customization-packages.ssi:248
msgid "3~ Custom packages and APT"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:244
+#: en/user_customization-packages.ssi:250
msgid ""
"live-build uses APT to install all packages into the live system so will "
"therefore inherit behaviours from this program. One relevant example is that "
@@ -679,7 +705,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:246
+#: en/user_customization-packages.ssi:252
msgid ""
"Because of this, you may wish to increment the version number in your custom "
"packages' #{debian/changelog}# files to ensure that your modified version is "
@@ -689,17 +715,17 @@ msgid ""
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:248
+#: en/user_customization-packages.ssi:254
msgid "% FIXME: <xref linkend=\"apt-preferences\"/>"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:250
+#: en/user_customization-packages.ssi:256
msgid "3~ Altering APT preferences during Live system"
msgstr ""
#. type: Plain text
-#: en/user_customization-packages.ssi:251
+#: en/user_customization-packages.ssi:257
msgid ""
"Whilst it may seem unnecessary effort to create an APT repository to install "
"custom packages, the infrastructure can be easily re-used at a later date to "
diff --git a/manual/pot/user_customization-internationalization.ssi.pot b/manual/pot/user_managing_a_configuration.ssi.pot
similarity index 61%
copy from manual/pot/user_customization-internationalization.ssi.pot
copy to manual/pot/user_managing_a_configuration.ssi.pot
index 141e77f..228a192 100644
--- a/manual/pot/user_customization-internationalization.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-03 21:43+0300\n"
+"POT-Creation-Date: 2010-10-13 17:00+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <LL at li.org>\n"
@@ -61,15 +61,18 @@ msgstr ""
#: en/user_customization-packages.ssi:103
#: en/user_customization-packages.ssi:111
#: en/user_customization-packages.ssi:131
-#: en/user_customization-packages.ssi:160
-#: en/user_customization-packages.ssi:170
-#: en/user_customization-packages.ssi:180
-#: en/user_customization-packages.ssi:190 en/user_installation.ssi:38
+#: en/user_customization-packages.ssi:166
+#: en/user_customization-packages.ssi:176
+#: en/user_customization-packages.ssi:186
+#: en/user_customization-packages.ssi:196 en/user_installation.ssi:38
#: en/user_installation.ssi:46 en/user_installation.ssi:56
#: en/user_installation.ssi:64 en/user_installation.ssi:76
#: en/user_installation.ssi:84 en/user_installation.ssi:105
#: en/user_installation.ssi:119 en/user_installation.ssi:136
-#: en/user_overview.ssi:60 en/user_overview.ssi:104 en/user_overview.ssi:112
+#: 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
msgid "code{"
msgstr ""
@@ -117,95 +120,149 @@ msgstr ""
#: en/user_customization-packages.ssi:107
#: en/user_customization-packages.ssi:115
#: en/user_customization-packages.ssi:135
-#: en/user_customization-packages.ssi:166
-#: en/user_customization-packages.ssi:176
-#: en/user_customization-packages.ssi:186
-#: en/user_customization-packages.ssi:196 en/user_installation.ssi:42
+#: en/user_customization-packages.ssi:172
+#: en/user_customization-packages.ssi:182
+#: en/user_customization-packages.ssi:192
+#: en/user_customization-packages.ssi:202 en/user_installation.ssi:42
#: en/user_installation.ssi:50 en/user_installation.ssi:60
#: en/user_installation.ssi:72 en/user_installation.ssi:80
#: en/user_installation.ssi:109 en/user_installation.ssi:124
-#: en/user_installation.ssi:139 en/user_overview.ssi:98
+#: en/user_installation.ssi:139 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
msgid "}code"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:2
-msgid "B~ Customising Locale And Language"
+#: en/user_managing_a_configuration.ssi:2
+msgid ":B~ Managing a configuration"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:4
-msgid "1~ Customising Locale And Language"
+#: en/user_managing_a_configuration.ssi:4
+msgid "1~ Managing a configuration"
+msgstr ""
+
+#. type: Plain text
+#: en/user_managing_a_configuration.ssi:6
+msgid ""
+"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."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:6
-msgid "2~ Default locale and keyboard"
+#: en/user_managing_a_configuration.ssi:8
+msgid "2~ Use auto to manage configuration changes"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:8
+#: en/user_managing_a_configuration.ssi:10
msgid ""
-"The default locale when building a live cd is \"locales=en_US.UTF-8\", to "
-"set the locale for e.g. Switzerland, you can use \"locales=de_CH.UTF-8\"."
+"Live configurations rarely are perfect on the first try. You'll likely need "
+"to make a series of revisions until you are satisfied. However, "
+"inconsistencies can creep into your configuration from one revision to the "
+"next if you aren't careful. The main problem is, once a variable is given a "
+"default value, that value will not be recomputed from other variables that "
+"may change in later revisions."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:12
-msgid "$ lb config --bootappend-live \"locales=de_CH.UTF-8\""
+#: en/user_managing_a_configuration.ssi:12
+msgid ""
+"For example, when the distribution is first set, many 'dependent' variables "
+"are given default values that suit that distribution. However, if you later "
+"decide to change the distribution, those dependent variables continue to "
+"retain old values that are no longer appropriate."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:16
-msgid "The entry for a Swiss-German keyboard would be:"
+#: en/user_managing_a_configuration.ssi:14
+msgid ""
+"A second, related problem is that if you run #{lb config}# and then upgrade "
+"to a new version of live-build that has changed one of the variable names, "
+"you will discover this only by manual review of the variables in your config "
+"files, which you will then need to use to set the appropriate option again."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:20
-msgid "$ lb config --bootappend-live \"keyboard-layouts=ch\""
+#: en/user_managing_a_configuration.ssi:16
+msgid ""
+"All of this would be a terrible nuisance if it weren't for auto/* scripts, "
+"simple wrappers to the #{lb config}#, #{lb build}# and #{lb clean}# commands "
+"that are designed to help you manage your configuration. Simply create an "
+"auto/config script containing #{lb config}# command with all desired "
+"options, and an auto/clean that removes the files containing configuration "
+"variable values, and each time you #{lb config}# and #{lb clean}#, these "
+"files will be executed. This will ensure that your configuration is kept "
+"internally consistent from one revision to the next and from one live-build "
+"release to the next (though you will still have to take care and read the "
+"documentation when you upgrade live-build and make adjustments as needed)."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:24
-msgid "Combined, the keyboard and locale configured for Switzerland would be:"
+#: en/user_managing_a_configuration.ssi:18
+msgid "2~ Example auto scripts"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:28
+#: en/user_managing_a_configuration.ssi:20
msgid ""
-"$ lb config --bootappend-live =\"locales=de_CH.UTF-8 keyboard-layouts=ch\""
+"Use the following auto script examples as the starting point for your new "
+"live-build configuration. Take note that when you call the #{lb}# command "
+"that the auto script wraps, you must specify #{noauto}# as its parameter to "
+"ensure that the auto script isn't called again, recursively."
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:32
+#: en/user_managing_a_configuration.ssi:22
+msgid "auto/config"
+msgstr ""
+
+#. type: Plain text
+#: en/user_managing_a_configuration.ssi:29
+#, no-wrap
msgid ""
-"Note: You can find a list of options in the manpage for live-config. "
-"Currently, only UTF-8 locales are supported."
+"#!/bin/sh\n"
+"lb config noauto \\\n"
+"\t--architecture i386 \\\n"
+"\t${@}\n"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:34
-msgid "2~ l10n Packages"
+#: en/user_managing_a_configuration.ssi:33
+msgid "auto/clean"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:36
+#: en/user_managing_a_configuration.ssi:41
+#, no-wrap
msgid ""
-"An experimental feature of live-build is to automatically check for each "
-"package for which it is know that there are -l10n packages available and "
-"install them. To add German packages the entry would be"
+"#!/bin/sh\n"
+"lb clean noauto ${@}\n"
+"rm -f config/binary config/bootstrap \\\n"
+"\tconfig/chroot config/common config/source\n"
+"rm -f binary.log\n"
+msgstr ""
+
+#. type: Plain text
+#: en/user_managing_a_configuration.ssi:45
+msgid "auto/build"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:40
-msgid "$ lh_config --language \"de\""
+#: en/user_managing_a_configuration.ssi:50
+msgid "#!/bin/sh lb build noauto ${@} 2>&1 | tee binary.log"
msgstr ""
#. type: Plain text
-#: en/user_customization-internationalization.ssi:43
+#: en/user_managing_a_configuration.ssi:54
msgid ""
-"This will also change the default syslinux language if translations are "
-"available or local translations have been put into #{config/templates/"
-"syslinux/de}#."
+"Edit auto/config, changing or adding any options as you see fit. In the "
+"example above, --architecture is set to i386 so that when the image is built "
+"on an amd64 system, it will not default to building amd64 images. Change "
+"this to an appropriate value for your image (or delete it if you want to use "
+"the default) and add any additional options in continuation lines that "
+"follow."
msgstr ""
--
live-manual
More information about the debian-live-changes
mailing list