Lubuntu/ubuntu-dev-tools
3
0
Fork 0
mirror of https://git.launchpad.net/ubuntu-dev-tools synced 2025-03-13 08:01:09 +00:00
Code Issues Packages Projects Releases Wiki Activity

* Fix *roff use (hyphens vs. dashes, start each sentence on a new line).

Browse Source
This commit is contained in:
Colin Watson 2007-09-12 09:29:58 +01:00
parent f8d9952742
commit afb3b7ad12
3 changed files with 60 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
debian/changelog vendored
View File

@ -1,3 +1,9 @@
ubuntu-dev-tools (0.7) UNRELEASED; urgency=low
* Fix *roff use (hyphens vs. dashes, start each sentence on a new line).
-- Colin Watson <cjwatson@ubuntu.com> Wed, 12 Sep 2007 09:28:54 +0100
ubuntu-dev-tools (0.6) gutsy; urgency=low ubuntu-dev-tools (0.6) gutsy; urgency=low
* Because I'm a bozo, fix up the version of the devscripts * Because I'm a bozo, fix up the version of the devscripts

83
doc/pbuilder-dist.1
View File

@ -3,88 +3,99 @@
.\" Contact details: siggi.gevatter@gmail.com .\" Contact details: siggi.gevatter@gmail.com
.\" August 16, 2007 .\" August 16, 2007
.\" .\"
.TH PBUILDER-DIST 1 "August 16, 2007" .TH PBUILDER\-DIST 1 "August 16, 2007"
.\" .\"
.SH NAME .SH NAME
pbuilder-dist \- multi-distribution pbuilder wrapper pbuilder\-dist \- multi-distribution pbuilder wrapper
.\" .\"
.SH SYNOPSIS .SH SYNOPSIS
\fBpbuilder-dist\fP \fIdistribution\fR [\fBi386\fP|\fBamd64\fP] [\fBmainonly\fP|\fBallcomp\fP] \fBpbuilder\-dist\fP \fIdistribution\fR [\fBi386\fP|\fBamd64\fP] [\fBmainonly\fP|\fBallcomp\fP]
[\fBwithlog\fP|\fBnolog\fP] \fIoperation\fR [\fI...\fR] [\fBwithlog\fP|\fBnolog\fP] \fIoperation\fR [\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
versions of Ubuntu and / or Debian. versions of Ubuntu and/or Debian.
.PP .PP
It is common to symlink this script in order to give it many names in the form of It is common to symlink this script in order to give it many names in the form of
\fBpbuilder-\fIdistribution\fP\fR (\fBpbuilder-\fIdistribution\fR-\fIarchitecture\fP\fR on amd64 \fBpbuilder\-\fIdistribution\fP\fR (\fBpbuilder\-\fIdistribution\fR\-\fIarchitecture\fP\fR on amd64
systems), like for example \fBpbuilder-feisty\fP, \fBpbuilder-sid\fP, \fBpbuilder-gutsy-i386\fP, etc. systems), like for example \fBpbuilder\-feisty\fP, \fBpbuilder\-sid\fP, \fBpbuilder\-gutsy\-i386\fP, etc.
.\" .\"
.SH USAGE .SH USAGE
There are many arguments listed on the synopsis. Each of them, if used, has to be used There are many arguments listed on the synopsis.
exactly in the same order as it appears there. In case you renamed the script to Each of them, if used, has to be used exactly in the same order as it
\fBpbuilder-\fIdistribution\fP\fR, do not use the \fBdistribution\fP parameter; same with appears there.
\fBi386\fP / \fBamd64\fP if the name also contains -\fIarchitecture\fR. In case you renamed the script to \fBpbuilder\-\fIdistribution\fP\fR, do not
use the \fBdistribution\fP parameter; same with \fBi386\fP / \fBamd64\fP if
the name also contains \-\fIarchitecture\fR.
.TP .TP
\fBdistribution\fP \fBdistribution\fP
Replace this with the codename of the version of Ubuntu or Debian you want to use. Replace this with the codename of the version of Ubuntu or Debian you want to use.
.TP .TP
\fBi386\fP / \fBamd64\fP \fBi386\fP / \fBamd64\fP
Only available on amd64 systems. This is optional; default is \fBamd64\fP. If \fBi386\fP is Only available on amd64 systems.
specified, an i386 environment will be used. This is optional; default is \fBamd64\fP.
If \fBi386\fP is specified, an i386 environment will be used.
.TP .TP
\fBmainonly\fP / \fBallcomp\fP \fBmainonly\fP / \fBallcomp\fP
This is optional; default is \fBallcomp\fP. If you specify \fBmainonly\fP, only packages from This is optional; default is \fBallcomp\fP.
the main (in Debian) or main and restricted (in Ubuntu) components will be used. With the If you specify \fBmainonly\fP, only packages from the main (in Debian) or
later one, all official components will be enabled. This only has effect when creating a new main and restricted (in Ubuntu) components will be used.
environment. With the latter one, all official components will be enabled.
This only has effect when creating a new environment.
.TP .TP
\fBwithlog\fP / \fBnolog\fP \fBwithlog\fP / \fBnolog\fP
This is optional; default is \fBnolog\fP. When \fBwithlog\fP is used, \fBpbuilder\fP will save the This is optional; default is \fBnolog\fP.
output produced by the current action in a dot-file called \fB.lastlog\fP in it's base directory When \fBwithlog\fP is used, \fBpbuilder\fP will save the output produced by
(see the FILES section). If this file already exists, it will be overwritten. the current action in a dot-file called \fB.lastlog\fP in its base directory
(see the FILES section).
If this file already exists, it will be overwritten.
.TP .TP
\fBoperation\fP \fBoperation\fP
Replace this with the action you want \fBpbuilder\fP to do (create, update, build, clean, login Replace this with the action you want \fBpbuilder\fP to do (create, update, build, clean, login
or execute). Check it's manpage for more details. or execute).
Check its manpage for more details.
.TP .TP
\fB[...]\fP \fB[...]\fP
.br .br
Replace this with other parameters, if needed. For example, if \fBbuild\fP is the option, Replace this with other parameters, if needed.
you will need to also specify a .dsc file. For example, if \fBbuild\fP is the option, you will need to also specify
a .dsc file.
.PP .PP
The default value of all optional parameters (except the architecture) can be changed by The default value of all optional parameters (except the architecture) can be changed by
editing the first lines of the script. editing the first lines of the script.
.\" .\"
.SH EXAMPLES .SH EXAMPLES
.TP .TP
pbuilder-dist gutsy create pbuilder\-dist gutsy create
Creates a \fBpbuilder\fP environment for Ubuntu Gutsy, with all components enabled. Creates a \fBpbuilder\fP environment for Ubuntu Gutsy, with all components enabled.
.TP .TP
pbuilder-sid mainonly create pbuilder\-sid mainonly create
Creates a \fBpbuilder\fP environment for Debian Sid, with only the main component. Creates a \fBpbuilder\fP environment for Debian Sid, with only the main component.
.TP .TP
pbuilder-feisty build ./sample_1.0-0ubuntu1.dsc pbuilder\-feisty build ./sample_1.0\-0ubuntu1.dsc
Builds the specified package on an already existing Ubuntu Feisty environment. Builds the specified package on an already existing Ubuntu Feisty environment.
.TP .TP
pbuilder-dist feisty withlog build ./sample_1.0-0ubuntu1.dsc pbuilder\-dist feisty withlog build ./sample_1.0\-0ubuntu1.dsc
Same as above, but stores \fBpbuilder\fP's output on a file. Same as above, but stores \fBpbuilder\fP's output on a file.
.TP .TP
pbuilder-etch i386 update pbuilder\-etch i386 update
Updates an existing i386-architecture Debian Etch environment on an amd64 system. Updates an existing i386-architecture Debian Etch environment on an amd64 system.
.\" .\"
.SH FILES .SH FILES
By default, \fBpbuilder-dist\fP will store all the files it generates in \fB~/pbuilder/\fP. This can By default, \fBpbuilder\-dist\fP will store all the files it generates in \fB~/pbuilder/\fP.
be changed modifying the BASE_DIR value on the top of the script to any other directory you This can be changed by modifying the BASE_DIR value on the top of the script
want. If it doesn't exist, it will be created on the run. to any other directory you want.
If it doesn't exist, it will be created on the run.
.\" .\"
.SH BUGS .SH BUGS
There are no known bugs at the moment. If you experience any problem with this script There are no known bugs at the moment.
contact me on siggi.gevatter@gmail.com. Please ensure first that the problem is really this If you experience any problem with this script contact me on
script and not an issue with \fBpbuilder\fP. siggi.gevatter@gmail.com.
Please ensure first that the problem is really this script and not an issue
with \fBpbuilder\fP.
.\" .\"
.SH AUTHORS .SH AUTHORS
\fBpbuilder-dist\fP was originally written by Jamin W. Collins <jcollins@asgardsrealm.net> and \fBpbuilder\-dist\fP was originally written by Jamin W. Collins <jcollins@asgardsrealm.net> and
Jordan Mantha <mantha@ubuntu.com>. Jordan Mantha <mantha@ubuntu.com>.
.PP .PP
On August 2007 it was mostly rewritten, and extended, by Siegfried-Angel Gevatter Pujals On August 2007 it was mostly rewritten, and extended, by Siegfried-Angel Gevatter Pujals
@ -101,4 +112,4 @@ under the terms of the GNU General Public License,
Version 2 or any later version published by the Free Software Foundation. Version 2 or any later version published by the Free Software Foundation.
.PP .PP
On Debian based systems, the complete text of the GNU General Public On Debian based systems, the complete text of the GNU General Public
License can be found in \fB/usr/share/common-licenses/GPL\fP. License can be found in \fB/usr/share/common\-licenses/GPL\fP.

11
doc/requestsync.1
View File

@ -3,7 +3,7 @@
requestsync \- helper to file sync requests for Ubuntu requestsync \- helper to file sync requests for Ubuntu
.SH SYNOPSIS .SH SYNOPSIS
.B requestsync .B requestsync
.RI [\fI -n | -s \fR] " " <\fIsource\fR " " \fIpackage\fR> " " <\fItarget\fR " " \fIrelease\fR> " "[\fIbase\fR " " \fIversion\fR] .RI [\fI \-n | \-s \fR] " " <\fIsource\fR " " \fIpackage\fR> " " <\fItarget\fR " " \fIrelease\fR> " "[\fIbase\fR " " \fIversion\fR]
.SH DESCRIPTION .SH DESCRIPTION
.PP .PP
\fBrequestsync\fR looks at the versions of <source package> in Debian and Ubuntu, prompts for an explanation of why the Ubuntu changes (if there are any) should be dropped, downloads the changelog entry from packages.debian.org, and then prompts for your GPG passphrase so it can sign the mail and send it off, which files a sync request in the form of a bug report in Launchpad. \fBrequestsync\fR looks at the versions of <source package> in Debian and Ubuntu, prompts for an explanation of why the Ubuntu changes (if there are any) should be dropped, downloads the changelog entry from packages.debian.org, and then prompts for your GPG passphrase so it can sign the mail and send it off, which files a sync request in the form of a bug report in Launchpad.
@ -15,16 +15,19 @@ Listed below are the command line options for requestsync:
Specifies that the package is a new package, and requestsync should not attempt to look it up in Ubuntu since it will not exist. Specifies that the package is a new package, and requestsync should not attempt to look it up in Ubuntu since it will not exist.
.TP .TP
\fB\-s\fR \fB\-s\fR
Specifies that you require sponsorship. You need this option if you are not a member of ubuntu-dev for universe or multiverse, or ubuntu-core-dev for main or restricted. Specifies that you require sponsorship.
You need this option if you are not a member of ubuntu-dev for universe or multiverse, or ubuntu-core-dev for main or restricted.
.TP .TP
\fB<source package>\fR \fB<source package>\fR
This is the source package that you would like to be synced from Debian. This is the source package that you would like to be synced from Debian.
.TP .TP
\fB<target release>\fR \fB<target release>\fR
This is the release that you would like the source package to be synced into. This should always be the latest development release of Ubuntu, ie: gutsy. This is the release that you would like the source package to be synced into.
This should always be the latest development release of Ubuntu, ie: gutsy.
.TP .TP
\fB[base version]\fR \fB[base version]\fR
In some cases, the base version (where the Ubuntu package started differing from the Debian package) can not be automatically determined. Specify this option in this case. In some cases, the base version (where the Ubuntu package started differing from the Debian package) can not be automatically determined.
Specify this option in this case.
.SH AUTHOR .SH AUTHOR
.PP .PP
This manual page was pieced together by Steve Kowalik. This manual page was pieced together by Steve Kowalik.