Maintainer notes for the tulip package
======================================

filtering of upstream tarball
-----------------------------

git rm -r                               \
 library/tulip-ogl/bitmaps/fonts        \
 library/tulip-ogl/bitmaps/fontawesome-webfont.ttf \
 thirdparty/MinGW.zip                   \
 thirdparty/ftgl/                       \
 thirdparty/utf8-cpp/                   \
 thirdparty/sip-*/

(see below for discussion about storing upstream changes in git)

git archive --prefix tulip-4.8.0dfsg/ --format tar dfsg | xz -9 > ../tulip_4.8.0dfsg.orig.tar.xz


generation of debian/patches/
-----------------------------

Packaging is done with a "main" tulip git repo with upstream source is
not public, because of both volume and DFSG issues.  The useful parts
can be reconstructed from upstream tarballs, and from the
dfsg-filtering shown above.  Or you can deal with the package as with
any other that stores debian/ tree in a collab-maint git repo.

This "main" repository contains:
* a "dfsg" branch forked off "upstream", with the contents of the orig tarballs
* a "patches" branch managed with git-rebase, with changes to (filtered) source files
* a "debian/" submodule available as git://git.debian.org/git/collab-maint/tulip.git
* a "debian" branch forked off "dfsg", with just submodule updates

After a switch to branch "debian" and a "git submodules update", we
can switch back to "patches", and even a "git reset --hard" won't nuke
anything from debian/, so we can happily rewrite the patch stack and
adjust debian/ contents till OK.

The patches are then exported from "patches" to the debian/submodule with:

(cd debian && git rm -f patches/*)
git format-patch -N -o debian/patches/ dfsg..master
(cd debian/patches/ && ls *.patch > series)
(cd debian && git add -f patches)


maintainance of upstream source tree
------------------------------------

 - upstream releases imported using git-import-orig into "upstream"
 branch (note: you need to specify a version explicitely for
 prereleases including a ~ in the version):
	$ gbp import-orig --no-merge -u 3.0.0B7 ../tulip_3.0.0~B7.orig.tar.gz

        $ git checkout dfsg
        $ git merge upstream

 - apply fitering as explained above

-- 
Yann Dirson, 2015-11-26.
