Developer notes for the PPAs

[Gustavo Niemeyer]

Hi again,

These notes are not so interesting for _using_ the packages that are
being built in the PPA, but rather for the developers maintaining
them.

As a side effect from the PPA integration work, we have a few new branches
and a few new meanings to previous branches, as follows.


lp:~ensemble/ensemble/zookeeper-vendor

    This branch holds the vanilla code from ZooKeeper upstream, with .jar
    and .orig files removed.


lp:~ensemble/ensemble/zookeeper-package

    This branch holds a copy of the vendor branch, plus the debian/
    directory.  We're not supposed to touch the content outside the debian/
    directory in this branch.  When releasing a new upstream package,
    update zookeeper-vendor, and then merge it here.  When patching the
    code locally, add a patch under debian/.  The goal of these rules is
    to make integration into Ubuntu easier.

    This branch will be automatically built daily if any changes are made
    through the recipe at:

        https://code.launchpad.net/~ensemble/+recipe/zookeeper


lp:~ensemble/ensemble/txaws-vendor
lp:~ensemble/ensemble/txaws-package

    These two branches have the same semantics of the zookeeper branches
    above, but for the txaws project.  So, upstream changes go straight
    onto txaws-vendor, txaws-package gets debian/, no further changes
    outside debian/ there.  The recipe is at:

        https://code.launchpad.net/~ensemble/+recipe/txaws


lp:~ensemble/ensemble/trunk
lp:~ensemble/txzookeeper/trunk

    The case of ensemble and txzookeeper is slightly different because we
    are the upstreams of these projects, so to avoid having unnecessary
    overhead maintaining these, the recipes for daily builds are connected
    straight to their respective trunk branches:

	https://code.launchpad.net/~ensemble/+recipe/ensemble
        https://code.launchpad.net/~ensemble/+recipe/txzookeeper

    As Clint correctly noted, having the debian/ directory next to the
    source code is generally discouraged, but for the moment, while these
    packages are not integrated into Ubuntu, this shouldn't create any
    further difficulties and it makes maintenance quite practical to us,
    so we can go with that for now.  When that becomes a problem, we can
    easily revisit the choice and have something closer to the prevoius
    cases.

-- 
Gustavo Niemeyer
http://niemeyer.net
http://niemeyer.net/blog
http://niemeyer.net/twitter