Readme.ubuntu

Building Ubuntu packages of Subsurface
--------------------------------------

These steps describe roughly, how one can create Ubuntu packages out of
Subsurface and publish them in Launchpad.

We have a more complete shell script now under packaging/ubuntu, but the
details in this file are still helpful to understand how all this works.

You need quite a bit of packages installed for all this to work, but that is
not described here. The contents of control, rules and other files edited can
be based on the files under packaging/ubuntu/debian.  GPG is used to sign the
changes file and SSH keys are required for the upload to Launchpad.

---8<---
# First we need to create a source directory and have the sources of the
# latest version there

version="4.2.90"
mkdir subsurface-${version}
cd subsurface-git
git archive --format=tar v${version} | tar -xf - -C ../subsurface${version}/
cd ../subsurface${version}

# Then we create the source tarball and "Debianize" the sources with
# dh_make

dh_make --email miika.turkia@gmail.com -c gpl2 --createorig --single

# Next step is to fix the control files

rm debian/*.ex debian/*.EX debian/README.*
vi debian/{changelog,copyright,control,rules}

# Generating the build instructions that can be uploaded to Launchpad
# (or tested first locally with pbuilder). Following assumes that the
# version initially is "trusty"

debuild -S

# To test locally, one needs pbuilder set up properly

sudo pbuilder build subsurface_${version}-0exp1ppa1~trusty.dsc

# Once everything is working properly, create the other supported
# releases and upload them all to Launchpad.

sed -i 's/trusty/utopic/g' debian/changelog && debuild  -S
sed -i 's/utopic/precise/g' debian/changelog && debuild  -S

dput ppa:subsurface/subsurface-beta subsurface_${version}-0exp1ppa1~trusty_source.changes
dput ppa:subsurface/subsurface-beta subsurface_${version}-0exp1ppa1~utopic_source.changes
dput ppa:subsurface/subsurface-beta subsurface_${version}-0exp1ppa1~precise_source.changes
---8<---

Current dependencies are the following:

Build-Depends: debhelper (>= 8.0.0), cmake, libdivecomputer-dev (>=
0.4.2), cdbs, libqt4-dev, qt4-qmake, libxml2-dev, libxslt1-dev,
zlib1g-dev, libusb-1.0-0-dev, libzip-dev, libmarble-dev, libsqlite3-dev,
libqtwebkit-dev, pkg-config, libgit2-dev, asciidoc

Depends: ${shlibs:Depends}, ${misc:Depends}, libdivecomputer0 (>= 0.4.2)

And the rules file contains only the following includes:

include /usr/share/cdbs/1/rules/debhelper.mk
include /usr/share/cdbs/1/class/qmake.mk


Building Ubuntu packages of libdivecomputer
-------------------------------------------

Building libdivecomputer is mostly the same as building Subsurface.
However, one must remove the line "usr/share/pkgconfig/*" from
debian/libdivecomputer-dev.install. Also "debianizing" the sources
differs and is done with the following command:

dh_make --email miika.turkia@gmail.com -c gpl2 --createorig --library


Including libgit2
-----------------

It should suffice for us to just copy the libgit2 package from
repository to another on Launchpad. Precise is the only release that
does not have libgit2 available, for the other releases we can use the
distribution provided version.