HACKING

   1 when hacking at ZBar, PLEASE send patches against the latest Mercurial!
   2 if you haven't already, grab the ZBar Mercurial repository by running:
   3
   4     hg clone http://zbar.hg.sourceforge.net:8000/hgroot/zbar
   5     cd zbar
   6     autoreconf --install
   7
   8 this will generate configure and all that other foo you usually get with
   9 a release.  you will need to have recent versions of some basic "developer
  10 tools" installed in order for this to work, particularly GNU autotools.
  11 these versions of autotools are known to work (newer versions should also
  12 be fine):
  13     GNU autoconf 2.61
  14     GNU automake 1.10.1
  15     GNU libtool 2.2.6
  16     GNU gettext 0.18.1.1
  17     GNU pkg-config 0.25
  18     xmlto 0.0.20-5 (for docs building)
  19 all above mentioned tools (except xmlto) must be installed in the same
  20 prefix. mixing prefixes (i.g. /usr/bin and /usr/local/bin) may lead to
  21 errors in configuration stages
  22
  23 when you're done hacking and want to make your patch, run:
  24
  25     hg diff --git > hacked.patch
  26
  27 and go post this file in the patches section off the project page:
  28
  29     http://sourceforge.net/tracker/?group_id=189236&atid=928517
  30
  31 finally, some interesting reading if you want to increase your chances
  32 of patch acceptance:
  33
  34     http://www.faqs.org/docs/artu/ch19s02.html
  35     http://www.catb.org/~esr/faqs/smart-questions.html