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 then, 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
    
    2 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.

 -- gustavo panizzo <gfa@zumbi.com.ar>  Fri, 23 Ago 2013 10:33:08 -0300
