mercurial-buildpackage - Online in the Cloud

PROGRAM:

NAME

mercurial-buildpackage - Build a .deb package from source code under Mercurial control.

SYNOPSIS

mercurial-buildpackage [option] ...

DESCRIPTION

mercurial-buildpackage builds a .deb package from within a Mercurial repository. The
package is built either by use of pbuilder(1) or in-place, depending on the options.

OPTIONS

--version, -V

Output version and exit.

--verbose, -v

Increase verbosity level. Can be used several times.

--no-check-dependencies, -d

Do not check for missing build dependencies.

--include-source, -s, -sa

Force inclusion of upstream source.

--from-version changelogversion, -f changelogversion

Include all changelog entries from changelogversion.

--source-only, -S

Build the source only.

--configfile pbuilderconfigfile, -c pbuilderconfigfile

Use pbuilder(1) to build package in a chroot(8) specified in pbuilderconfigfile.

EXAMPLES

mercurial-buildpackage

Silently build a package in-place using debian/rules and dpkg-genchanges(1). The
complete build log will be placed in ../package_version_arch.build.

mercurial-buildpackage -s -f 1.2-3 -c /home/jps/lenny-pbuilderrc

Build a backport package for the Lenny release using pbuilder. The source and all
changelog entries since 1.2-3 are included in package.

REPOSITORY LAYOUT

Let us assume that your package is called mypack. The package repository should be
created by a regular hg init mypack command.

If mypack is a native package, then your repository will only have the usual default
branch and mercurial-buildpackage will only affect the .hgtags file when mercurial-
tagversion(1) is invoked to tag a release of mypack.

If mypack is a non-native package, then it will have a number of upstream tarballs, as
specified in dpkg-source(1). Let us assume that the upstream tarballs are
mypack_1.0.orig.tar.gz, mypack_1.0.orig-comp1.tar.bz2 and mypack_1.0.orig-comp2.tar.gz,
and that you therefore use package format 3.0 (quilt). mercurial-buildpackage will then
maintain the following branches.

mypack A branch containing the source from the main tarball.

comp1 A branch containing the source from the comp1 tarball.

comp2 A branch containing the source from the comp2 tarball.

pristine A branch containing additional information for recreating pristine upstream
tarballs.

upstream The combination of all upstream tarballs, as specified in dpkg-source(1).

default The branch for mainline package work. It will have all debian/patches applied
and the quilt .pc directory included as part of the repository.

So each upstream tarball will have its own branch which together with the pristine branch
are used by mercurial-pristinetar(1) to recreate pristine upstream tarballs.

The upstream branch is used by mercurial-importorig(1) to merge new upstream versions into
the mainline default branch; and by mercurial-port(1) to make alternative packages of
selected upstream versions, for instance for backporting.

In general, you should leave alone all the branches dealing with upsteam sources, and only
work in the default branch or branches created by mercurial-port(1) for porting.

OPERATIONAL OUTLINE

In-place building
fakeroot debian/rules clean
dpkg-source -i.hg -b mypack ..
debian/rules build
debian/rules binary
dpkg-genchanges > ../mypack_1.0-2_i386.changes

Chroot building
fakeroot debian/rules clean
dpkg-source -i.hg -b mypack ..
pbuilder --build --configfile ~/etc/sid-pbuilderrc ../mypack_1.0-2.dsc

Use mercurial-buildpackage online using onworks.net services