summaryrefslogtreecommitdiffstats
path: root/debootstrap.8
diff options
context:
space:
mode:
authorColin Watson <cjwatson@debian.org>2008-01-15 11:16:58 (GMT)
committerColin Watson <cjwatson@debian.org>2008-01-15 11:16:58 (GMT)
commit831257e130cdc99895cc6abcd25f20253f1619ec (patch)
tree3588dabb8e2814f9e034fd2d0bc60b2658a7fa67 /debootstrap.8
parente8380522af2635380df3f26d1494fdd36bbd8d47 (diff)
downloaddebootstrap-831257e130cdc99895cc6abcd25f20253f1619ec.zip
debootstrap-831257e130cdc99895cc6abcd25f20253f1619ec.tar.gz
debootstrap-831257e130cdc99895cc6abcd25f20253f1619ec.tar.bz2
* Minor manual page formatting improvements.
r50883
Diffstat (limited to 'debootstrap.8')
-rw-r--r--debootstrap.851
1 files changed, 29 insertions, 22 deletions
diff --git a/debootstrap.8 b/debootstrap.8
index f3110d1..11383d8 100644
--- a/debootstrap.8
+++ b/debootstrap.8
@@ -33,14 +33,16 @@ or similar is strongly recommended.
.PP
\fBDebootstrap\fR can be used to install Debian in a system without using an
installation disk but can also be used to run a different Debian flavor in a \fBchroot\fR
-environment. This way you can create a full (minimal) Debian installation which
+environment.
+This way you can create a full (minimal) Debian installation which
can be used for testing purposes (see the \fBEXAMPLES\fR section).
If you are looking for a chroot system to build packages please take a look at
\fBpbuilder\fR.
.SH "OPTIONS"
.PP
.IP "\fB\-\-arch=ARCH\fP"
-Set the target architecture (use if dpkg isn't installed). See also \-\-foreign.
+Set the target architecture (use if dpkg isn't installed).
+See also \-\-foreign.
.IP
.IP "\fB\-\-include=alpha,beta\fP"
Comma separated list of packages which will be added to download and extract
@@ -48,7 +50,8 @@ lists.
.IP
.IP "\fB\-\-exclude=alpha,beta\fP"
Comma separated list of packages which will be removed from download and
-extract lists. WARNING: you can and probably will exclude essential packages, be
+extract lists.
+WARNING: you can and probably will exclude essential packages, be
careful using this option.
.IP
.IP "\fB\-\-components=alpha,beta\fP"
@@ -56,16 +59,18 @@ Use packages from the listed components of the archive.
.IP
.IP "\fB\-\-no\-resolve\-deps\fP"
By default, debootstrap will attempt to automatically resolve any missing
-dependencies, warning if any are found. Note that this is not a complete
-dependency resolve in the sense of dpkg or apt, and that it is far better
-to specify the entire base system than rely on this option. With this
-option set, this behaviour is disabled.
+dependencies, warning if any are found.
+Note that this is not a complete dependency resolve in the sense of dpkg
+or apt, and that it is far better to specify the entire base system than
+rely on this option.
+With this option set, this behaviour is disabled.
.IP
.IP "\fB\-\-variant=minbase|buildd|fakechroot\fP"
-Name of the bootstrap script variant to use. Currently, the variants
-supported are minbase, which only includes essential packages and apt;
-buildd, which installs the build-essential packages into
-.IR TARGET
+Name of the bootstrap script variant to use.
+Currently, the variants supported are minbase, which only includes
+essential packages and apt; buildd, which installs the build-essential
+packages into
+.IR TARGET ;
and fakechroot, which installs the packages without root privileges.
The default, with no \fB\-\-variant=X\fP argument, is to create a base
Debian installation in
@@ -80,23 +85,25 @@ By default, Release file signatures are not checked.
Produce more info about downloading.
.IP
.IP "\fB\-\-print\-debs\fP"
-Print the packages to be installed, and exit. Note that a TARGET directory
-must be specified so debootstrap can download Packages files to determine
-which packages should be installed, and to resolve dependencies. The TARGET
-directory will be deleted unless \-\-keep\-debootstrap\-dir is specified.
+Print the packages to be installed, and exit.
+Note that a TARGET directory must be specified so debootstrap can
+download Packages files to determine which packages should be installed,
+and to resolve dependencies.
+The TARGET directory will be deleted unless \-\-keep\-debootstrap\-dir
+is specified.
.IP
.IP "\fB\-\-download\-only\fP"
-Download packages, but don't perform installation
+Download packages, but don't perform installation.
.IP
.IP "\fB\-\-foreign\fP"
Do the initial unpack phase of bootstrapping only, for example if the
-target architecture does not match the host architecture. A copy of
-debootstrap sufficient for completing the bootstrap process will be
-installed as /debootstrap/debootstrap in the target filesystem.
+target architecture does not match the host architecture.
+A copy of debootstrap sufficient for completing the bootstrap process
+will be installed as /debootstrap/debootstrap in the target filesystem.
.IP
.IP "\fB\-\-second\-stage\fP"
-Complete the bootstrapping process. Other arguments are generally not
-needed.
+Complete the bootstrapping process.
+Other arguments are generally not needed.
.IP
.IP "\fB\-\-second\-stage\-target=DIR\fP"
Run second stage in a subdirectory instead of root. (can be used to create
@@ -107,7 +114,7 @@ Don't delete the /debootstrap directory in the target after completing the
installation.
.IP
.IP "\fB\-\-unpack\-tarball=FILE\fP"
-Acquire .debs from tarball FILE instead of downloading via http
+Acquire .debs from tarball FILE instead of downloading via http.
.IP
.IP "\fB\-\-make\-tarball=FILE\fP"
Instead of bootstrapping, make a tarball (written to FILE) of the downloaded