uhexen2 for Debian
------------------

Content:

1. Packaging overview
2. Upstream sources
3. Patches


1 - Packaging

    + Packaging was maintained under version control, that is
    no longer the case. Upstream source contains non-free stuff which
    should be cleaned before upload to Debian.
    Then maintaining the package on a vcs is more work without any benefits.

    This could change in the future, but no promises will be made.

2 - Upstream sources

    Upstream (http://uhexen2.sourceforge.net/) releases several files

    + hexen2source-${VERSION}.tgz
    The main source tarball containing hexen2, hexenworld, game launcher,
    hexen2 utilities, hexenworld utilities, documentation, and even some extra
    patches.

    + hexen2source-gamecode-${VERSION}.tgz
    Sources for the game hcode including hexen2, mission pack, hexenworld and siege.

    + Those 2 files are combined on a single tree following this procedure

    $ tar xzf hexen2source-${VERSION}.tgz
    $ cd hexen2source-${VERSION}
    $ tar xzf ../hexen2source-gamecode-${VERSION}.tgz
    $ mv gamecode-* gamecode
    the non-free (gamecode/patch111),
    dubious (gamecode/hc/siege, gamecode/txt/siege), unused (hexen2.spec, win32, etc)
    or redundant (LICENSE.txt, COPYING) files are removed by source-cleaner.sh script.

    We keep patches/syntax_checking.patch on debian/patches directory.


3 - Patches

    The source package uses quilt for the modifications of the upstream source.
    If you want to change something it is best to use the quilt approach as
    documented in
        /usr/share/doc/quilt/README.source

    4 patches are applied to the upstream source
    + syntax_checking.patch which already comes with the upstream source, it
    enables a long output to --help switch.

    + hardening.patch which modifies Makefiles to allow a hardened build.

    + debian-paths which installs the binaries on debian paths and changes the search path for game data.

    + spelling-fixes.patch spell fixes.

 -- gustavo panizzo <gfa@zumbi.com.ar>  Tue, 23 Aug 2016 12:43:08 +0800
