Debianisation of suckless-tools
================================

This package contains a set of tools from suckless community as single
package. To build the package you need to create source tarballs of
individual tool component involved. This can be done by running
following command from suckless-tools folder

 debian/rules get-orig-source

This package can not utilize git-buildpackage as it can't handle
multiple source tarballs in a single package. As of now it is using
git repository just to maintain packaging history.

Getting New Version of tools
============================

To get the new version of any tool, version information should be
changed in debian/version_data file, also increment the
CURRENT_VERSION string when doing new release.

Providing tools with alternative config
=======================================

If you want to provide alternative tools with customized configuration
you should drop the patch containing difference with original tool
into debian/local/ folder and also make sure you name the patch as
tool.alternative.

Two patches currently used to provide alternatives are

 1. dmenu.xft : Provides xft support for dmenu
 2. tabbed.meta: use meta key as modifier key for tabbed

These patches are borrowed from respective tools suckless web site
page[1][2]  and modified later to rename the binaries to same as the
patch name to avoid collision with original tool.

[1] http://tools.suckless.org/dmenu/patches/
[2] http://tools.suckless.org/tabbed/patches/

Original source is also modified for above binaries to provide a
suffix .default so that update-alternatives can install actual tool as
a symlink to original binary or alternative binary.

The code is forked under override_dh_auto_configure hook and then the
patch (under debian/local) is applied to create new alternative which
is installed under postinst script.

So to add new patch make sure

 1. You name the patch in format tool.alternative as we use tool part
    to fork the code to apply patch.
 2. Make sure you update patch 2003_transparent-makefiles.patch to
    name the original binaries and manpages to have .default suffix
 3. Make sure you rename the alternative binaries and manpages to have
    name tool.alternative.
 4. Insert new rules under postinst to install the alternatives and in
    prerm to clean up these alternatives.

 -- Vasudev Kamath <kamathvasudev@gmail.com>, Sat,  7 Sep 2013 16:57:27 +0530
