rbdoom3bfg for Debian
---------------------

Usually rbdoom3bfg is  package directly from the git repository, as it might
contain some fixes. In this case package version contains +gitYYYYMMD.
If it is not, the upstream tarball has been used to create this package.

To regenerate the tarball from a git snapshot, a get-orig-source target in
debian/rules exists. See below for instructions how to tweak the target.

Several files will removed from the archive: Windows executeables,
dlls and files needed to build non-Unix architectures.

Additionally, several embedded code copies have been removed and the build
system patched to used the Debian ones:
- neo/libs/zlib (except the minizip folder which has been modified by idsoft)
- neo/libs/png
- neo/libs/jpeg-6
- neo/libs/glew
- neo/libs/rapidjson

Additionally, neo/libs/openal-soft has been removed, as this is not required
when building under Unix.

Please see the get-orgig-source target in debian/rules or the Files-Excluded
section in debian/copyright for the complete list.

The irrXML library in neo/libs/irrXML is strongly modified for this package,
so cannot be replaced with a packaged version.

Using get-orig-source
---------------------

To retrieve the latest upstream version, or any older version you can set the
date with the VER variable, set to the format YYYYMMDD. If not set, the date
from debian/changelog will be used.

To override the relase version, for example if upstream bumped the version,
you can set USVER. This only sets the name in the tarball and is not checked
if it is correlating to the real upstream version.
If not set, the version from d/changelog will be used.

For example,

 VER=$(date +%Y%m%d) make -f debian/rules get-orig-source
will fetch the latest upstream version (at least commits up to today midnight)

 UPSVER=1.0.2 VER=20141005 make -f debian/rules get-orig-source
wil retrieve the git version fomr 2014 October 5th, and names the tarball
with the upstream version 1.0.2 -> so the tar will be named
rbdoom3bfg_1.0.2+git20141005+repack.orig.tar.xz

 -- Tobias Frost <tobi@debian.org>  Tue, 10 Mar 2015 17:48:00 +0200
