diff --git a/mmdebstrap b/mmdebstrap index a2cf5dc..cb80d77 100755 --- a/mmdebstrap +++ b/mmdebstrap @@ -6400,45 +6400,52 @@ B creates a Debian chroot of I into I from one or more Is. It is meant as an alternative to the debootstrap tool (see section B). In contrast to debootstrap it uses apt to resolve dependencies and is thus able to use more than one mirror and resolve more -complex dependencies. See section B for an overview of how -B works internally. - -If no I option is provided and I is not a stable release name, -L is used. If I is a stable release name -and no I is specified, then mirrors for updates and security are -automatically added. If a I option starts with "deb " or "deb-src " -then it is used as a one-line-style format entry for apt's sources.list inside -the chroot. If a I option contains a "://" then it is interpreted as a -mirror URI and the apt line inside the chroot is assembled as "deb [arch=A] B C -D" where A is the host's native architecture, B is the I, C is the -given I and D is the components given via B<--components> (defaults to -"main"). If a I option happens to be an existing file, then its -contents are pasted into the chroot's sources.list. This can be used to supply -a deb822 style sources.list. If I is C<-> then standard input is pasted -into the chroot's sources.list. More than one mirror can be specified and are -appended to the chroot's sources.list in the given order. If you specify a -https or tor I and you want the chroot to be able to update itself, -don't forget to also install the ca-certificates package, the -apt-transport-https package for apt versions less than 1.5 and/or the -apt-transport-tor package using the B<--include> option, as necessary. - -The optional I argument can either be the path to a directory, the path -to a tarball filename, the path to a squashfs image, the path to an ext2 image, -a FIFO, a character special device, or C<->. Without the B<--format> option, -I will be used to choose the format. See the section B for -more information. If no I was specified or if I is C<->, an -uncompressed tarball will be sent to standard output. - -The I may be a valid release code name (eg, sid, stretch, jessie) or a -symbolic name (eg, unstable, testing, stable, oldstable). Any suite name that -works with apt on the given mirror will work. If no I was specified, -then a single I C<-> is added and thus the information of the desired -suite has to come from standard input as part of a valid apt sources.list file. +complex dependency relationships. See section B for an overview of +how B works internally. + +The I option may either be a valid release code name (eg, sid, bookworm, +trixie) or a symbolic name (eg, unstable, testing, stable, oldstable). Any +suite name that works with apt on the given mirror will work. The I +option is optional if no I and no I option is provided. If +I is missing, then the information of the desired suite has to come from +standard input as part of a valid apt sources.list file or be set up via hooks. The value of the I argument will be used to determine which apt index to use for finding out the set of C packages and/or the set of -packages with the right priority for the selected variant. See the section +packages with the right priority for the selected variant. This functionality +can be disabled by choosing the empty string for I. See the section B for more information. +The I option may either be the path to a directory, the path to a +tarball filename, the path to a squashfs image, the path to an ext2 image, a +FIFO, a character special device, or C<->. The I option is optional if +no I option is provided. If I is missing or if I is +C<->, an uncompressed tarball will be sent to standard output. Without the +B<--format> option, I will be used to choose the format. See the +section B for more information. + +The I option may either be provided as a URI, in apt one-line format, +as a path to a file in apt's one-line or deb822-format, or C<->. If no +I option is provided, then L is used as +the default. If I does not refer to "unstable" or "testing", then +I-updates and I-security mirrors are automatically added. If a +I option starts with "deb " or "deb-src " then it is used as a one-line +format entry for apt's sources.list inside the chroot. If a I option +contains a "://" then it is interpreted as a mirror URI and the apt line inside +the chroot is assembled as "deb [arch=A] B C D" where A is the host's native +architecture, B is the I, C is the given I and D is the +components given via B<--components> (defaults to "main"). If a I +option happens to be an existing file, then its contents are written into the +chroot's sources.list (if the first I is a file in one-line format) or +into the chroot's sources.list.d directory, named with the extension .list or +.sources, depending on whether the file is in one-line or deb822 format, +respectively. If I is C<-> then standard input is pasted into the +chroot's sources.list. More than one mirror can be specified and are appended +to the chroot's sources.list in the given order. If you specify a https or tor +I and you want the chroot to be able to update itself, don't forget to +also install the ca-certificates package, the apt-transport-https package for +apt versions less than 1.5 and/or the apt-transport-tor package using the +B<--include> option, as necessary. + All status output is printed to standard error unless B<--logfile> is used to redirect it to a file or B<--quiet> or B<--silent> is used to suppress any output on standard error. Help and version information will be printed to