README.source for gerris in Debian
==================================

The download from upstream is a snapshot tarball which contains two 
external modules:
- RStarTree, without copyrigth/license info.
- fes2004, from Thierry LETELLIER, licensed under GPL, but including 
  some functions from Aktarus library (from Thierry LETELLIER and 
  Laurent ROBLOU). The Aktarus functions include some GPL-incompatible 
  restrictions.

This external modules aren't essential to gerris and was removed from 
the Debian sources.

The debian/get-orig-source.sh script downloads the upstream source, and 
creates the gerris_$VERSION.orig.tar.gz used as Debian source file. The 
script does the following:
- download the latest upstream tarball
- unpack the tarball
- remove modules/
- update configure, configure.in, Makefile.in, and Makefile.am, 
  removing references to modules/ (preserving timestamps).
- rename sources dir and set timestamps from upstream tarball
- tar and gzip the result


===================================
The debian packaging uses quilt in a debhelper (dh) environment to maintain 
material patches from the upstream source.  See /usr/share/doc/quilt/README.source 
for more details on quilt usage.

Some patches affect upstream automake scripts (Makefile.am).  To regenerate 
derived configure and Makefile scripts, use the following steps (or 
similar) from the top-level directory (above the debian subdir):
	dh_quilt_patch
	autoreconf
	dh_quilt_unpatch

When manipulating patches (editing or adding new quilt patches) after 
running dh_quilt_patch, make sure QUILT_PATCHES is set to 
debian/patches: "QUILT_PATCHES=debian/patches quilt new <patch>",
"QUILT_PATCHES=debian/patches quilt refresh", etc.

