* doc/pbuilder-dist.1:

- Move the documentation for --main-only (previously "mainonly") and
     --debug-echo to a new Options section.
* doc/pbuilder-dist.1: update manpage to indicate general architecture
This commit is contained in:
Siegfried-Angel Gevatter Pujals 2010-09-21 21:48:33 +02:00
parent f0db65419b
commit ebff8fe69f
3 changed files with 32 additions and 24 deletions

5
debian/changelog vendored
View File

@ -20,6 +20,9 @@ ubuntu-dev-tools (0.103) UNRELEASED; urgency=low
quotation marks, when needed (LP: #398989).
* bash_completion/pbuilder-dist:
- Enable auto-completion for "pbuilder-experimental".
* doc/pbuilder-dist.1:
- Move the documentation for --main-only (previously "mainonly") and
--debug-echo to a new Options section.
-- Siegfried-Angel Gevatter Pujals <rainct@ubuntu.com> Tue, 21 Sep 2010 20:43:27 +0200
@ -243,7 +246,7 @@ ubuntu-dev-tools (0.94) lucid; urgency=low
* mk-sbuild: switch to use qemu-debootstrap for foreign chroots
* mk-sbuild: allow any foreign chroot (may not work, but we can try)
* pbuilder-dist: allow any foreign chroot (may not work, but we can try)
* docs/pbuilder-dist.1: update manpage to indicate general architecture
* doc/pbuilder-dist.1: update manpage to indicate general architecture
* pbuilder-dist: add self. before target_distro in powerpc check
-- Emmet Hikory <persia@ubuntu.com> Mon, 08 Mar 2010 20:45:09 +0900

View File

@ -4,11 +4,11 @@
pbuilder\-dist, cowbuilder\-dist \- multi-distribution pbuilder/cowbuilder wrapper
.SH SYNOPSIS
\fBpbuilder\-dist\fP \fIdistribution\fR [\fIarchitecture\fR] [\fBmainonly\fP]
\fIoperation\fR [\fI...\fR]
\fBpbuilder\-dist\fP \fIdistribution\fR [\fIarchitecture\fR] \fIoperation\fR
[\fBoptions\fP] [\fI...\fR]
\fBcowbuilder\-dist\fP \fIdistribution\fR [\fIarchitecture\fR] [\fBmainonly\fP]
\fIoperation\fR [\fI...\fR]
\fBcowbuilder\-dist\fP \fIdistribution\fR [\fIarchitecture\fR] \fIoperation\fR
[\fBoptions\fP] [\fI...\fR]
.SH DESCRIPTION
\fBpbuilder\-dist\fP is a wrapper that makes it easy to use pbuilder with many different
@ -41,12 +41,6 @@ install), qemu-static and binfmt-misc will be used. Note that some
combinations (e.g. amd64 on an i386 install) require special separate
kernel handling, and may break in unexpected ways.
.TP
\fBmainonly\fP
If you specify \fBmainonly\fP, only packages from the main (in Debian) or
main and restricted (in Ubuntu) components will be used. By default, all
official components are enabled. This only has effect when creating a new
environment.
.TP
\fBoperation\fP
Replace this with the action you want \fBpbuilder\fP to do (create, update,
build, clean, login or execute).
@ -61,11 +55,18 @@ For example, if \fBbuild\fP is the option, you will need to also specify
a .dsc file. As a special feature, if you specify a .dsc file you can
skip the \fBbuild\fP option and this script will automatically assume that
building is the action you want to do.
.br
You may also specify \fB--debug-echo\fP so that the \fBpbuilder\fP/
\fBcowbuilder\fP command which would normally be executed is just printed
on the standard output instead. This is useful for debugging
\fBpbuilder-dist\fP.
.SH OPTIONS
.TP
\fB--main-only\fP (deprecated: \fBmainonly\fP)
If you specify this option, only packages from the \fImain\fP (in Debian) or
\fImain\fP and \fIrestricted\fP (in Ubuntu) components will be used. By
default, all official components are enabled. This only has effect when
creating a new environment.
.TP
\fB--debug-echo\fP
The generated \fBpbuilder\fP/\fBcowbuilder\fP command will be printed to the
standard output instead of being executed. This is useful for debugging.
.SH EXAMPLES
.TP
@ -89,14 +90,15 @@ Creates a \fBcowbuilder\fP environment for Debian Experimental.
.SH FILES AND ENVIRONMENT VARIABLES
By default, \fBpbuilder\-dist\fP will store all the files it generates in
\fB~/pbuilder/\fP. This can be changed by setting the $PBUILDFOLDER global
variable. If the directory doesn't exist, it will be created on the run.
\fB~/pbuilder/\fP. This can be changed by setting the \fBPBUILDFOLDER\fP
environment variable. If the directory doesn't exist, it will be created on
the run.
.PP
A file with the log of the last operation, called last_operation.log, will be
saved in the results subdirectory of each build environment.
.PP
The default authentication method is \fBsudo\fP. You can change this by
setting the $PBUILDAUTH variable.
setting the \fBPBUILDAUTH\fP variable.
.SH BUGS
If you experience any problem with this script contact me on rainct@ubuntu.com
@ -109,9 +111,9 @@ with \fBpbuilder\fP or \fBcowbuilder\fP themselves.
\fBpbuilder\fR, \fBpbuilderrc\fR, \fBcowbuilder\fR
.SH AUTHORS
\fBpbuilder\-dist\fP was written by Siegfried-A. Gevatter <rainct@ubuntu.com>
and includes patches by Iain Lane <iain@orangesquash.org.uk>. This manual page
has been written by Siegfried-A. Gevatter <rainct@ubuntu.com>.
\fBpbuilder\-dist\fP and this manual page were written by Siegfried-A. Gevatter
<rainct@ubuntu.com>, with contributions from Iain Lane
<iain@orangesquash.org.uk>, Emmet Hikory <persia@ubuntu.com> and others.
\fBpbuilder\-dist\fP is released under the GNU General Public License, version
2 or later.

View File

@ -344,9 +344,12 @@ def main():
("sparc64", "sparc")]:
args.append('--debootstrap qemu-debootstrap')
if 'mainonly' in sys.argv:
if 'mainonly' in sys.argv or '--main-only' in sys.argv:
app.extra_components = False
args.remove('mainonly')
if 'mainonly' in sys.argv:
args.remove('mainonly')
else:
args.remove('--main-only')
if len(args) < 1:
print 'Insufficient number of arguments.'