This page documents the idea of moving to tarball releases at moblin.org.

 Current issues:

 * out of date tarballs
 * broken tarballs
 * missing tarballs

== example update of hildon-theme-mobile-basic, moving to tarball release ==

 * Check versions in target archive(s) versus upstream
   - upstream tarball release is 0.33
   - ubuntu-mobile ppa (https://launchpad.net/~ubuntu-mobile/+archive) has a
     package versionned at 0.32
   - Ubuntu hardy has a package versionned at 0.27 ("rmadison
     hildon-theme-mobile-basic"; rmadison is in the devscripts package)

 * Download
{{{
   mkdir htmb
   cd htmb
   # hardy
   mkdir hardy && cd hardy && dget -x http://archive.ubuntu.com/ubuntu/pool/universe/h/hildon-theme-mobile-basic/hildon-theme-mobile-basic_0.27.dsc
   # ppa
   mkdir ppa && cd ppa && dget -x http://ppa.launchpad.net/ubuntu-mobile/ubuntu/pool/main/h/hildon-theme-mobile-basic/hildon-theme-mobile-basic_0.32.dsc
   # upstream release
   mkdir release && cd release && wget http://moblin.org/repos/releases/hildon-theme-mobile-basic-0.33.tar.gz && tar xvzf hildon-theme-mobile-basic-0.33.tar.gz
   # upstream git (only useful to check older versions); use rsync:// if you
   # don't have a moblin.org account
   mkdir git && cd git && git clone moblin.org:/home/repos/projects/hildon-theme-mobile-basic.git/
}}}

 * Compare hardy version with the release it claims to base on
   - Locate the 0.27 code; there were no tarball back when 0.27 was committed;
     there's no 0.27 tag in the upstream git repo ("git tag"); "git log" / gitk
     help pinpoint that the commit for the 0.27 release was
     5235a36a0bd97bfc83b87dec55493204ecf31306
   - Get that code; e.g. cd git/hildon-theme-mobile-basic && git checkout
     5235a36a0bd97bfc83b87dec55493204ecf31306
   - Compare the trees; .git differences are uninteresting; filterdiff is in
     patchutils; you can also use "lsdiff" or "diffstat" to get an overview of
     the changes without reading the diff
{{{
   diff git/hildon-theme-mobile-basic hardy/hildon-theme-mobile-basic-0.27 | filterdiff -x '*/.git/*' | sensible-editor -
}}}
   - Conclusion: only debian/changelog differs, there was no modification to
     the upstream source (which included packaging back then) in 0.27; nothing
     was added to hardy which wasn't upstream already, so there will be nothing
     to merge from hardy between uploads

 * Compare ppa version with the release it claims to base on
   - See above with 0.32 instead of 0.27
   - There are /two/ tags for 0.32, hardy-v0.32 and gaston-v0.32; "git diff
     hardy-v0.32 gaston-v0.32" shows that only target dist changes
   - Get that code; e.g. "git checkout hardy-v0.32"
   - Compare the trees
   - Conclusion: the ppa source package and the upstream release are identical;
     nothing was added to the ppa which wasn't upstream already, so there will
     be nothing to merge from the ppa between upload

 * Prepare new upstream release from the latest UME tree (ppa obviously) for
   hardy
   - Compare latest tree (ppa tree) with upstream release tree
{{{
   diff ppa/hildon-theme-mobile-basic-0.32 release/hildon-theme-mobile-basic-0.33 | lsdiff
}}}
   - Review shows that debian/ and .git/ aren't in the tarball anymore -- as
     expected -- other "upstream" changes are visible in the ChangeLog/diff
   - Create the new package from the upstream tarball and the packaging from
     the latest UME packaging; the tarball is needed for non-native packages
{{{
   cp -a release/hildon-theme-mobile-basic-0.33 hardy
   cp -a ppa/hildon-theme-mobile-basic-0.32/debian hardy/hildon-theme-mobile-basic-0.33
   cp release/hildon-theme-mobile-basic-0.33.tar.gz hardy/hildon-theme-mobile-basic_0.33.orig.tar.gz
}}}
   - Create a new changelog entry for the new upstream release; you can use
     "dch" to do this; the version should now be 0.33-0ubuntu1 (non-native) for
     hardy e.g.:
{{{
hildon-theme-mobile-basic (0.33-0ubuntu1) hardy; urgency=low

  * New upstream release; switch to non-native.

 -- Loic Minier <lool@dooz.org>  Wed, 02 Apr 2008 16:30:46 +0200
}}}
   - Build (if you have one pbuilder setup, build in pbuilder!), install, and
     test the package
   - If you can, upload to hardy, otherwise, file a bug with the debdiff
     between the version in hardy and the new version or simply the .dsc and
     the .diff.gz and a link to the upstream tarball; you can create the
     debdiff with:
{{{
debdiff hardy/hildon-theme-mobile-basic_0.27.dsc hardy/hildon-theme-mobile-basic_0.33-0ubuntu1.dsc > hardy/hildon-theme-mobile-basic_0.33-0ubuntu1.debdiff
}}}

 * Pending upload to hardy, or if you want people pulling from snapshot + ppa
   to get the update, prepare an upload to the ppa
   - Prepare a working tree for the next ppa upload from the new .dsc for hardy
{{{
   cd ppa && dpkg-source -x ../hardy/hildon-theme-mobile-basic_0.33-0ubuntu1.dsc
}}}
   - Add a changelog entry for the verbatim backport; again you can use dch
     here and should use hardy version + ~804um1 and target at hardy; e.g.:
{{{
hildon-theme-mobile-basic (0.33-0ubuntu1~804um1) hardy; urgency=low

  * Backport to ubuntu-mobile ppa.

 -- Loic Minier <lool@dooz.org>  Wed, 02 Apr 2008 16:47:05 +0200
}}}
   - Build, install, test, upload