From 831257e130cdc99895cc6abcd25f20253f1619ec Mon Sep 17 00:00:00 2001 From: Colin Watson Date: Tue, 15 Jan 2008 11:16:58 +0000 Subject: * Minor manual page formatting improvements. r50883 --- debian/changelog | 1 + debootstrap.8 | 51 +++++++++++++++++++++++++++++---------------------- 2 files changed, 30 insertions(+), 22 deletions(-) diff --git a/debian/changelog b/debian/changelog index b8b9824..1daff2c 100644 --- a/debian/changelog +++ b/debian/changelog @@ -26,6 +26,7 @@ debootstrap (1.0.8) UNRELEASED; urgency=low [ Colin Watson ] * Add minbase variant for Ubuntu gutsy/hardy; see Anthony's change above. + * Minor manual page formatting improvements. -- Anthony Towns Fri, 07 Dec 2007 18:57:24 +1000 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 -- cgit v0.12