[SCM] live-manual branch, debian-next, updated. debian/3.0_a14-1-21-g4a50b53
chals
chals at altorricon.com
Sat Aug 4 14:38:35 UTC 2012
The following commit has been merged in the debian-next branch:
commit 4a50b53e1c526074158925439030eedd8535f915
Author: chals <chals at altorricon.com>
Date: Sat Aug 4 16:39:15 2012 +0200
Revising the now unsupported '-p|--package-lists' option providing alternatives, thanks to Ben Armstrong for the hints.
diff --git a/manual/en/user_examples.ssi b/manual/en/user_examples.ssi
index fcc2d44..fa042df 100644
--- a/manual/en/user_examples.ssi
+++ b/manual/en/user_examples.ssi
@@ -54,8 +54,7 @@ code{
$ mkdir tutorial2
$ cd tutorial2
- $ lb config -p lxde
- $ echo iceweasel >> config/package-lists/my.list.chroot
+ $ echo "task-lxde-desktop iceweasel" >> config/package-lists/my.list.chroot
}code
@@ -96,7 +95,6 @@ code{
lb config noauto \
--architectures i386 \
--linux-flavours 686-pae \
- --package-lists lxde \
"${@}"
}code
@@ -113,11 +111,11 @@ Now populate your local package list:
code{
- $ echo "iceweasel xchat" >> config/package-lists/my.list.chroot
+ $ echo "task-lxde-desktop iceweasel xchat" >> config/package-lists/my.list.chroot
}code
-First, #{--architectures i386}# ensures that on our #{amd64}# build system, we build a 32-bit version suitable for use on most machines. Second, we use #{--linux-flavours 686-pae}# because we don't anticipate using this image on much older systems. Third, we've chosen the /{lxde}/ package list to give us a minimal desktop. And finally, we have added two initial favourite packages: /{iceweasel}/ and /{xchat}/.
+First, #{--architectures i386}# ensures that on our #{amd64}# build system, we build a 32-bit version suitable for use on most machines. Second, we use #{--linux-flavours 686-pae}# because we don't anticipate using this image on much older systems. Third, we have chosen the /{lxde}/ task metapackage to give us a minimal desktop. And finally, we have added two initial favourite packages: /{iceweasel}/ and /{xchat}/.
Now, build the image:
@@ -189,9 +187,9 @@ code{
$ mkdir vnc_kiosk_client
$ cd vnc_kiosk_client
- $ lb config -a i386 -k 686-pae -p standard-x11 \
- --apt-recommends false
- $ echo "gdm3 metacity xvnc4viewer" >> config/package-lists/my.list.chroot
+ $ lb config -a i386 -k 686-pae --apt-recommends false
+ $ echo '! Packages Priority standard' > config/package-lists/standard.list.chroot
+ $ echo "xorg gdm3 metacity xvnc4viewer" > config/package-lists/my.list.chroot
}code
@@ -223,13 +221,13 @@ Enjoy.
2~ A base image for a 128M USB key
-*{Use case:}* Create a standard image with some components removed in order to fit on a 128M USB key with space left over to use as you see fit.
+*{Use case:}* Create a standard image with some components removed in order to fit on a 128M USB key with a little space left over to use as you see fit.
-When optimizing an image to fit a certain media size, you need to understand the tradeoffs you are making between size and functionality. In this example, we trim only so much as to make room for additional material within a 128M media size, but without doing anything to destroy integrity of the packages contained within, such as the purging of locale data via the /{localepurge}/ package, or other such "intrusive" optimizations. Of particular note, you should not use #{--bootstrap-flavour minimal}# unless you really know what you're doing, as omitting priority *{important}* packages will most likely produce a broken live system.
+When optimizing an image to fit a certain media size, you need to understand the tradeoffs you are making between size and functionality. In this example, we trim only so much as to make room for additional material within a 128M media size, but without doing anything to destroy integrity of the packages contained within, such as the purging of locale data via the /{localepurge}/ package, or other such "intrusive" optimizations. Of particular note, in order to understand what #{--hooks minimal.chroot}# does you should take a look at #{/usr/share/doc/live-build/examples/hooks}#
code{
- $ lb config -k 486 -p minimal --apt-indices false \
+ $ lb config -k 486 --hooks minimal.chroot --apt-indices false \
--memtest none --apt-recommends false --includes none
}code
@@ -242,9 +240,9 @@ code{
}code
-On the author's system at time of writing, the above configuration produced a 78Mbyte image. This compares favourably with the 166Mbyte image produced by the default configuration in {Tutorial 1}#tutorial-1.
+On the author's system at the time of writing this, the above configuration produced a 101Mbyte image. This compares favourably with the 182Mbyte image produced by the default configuration in {Tutorial 1}#tutorial-1.
-The biggest space-saver here, compared to building a standard image on an #{i386}# architecture system, is to select only the #{486}# kernel flavour instead of the default #{-k "486 686-pae"}#. Leaving off APT's indices with #{--apt-indices false}# also saves a fair amount of space, the tradeoff being that you need to #{apt-get update}# before using apt in the live system. Choosing the #{minimal}# package list leaves out the large #{locales}# package and associated utilities. Dropping recommended packages with #{--apt-recommends false}# saves some additional space, at the expense of omitting some packages you might otherwise expect to be there, such as /{firmware-linux-free}/ which may be needed to support certain hardware. The remaining options shave off additional small amounts of space. It's up to you to decide if the functionality that is sacrificed with each optimization is worth the loss in functionality.
+The biggest space-saver here, compared to building a standard image on an #{i386}# architecture system, is to select only the #{486}# kernel flavour instead of the default #{-k "486 686-pae"}#. Leaving off APT's indices with #{--apt-indices false}# also saves a fair amount of space, the tradeoff being that you need to #{apt-get update}# before using apt in the live system. Activating the #{minimal}# hook removes some unused packages and files. Dropping recommended packages with #{--apt-recommends false}# saves some additional space, at the expense of omitting some packages you might otherwise expect to be there, such as /{firmware-linux-free}/ which may be needed to support certain hardware. The remaining options shave off additional small amounts of space. It's up to you to decide if the functionality that is sacrificed with each optimization is worth the loss in functionality.
2~ A localized KDE desktop and installer
diff --git a/manual/en/user_managing_a_configuration.ssi b/manual/en/user_managing_a_configuration.ssi
index 3aca901..3a92e1d 100644
--- a/manual/en/user_managing_a_configuration.ssi
+++ b/manual/en/user_managing_a_configuration.ssi
@@ -24,7 +24,6 @@ code{
#!/bin/sh
lb config noauto \
- --package-lists "standard" \
"${@}"
}code
@@ -58,4 +57,19 @@ code{
}code
-Edit #{auto/config}#, changing or adding any options as you see fit. In the example above, #{--package-lists standard}# is set to the default value. 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.
+Edit #{auto/config}#, adding any options as you see fit. For instance:
+
+code{
+
+ #!/bin/sh
+ lb config noauto \
+ --architectures i386 \
+ --linux-flavours 686-pae \
+ --binary-images hdd \
+ --mirror-bootstrap http://ftp.es.debian.org/debian/ \
+ --mirror-binary http://ftp.es.debian.org/debian/ \
+ "${@}"
+
+}code
+
+And any other additional options in continuation lines that follow.
diff --git a/manual/en/user_overview.ssi b/manual/en/user_overview.ssi
index 6f3e319..38bf70e 100644
--- a/manual/en/user_overview.ssi
+++ b/manual/en/user_overview.ssi
@@ -35,19 +35,19 @@ Issuing #{lb config}# without any arguments creates a #{config/}# subdirectory w
code{
$ lb config
- [2012-03-19 15:17:14] lb_config
+ [2012-08-03 22:59:17] lb_config
P: Considering defaults defined in /etc/live/build.conf
- P: Creating config tree for a debian system
+ P: Creating config tree for a debian/i386 system
}code
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).
-Normally, you will want to specify some options. For example, to include the 'gnome' package list in your configuration:
+Normally, you will want to specify some options. For example, to specify which distribution you want to build using its codename:
code{
- $ lb config -p gnome
+ $ lb config --distribution sid
}code
--
live-manual
More information about the debian-live-changes
mailing list