josch/multistrap
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Clarify documentation of bootstrap and aptsources sections (Closes: #579626)

Browse source 
git-svn-id: http://emdebian.org/svn/current@7182 563faec7-e20c-0410-992a-a66f704d0ccd
This commit is contained in:
codehelp 2010-05-05 18:50:33 +00:00
parent 730e4212cd
commit 227736b1c1
2 changed files with 28 additions and 30 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
debian/changelog vendored
View file

@ -1,9 +1,11 @@
multistrap (2.1.4) experimental; urgency=low multistrap (2.1.4) unstable; urgency=low
* Add support for configurable single cross-toolchains in * Add support for configurable single cross-toolchains in
the chroot - using the dpkg-cross default_arch, if any. the chroot - using the dpkg-cross default_arch, if any.
* Clarify documentation of bootstrap and aptsources sections
(Closes: #579626)
-- Neil Williams <codehelp@debian.org> Fri, 30 Apr 2010 18:11:16 +0100 -- Neil Williams <codehelp@debian.org> Wed, 05 May 2010 19:49:22 +0100
multistrap (2.1.3) experimental; urgency=low multistrap (2.1.3) experimental; urgency=low

52
pod/multistrap
View file

@ -2,11 +2,12 @@
=head1 Name =head1 Name
multistrap - extends debootstrap for multiple repository support multistrap - debootstrap replacement for multiple repository support
=head1 Synopsis =head1 Synopsis
multistrap [-a ARCH] [-d DIR] -f CONFIG_FILE multistrap [-a ARCH] [-d DIR] -f CONFIG_FILE
multistrap [--simulate] -f CONFIG_FILE
multistrap -?|-h|--help|--version multistrap -?|-h|--help|--version
=head1 Options =head1 Options
@ -36,8 +37,9 @@ extended to provide support for multiple repositories, using a
configuration file to specify the relevant suites, architecture, configuration file to specify the relevant suites, architecture,
extra packages and the mirror to use for each debootstrap. extra packages and the mirror to use for each debootstrap.
The aim is to create a complete debootstrap with all packages The aim is to create a complete bootstrap / root filesystem with
installed and configured, instead of just the base system. all packages installed and configured, instead of just the base
system.
Example configuration: Example configuration:
@ -55,7 +57,7 @@ Example configuration:
# aptsources is a list of sections to be used # aptsources is a list of sections to be used
# the /etc/apt/sources.list.d/multistrap.sources.list # the /etc/apt/sources.list.d/multistrap.sources.list
# of the target. Order is not important # of the target. Order is not important
aptsources=Grip Updates aptsources=Debian
# the bootstrap option determines which repository # the bootstrap option determines which repository
# is used to calculate the list of Priority: required packages # is used to calculate the list of Priority: required packages
# and which packages go into the rootfs. # and which packages go into the rootfs.
@ -74,33 +76,12 @@ the specified mirror, for armel in '/opt/multistrap/'.
Specify a package to extend the multistrap to include that package and Specify a package to extend the multistrap to include that package and
all dependencies. all dependencies.
Specify more debootstraps by adding new sections. Section names are used Specify more bootstraps by adding new sections. Section names are used
in the debootstrap general option. in the bootstrap general option.
Section names are case-insensitive. Section names are case-insensitive.
e.g. change All dependencies are resolved only by apt, using all bootstrap
debootstrap=Debian
to
debootstrap=Grip
then add the new section for Grip:
[Grip]
packages=locales
keyring=emdebian-archive-keyring
source=http://www.emdebian.org/grip
suite=lenny
Setting Grip instead of Debian in the debootstrap option, as above,
will provide a base system from Emdebian Grip 1.0 and locate any
missing dependencies in Debian 5.0 Lenny, allowing you to add any
package(s) you need from Debian that are not yet in Emdebian Grip.
All dependencies are resolved only by apt, using all configured
repositories, to use only the most recent and most suitable repositories, to use only the most recent and most suitable
dependencies. Note that multistrap turns off Install-Recommends dependencies. Note that multistrap turns off Install-Recommends
so if the multistrap needs a package that is only a Recommended so if the multistrap needs a package that is only a Recommended
@ -111,6 +92,21 @@ packages line explicitly.
Other general options have command line options, except debootstrap Other general options have command line options, except debootstrap
itself. itself.
=Repositories
C<aptsources> lists the sections which should be used to create the
F</etc/apt/sources.list.d/multistrap.list> apt sources in the final
system. Not all C<aptsources> have to appear in the C<bootstrap>
section if you have some internal or local sources which are not
accessible to the installed root filesystem.
C<bootstrap> lists the sections which will be used to create the
multistrap itself. Only packages listed in C<bootstrap> will be
downloaded and unpacked by multistrap.
Make sure C<bootstrap> lists all sections you need for apt to be
able to find all the packages to be unpacked for the multistrap.
=head1 General settings: =head1 General settings:
'directory' specifies the top level directory where the debootstrap 'directory' specifies the top level directory where the debootstrap