Differences between revisions 25 and 26
Revision 25 as of 2006-11-12 13:38:16
Size: 5183
Editor: ?TuukkaHastrup
Comment: mirror use
Revision 26 as of 2007-09-22 23:58:16
Size: 5029
Comment: pdebuild/pbuilder never signs packages unless --auto-debsign is used
Deletions are marked like this. Additions are marked like this.
Line 66: Line 66:
{{{pdebuild}}} (invoked in the package directory) builds the new source package and the binary package(s) in one go. If you do not want to sign the source nor the changes (because you do not intend to upload the package), use
{{{
pdebuild --debbuildopts '-us -uc'
}}}
{{{pdebuild}}} (invoked in the package directory) builds the new source package and the binary package(s) in one go.

(what you have to know for your 1st BSP)

Note: this is a rough draft, written by a guy that never fixed a bug before... so any additions, improvements, etc. are very welcome.

Picking RC bugs

The first thing you do is, of course: pick yourself a bug. If you are new to bug squashing it can be quite daunting to find a bug appropriate for your skill level. There is a [http://people.debian.org/~vorlon/rc-bugsquashing.html primer] on how to choose RC bugs which should help you. A list of RC bugs are found on [http://bugs.debian.org/release-critical/ bugs.debian.org]. But a much more flexible list is found on [http://bts.turmzimmer.net/details.php?bydist=both&ignnew=on&ignpending=on&ignmerged=on bts.turmzimmer.net].

Claiming bugs

Before you start to work on a bug you should announce your intention on #debian-bugs (on irc.debian.org) and claim it using the script [http://svn.madduck.net/pub/bin/debian/claimbug claimbug] (./claimbug --help). Your bug will then be marked as claimed on [http://bts.turmzimmer.net] after about 15-30 minutes. Additionally, you can add a comment to your bug at [http://bts.turmzimmer.net/details.php].

Fixing bugs

Getting the source

To ensure that you get the latest source for the package check [http://incoming.debian.org] and [http://packages.qa.debian.org]. Go to the directory where you want to edit the source and get all the required files with

dget -x [url to the dsc file]

(dget is in the devscripts package).

Before hacking

In the package direcory do dch -i. This invokes an editor with an already prepared update of the changelog. First, the new version number should be adjusted, according to the following scheme (applies to non-maintainer uploads):

  • if the old version was package-X-Y then the new version number is package-X-Y.1

  • if the old version was package-X-Y.2 then the new version number is package-X-Y.3

  • if the old version was simply package-X then the new version is package-X-0.1

On the first line after the package version, mark your changes as non-maintainer upload:

  * Non-maintainer upload

On the next lines explain what the changes will be, e.g.

  * Fixed this and that (closes: #123456).

Note: Non-maintainer uploads should contain only minimal changes, and only changes relating to RC bugs.

Actually fix the bug

Fix the bug (how? The answer is beyond the scope of this HOWTO).

Build the new source and binary package(s)

Quick and dirty

There is the quick and dirty method (for testing purposes). After installing all build-depends (apt-get build-dep [package]) for the package,

fakeroot debian/rules binary

builds a deb which you can install (but not upload).

Using pbuilder

The recommended method is to use pbuilder - for several reasons:

  • your system does not get cluttered with all the packages necessary to satisfy the build-depends
  • the build-depends are taken care of automatically
  • the package is created in a clean, minimal environment. This ensures that the package will build on (presumably) any system, and not just your own.

If you want more details on pbuilder read the [http://www.netfort.gr.jp/~dancer/software/pbuilder-doc/pbuilder-doc.html manual]. Here we willl just describe what steps are needed to build the package.

You can use the default configuration if you just install the pbuilder and cdebootstrap packages.

First, create a base chroot image with

sudo pbuilder create

This creates /var/cache/pbuilder/base.tgz. As you're downloading a lot of packages, you might want to append --mirror http://192.168.2.248/debian/ or so. If you already have such a base chroot image update it with

sudo pbuilder update

pdebuild (invoked in the package directory) builds the new source package and the binary package(s) in one go. The resulting binary package(s) are found in /var/cache/pbuilder/result/.

Test the new binary package(s)

Using pbuilder

To test your newly created packages by installing them into your base chroot image:

sudo pbuilder login --bindmounts /var/cache/pbuilder/result/

and inside the chroot:

dpkg -i /var/cache/pbuilder/result/*.deb

Congratulations, if everything works. Next, upload a patch to the bug tracking system and consider to upload the fixed package.

Upload patch to the bug tracking system

Create the diff-file with

debdiff old-package.dsc new-package.dsc > new-package.diff

and send it (as attachment) to [bugnumber]@bugs.debian.org together with some (friendly) explanations if necessary.

Tag the bug as "patch available" by sending an email to control@bugs.debian.org with the following content:

tags [bugnumber] + patch

If you have devscripts installed, just run:

$ bts tags [bugnumber] patch

Upload fixed package

still missing.