How to use GIIRA with proprietary Cplex optimizer
=================================================

If you have a license for Cplex

   http://www-01.ibm.com/software/commerce/optimization/cplex-optimizer/

optimiser.  You need to rebuild this package including cplex support
since to build the package a patch was needed.  You can get the source
repository via

   debcheckout giira

or alternatively

   apt-get source giira

To disable this patch it is sufficient to remove (or uncomment by
prepending a #) the line

  remove_cplex_code.patch

from debian/patches/series.  Moreover you should do

  mv debian/bin/giira-cplex debian/bin/giira

To get a clean changelog it is recommended to use

  dch -i

to create a new changelog entry and it would be recommended to append
'cplex' to the Debian revision number just to have a reasonable
distinction from the official Debian package.  Then you can build the
package for instance using

  git-buildpackage --git-ignore-new

(or create your own private branch by adapting gbp.conf to your needs)
If you have uses `apt-get source giira` above you can not use
git-buildpackage but for instance [p]debuild.

If you have any problem with this procedure feel free to e-mail the
address below.

 -- Andreas Tille <tille@debian.org>  Fri, 07 Feb 2014 11:38:38 +0100
