NAME

       release-build  - convenient script for "building" an upstream project, prior to release to
       Ubuntu

SYNOPSIS

       release-build

ASSUMPTIONS

       This script, along with its partner, release(1),  require  a  particular  set  of  project
       parameters to operate properly.
        * The project must use bzr(1) and http://launchpad.net
        * The project name, [FOO], must match its Launchpad project, http://launchpad.net/[FOO]
        *   There  must  be  a  corresponding  Launchpad  team,  also  matching  the  same  name,
       http://launchpad.net/~[FOO]
        * The team must have a PPA activated, named "ppa"
        * The project must use a MAJOR.MINOR versioning scheme

DESCRIPTION

       This script will work on a bzr(1) branch with debian packaging in the  current  directory.
       It will:
        *   automatically   determine  the  project/package  name  and  version  by  parsing  the
       debian/changelog file
        * clean out the build-area
        * create an original tarball
        * check the original tarball for common mistakes
        * build a local binary deb
        * build a set of source packages, for each of a set of supported Ubuntu releases

       After the script performs these actions, the next steps are printed to the screen, for the
       user to copy-and-paste.  These steps include:
        * the command to install the package locally (for testing)
        * the release command, to move on and make it official
        * also the command to revert the changes to the debian/changelog

EXAMPLES

       For  sample  projects/packages  that  use  the  release  and  release-build  commands  for
       publishing, see:
        * bikeshed
        * byobu
        * ecryptfs
        * musica
        * pictor
        * powernap
        * screenbin
        * testdrive

SEE ALSO

       release(1), bzr(1), dpkg(1)

AUTHOR

       This manpage and the utility was written  by  Dustin  Kirkland  <kirkland@ubuntu.com>  for
       Ubuntu  systems  (but  may  be used by others).  Permission is granted to copy, distribute
       and/or modify this document under the terms of the GNU General Public License,  Version  3
       published by the Free Software Foundation.

       On  Debian  systems,  the  complete text of the GNU General Public License can be found in
       /usr/share/common-licenses/GPL, or on the web at http://www.gnu.org/licenses/gpl.txt.