# -*- org -*-

* gLExec packaging for Debian from multiple sources

  The Debian source package for gLExec includes three upstream
  source tarballs:

  - the main glexec sources
  - mkgltempdir, a utility for securely making temporary directories
  - glexec-wrapper-scripts, helpers to pass the environment through
    a gLExec call.

  Debian packaging tools understand the concept of having multiple upstream
  sources. The main source tarball should be named

  : glexec_0.9.6.orig.tar.gz

  while the others should be named
  
  : glexec_0.9.6.orig-mkgltempdir.tar.gz
  : glexec_0.9.6.orig-glexec-wrapper-scripts.tar.gz

  (These files are symbolic links to the actual tarballs.)
  
  These source files are automatically picked up by dpkg-source: first the
  main tarball is unpacked, and then each following tarball is unpacked in
  a subdirectory of the main tree. The subdirectory is named after the
  given suffix of the tarball (i.e. mkgltempdir and glexec-wrapper-scripts).
  It's removed first if it already existed.

  There is a bug in svn-buildpackage which will prevent it from doing the
  above correctly for more than one additional source tarball (TODO: file
  a bug for that.) so some manual intervention is required.

** Exporting the package with svn-buildpackage

   Call
   : svn-buildpackage --svn-export --svn-noninteractive
   
   It should fail (unless bug #577140 is fixed) and result in a partially
   unpacked source tree. Go to ../build-area/glexec-0.9.6 and
   untar ../../tarballs/glexec_0.9.6.orig-mkgltempdir.tar.gz. Rename
   the directory to mkgltempdir (i.e. without the version number).

   Now the directory can be further treated with dpkg-buildpackage as usual.