diff --git a/debian/changelog b/debian/changelog index 8e2bcbd..15d0a2e 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,16 @@ +ubuntu-dev-tools (0.101) UNRELEASED; urgency=low + + * syncpackage: Update manpage to reflect current usage. (Closes: #587142, + LP: #598477) + * ubuntu-build: Update manpage to reflect current usage. (LP: #490535) + * edit-patch: Add manpage. (LP: #538379) + * massfile: Add manpage. + * pull-debian-debdiff: Add manpage. + * setup-packaging-environment: Add manpage. + * ubuntu-iso: Add manpage. + + -- Andrew Starr-Bochicchio Sat, 26 Jun 2010 14:40:48 -0400 + ubuntu-dev-tools (0.100) maverick; urgency=low [ Luca Falavigna ] diff --git a/doc/edit-patch.1 b/doc/edit-patch.1 new file mode 100644 index 0000000..3e3b479 --- /dev/null +++ b/doc/edit-patch.1 @@ -0,0 +1,22 @@ +.TH EDIT-PATCH "1" "June 2010" "ubuntu-dev-tools" +.SH NAME +\fBedit-patch\fR \- tool for preparing patches for Debian source packages + +.SH SYNOPSIS +\fBedit-patch\fR + +.SH DESCRIPTION +\fBedit-patch\fR is a wrapper script around the quilt, cdbs, and dpatch patch systems. It simplifies the process of preparing and editing patches to Debian source packages and allows the user to not have to be concerned with which patch system is in use. Run from inside the root directory of the source package, \fBedit-patch\fR can be used to edit existing patches located in /debian/patches. + +It can also be used to incorporate new patches. If pointed a patch not already present, it will copy the patch to /debian/patches in the correct format for the patch system in use. Next, the patch is applied and a subshell is opened in order to edit the patch. Typing "exit" or hitting Ctrl-d will close the subshell and launch an an editor to record the debian/changelong entry. + +\fBedit-patch\fR is integrated with the bzr and git version control systems. The patch will be automatically added to the tree, and the debian/changelong entry will be used as the commit message. + +If no patch system is present, the patch is applied inline, and a copy is stored in debian/patches-applied. + +.SH AUTHORS +\fBedit-patch\fR was written by Daniel Holbach , Michael Vogt , and David Futcher . + +This manual page was written by Andrew Starr-Bochicchio . +.PP +Both are released under the terms of the GNU General Public License, version 3. diff --git a/doc/massfile.1 b/doc/massfile.1 new file mode 100644 index 0000000..99891e8 --- /dev/null +++ b/doc/massfile.1 @@ -0,0 +1,45 @@ +.TH MASSFILE "1" "June 2010" "ubuntu-dev-tools" +.SH NAME +\fBmassfile\fR \- script for massfiling bugs against Ubuntu packages + +.SH SYNOPSIS +\fBmassfile\fR + +.SH DESCRIPTION +\fBmassfile\fR is a script for massfiling bugs against Ubuntu packages in Launchpad. It requires an instructions file describing the contents of the bug report and a list file which lists the packages which the bug will be filed against. + +Templates for both files can be found in /usr/share/doc/ubuntu-dev-tools/examples. + +.SH EXAMPLES +\fBmassfile.instructions\fR - file designating the contents of the bug report + + subject: [UNMETDEPS] $pack has unmet dependencies + assignee: + status: confirmed + subscribers: motu + tags: unmetdeps + buglist-url: http://bugs.launchpad.net/ubuntu/+bugs?field.tag=unmetdeps + text: + A run of + . + LC_ALL=C apt-cache \-i unmet | grep ^Package | cut \-d' ' \-f2 | grep + \-v dbgsym | sort \-u | xargs apt-cache showsrc | grep ^Directory | + sed 's/Package\:\ //g' | grep verse | cut \-d'/' \-f4 + indicates that the source package $pack has binary packages that are + not installable (on AMD64) at the moment. + . + Please have a look and make sure it's installable again. + +\fBmassfile.list\fR - file designating the packages affected + +Each package should be listed on a new line as follows: + + z88dk + zope-quotafolder + +.SH AUTHORS +\fBmassfile\fR was written by Iain Lane , Daniel Hahler . and Markus Korn . + +This manual page was written by Andrew Starr-Bochicchio . +.PP +Both are released under the terms of the GNU General Public License, version 3. diff --git a/doc/pull-debian-debdiff.1 b/doc/pull-debian-debdiff.1 new file mode 100644 index 0000000..88d3e8b --- /dev/null +++ b/doc/pull-debian-debdiff.1 @@ -0,0 +1,16 @@ +.TH PULL-DEBIAN-DEBDIFF "1" "June 2010" "ubuntu-dev-tools" +.SH NAME +\fBpull-debian-debdiff\fR \- find, download, and generate a debdiff + +.SH SYNOPSIS +\fBpull-debian-debdiff\fR + +.SH DESCRIPTION +\fBpull-debian-debdiff\fR attempts to find and download a specific version of a Debian package and its immediate parent to generate a debdiff. + +.SH AUTHORS +\fBpull-debian-debdiff\fR was written by Kees Cook . + +This manual page was written by Andrew Starr-Bochicchio . +.PP +Both are released under the terms of the GNU General Public License, version 3, or (at your option) any later version. diff --git a/doc/setup-packaging-environment.1 b/doc/setup-packaging-environment.1 new file mode 100644 index 0000000..79c07b0 --- /dev/null +++ b/doc/setup-packaging-environment.1 @@ -0,0 +1,16 @@ +.TH PULL-DEBIAN-DEBDIFF "1" "June 2010" "ubuntu-dev-tools" +.SH NAME +\fBsetup-packaging-environment\fR \- helps to get started with Ubuntu development + +.SH SYNOPSIS +\fBsetup-packaging-environment\fR + +.SH DESCRIPTION +\fBsetup-packaging-environment\fR aims to make it more straightforward for new contributors to get their Ubuntu installation ready for packaging work. It ensures that all four components from Ubuntu's official repositories are enabled along with their corresponding source repositories. It also installs a minimal set of packages needed for Ubuntu packaging work (ubuntu-dev-tools, devscripts, debhelper, cdbs, patchutils, pbuilder, and build-essential). Finally, it assists in defining the DEBEMAIL and DEBFULLNAME environment variables. + +.SH AUTHORS +\fBsetup-packaging-environment\fR was written by Siegfried-A. Gevatter . + +This manual page was written by Andrew Starr-Bochicchio . +.PP +Both are released under the terms of the GNU General Public License, version 3 or later. diff --git a/doc/syncpackage.1 b/doc/syncpackage.1 index 61d6915..ed2733d 100644 --- a/doc/syncpackage.1 +++ b/doc/syncpackage.1 @@ -1,8 +1,9 @@ -.TH SYNCPACKAGE "1" "15 April 2008" "ubuntu-dev-tools" +.TH SYNCPACKAGE "1" "June 2010" "ubuntu-dev-tools" .SH NAME syncpackage \- helper to prepare .changes file to upload synced packages .SH SYNOPSIS -.B syncpacage\fR \fB<.dsc file>\fR \fB\fR +.B syncpackage +[\fIoptions\fR] \fI<.dsc URL/path or package name>\fR .SH DESCRIPTION \fBsyncpackage\fR generates a changes file to be directly uploaded to Ubuntu primary archive or PPA starting from a pristine Debian package. @@ -10,15 +11,42 @@ primary archive or PPA starting from a pristine Debian package. \fBsyncpackage\fR allows you to upload files with the same checksums of the Debian ones, as the common script used by Ubuntu archive administrators does, this way you can preserve source files integrity between the two distributions. +.PP +\fBsyncpackage\fR will detect source tarballs with mismatching checksums and will automatically create fake syncs instead. .SH OPTIONS -.B <.dsc file> -This is the .dsc file to generate .changes file against. .TP -.B -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. +\fB\-h\fR, \fB\-\-help\fR +Show help message and exit +.TP +\fB\-d\fR DIST, \fB\-\-distribution\fR=\fIDIST\fR +Debian distribution to sync from. +.TP +\fB\-r\fR RELEASE, \fB\-\-release\fR=\fIRELEASE\fR +Specify target Ubuntu release. +.TP +\fB\-V\fR DEBVERSION, \fB\-\-debian\-version\fR=\fIDEBVERSION\fR +Specify the version to sync from. +.TP +\fB\-c\fR COMPONENT, \fB\-\-component\fR=\fICOMPONENT\fR +Specify the component to sync from. +.TP +\fB\-v\fR, \fB\-\-verbose\fR +print more information +.TP +\fB\-u\fR UPLOADER, \fB\-\-uploader\fR=\fIUPLOADER\fR +Use UPLOADER as the name and email address of the +maintainer for this upload instead of evaluating +DEBFULLNAME and DEBEMAIL. +.TP +\fB\-k\fR KEYID, \fB\-\-key\fR=\fIKEYID\fR +Specify the key ID to be used for signing. +.TP +\fB\-b\fR BUG, \fB\-\-bug\fR=\fIBUG\fR +Mark a Launchpad bug as being fixed by this upload +.PP .SH AUTHOR -.B requestsync +\fBsyncpackage\fR was written by Martin Pitt and Benjamin Drung . +.PP This manual page were written by Luca Falavigna .PP -It is released under GNU General Public License, version 3. +Both are released under GNU General Public License, version 3. diff --git a/doc/ubuntu-build.1 b/doc/ubuntu-build.1 index 1329484..27d722d 100644 --- a/doc/ubuntu-build.1 +++ b/doc/ubuntu-build.1 @@ -1,11 +1,9 @@ -.TH UBUNTU-BUILD "1" "14 August 2008" "ubuntu-dev-tools" +.TH UBUNTU-BUILD "1" "June 2010" "ubuntu-dev-tools" .SH NAME ubuntu-build \- command-line interface to Launchpad build operations .SH SYNOPSIS .B ubuntu-build -.br -.B ubuntu-build \-\-help .SH DESCRIPTION \fBubuntu-build\fR provides a command line interface to the Launchpad build @@ -38,10 +36,38 @@ Listed below are the command line options for \fBubuntu-build\fR: .B \-h or \-\-help Display a help message and exit. .TP -.B \-a or \-\-architecture -Only available for \fIrescore\fR and \fIretry\fR operations only. -This will only request the rebuilding/rescoring on the specified -architecture. +Retry and rescore options: +.IP +These options may only be used with the 'retry' and 'rescore' +operations. +.IP +\fB\-a\fR ARCHITECTURE, \fB\-\-arch\fR=\fIARCHITECTURE\fR +Rebuild or rescore a specific architecture. Valid +architectures include: amd64, sparc, powerpc, i386, +armel, ia64, lpia, hppa. +.TP +Batch processing: +.IP +These options and parameter ordering is only available in \fB\-\-batch\fR +mode. Usage: ubuntu\-build \fB\-\-batch\fR [options] ... +.IP +\fB\-\-batch\fR +Enable batch mode +.IP +\fB\-\-series\fR=\fISERIES\fR +Selects the Ubuntu series to operate on (default: +current development series) +.IP +\fB\-\-retry\fR +Retry builds (give\-back). +.IP +\fB\-\-rescore\fR=\fIPRIORITY\fR +Rescore builds to . +.IP +\fB\-\-arch2\fR=\fIARCHITECTURE\fR +Affect only 'architecture' (can be used several +times). Valid architectures are: amd64, sparc, +powerpc, i386, armel, ia64, lpia, hppa. .SH AUTHORS \fBubuntu-build\fR was written by Martin Pitt , and diff --git a/doc/ubuntu-iso.1 b/doc/ubuntu-iso.1 new file mode 100644 index 0000000..7dfcbb7 --- /dev/null +++ b/doc/ubuntu-iso.1 @@ -0,0 +1,16 @@ +.TH UBUNTU_ISO "1" "June 2010" "ubuntu-dev-tools" +.SH NAME +\fBubuntu-iso\fR \- tool to examine Ubuntu CD (ISO) installation media + +.SH SYNOPSIS +\fBubuntu-iso\fR + +.SH DESCRIPTION +When given a path to an ISO, \fBubuntu-iso\fR will determine whether it is an an Ubuntu ISO or not. If it is, it will extract and display the version information. + +.SH AUTHORS +\fBubuntu-iso\fR was written by Matt Zimmerman . + +This manual page was written by Andrew Starr-Bochicchio . +.PP +Both are released under the terms of the GNU General Public License, version 2.