* 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). quotation marks, when needed (LP: #398989).
* bash_completion/pbuilder-dist: * bash_completion/pbuilder-dist:
- Enable auto-completion for "pbuilder-experimental". - 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 -- 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: switch to use qemu-debootstrap for foreign chroots
* mk-sbuild: allow any foreign chroot (may not work, but we can try) * 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) * 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 * pbuilder-dist: add self. before target_distro in powerpc check
-- Emmet Hikory <persia@ubuntu.com> Mon, 08 Mar 2010 20:45:09 +0900 -- 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 pbuilder\-dist, cowbuilder\-dist \- multi-distribution pbuilder/cowbuilder wrapper
.SH SYNOPSIS .SH SYNOPSIS
\fBpbuilder\-dist\fP \fIdistribution\fR [\fIarchitecture\fR] [\fBmainonly\fP] \fBpbuilder\-dist\fP \fIdistribution\fR [\fIarchitecture\fR] \fIoperation\fR
\fIoperation\fR [\fI...\fR] [\fBoptions\fP] [\fI...\fR]
\fBcowbuilder\-dist\fP \fIdistribution\fR [\fIarchitecture\fR] [\fBmainonly\fP] \fBcowbuilder\-dist\fP \fIdistribution\fR [\fIarchitecture\fR] \fIoperation\fR
\fIoperation\fR [\fI...\fR] [\fBoptions\fP] [\fI...\fR]
.SH DESCRIPTION .SH DESCRIPTION
\fBpbuilder\-dist\fP is a wrapper that makes it easy to use pbuilder with many different \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 combinations (e.g. amd64 on an i386 install) require special separate
kernel handling, and may break in unexpected ways. kernel handling, and may break in unexpected ways.
.TP .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 \fBoperation\fP
Replace this with the action you want \fBpbuilder\fP to do (create, update, Replace this with the action you want \fBpbuilder\fP to do (create, update,
build, clean, login or execute). 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 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 skip the \fBbuild\fP option and this script will automatically assume that
building is the action you want to do. building is the action you want to do.
.br
You may also specify \fB--debug-echo\fP so that the \fBpbuilder\fP/ .SH OPTIONS
\fBcowbuilder\fP command which would normally be executed is just printed .TP
on the standard output instead. This is useful for debugging \fB--main-only\fP (deprecated: \fBmainonly\fP)
\fBpbuilder-dist\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 .SH EXAMPLES
.TP .TP
@ -89,14 +90,15 @@ Creates a \fBcowbuilder\fP environment for Debian Experimental.
.SH FILES AND ENVIRONMENT VARIABLES .SH FILES AND ENVIRONMENT VARIABLES
By default, \fBpbuilder\-dist\fP will store all the files it generates in 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 \fB~/pbuilder/\fP. This can be changed by setting the \fBPBUILDFOLDER\fP
variable. If the directory doesn't exist, it will be created on the run. environment variable. If the directory doesn't exist, it will be created on
the run.
.PP .PP
A file with the log of the last operation, called last_operation.log, will be A file with the log of the last operation, called last_operation.log, will be
saved in the results subdirectory of each build environment. saved in the results subdirectory of each build environment.
.PP .PP
The default authentication method is \fBsudo\fP. You can change this by The default authentication method is \fBsudo\fP. You can change this by
setting the $PBUILDAUTH variable. setting the \fBPBUILDAUTH\fP variable.
.SH BUGS .SH BUGS
If you experience any problem with this script contact me on rainct@ubuntu.com 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 \fBpbuilder\fR, \fBpbuilderrc\fR, \fBcowbuilder\fR
.SH AUTHORS .SH AUTHORS
\fBpbuilder\-dist\fP was written by Siegfried-A. Gevatter <rainct@ubuntu.com> \fBpbuilder\-dist\fP and this manual page were written by Siegfried-A. Gevatter
and includes patches by Iain Lane <iain@orangesquash.org.uk>. This manual page <rainct@ubuntu.com>, with contributions from Iain Lane
has been written by Siegfried-A. Gevatter <rainct@ubuntu.com>. <iain@orangesquash.org.uk>, Emmet Hikory <persia@ubuntu.com> and others.
\fBpbuilder\-dist\fP is released under the GNU General Public License, version \fBpbuilder\-dist\fP is released under the GNU General Public License, version
2 or later. 2 or later.

View File

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