INSTALL

   1 See README for dependencies.
   2
   3 If you get code from VCS, you will need Autotools (automake, autoconf,
   4 libtool) and gettext in addition and you must prepare build system with
   5 `autoreconf --install'.
   6
   7 Then run `./configure && make && make install' to build and install library
   8 into your system.
   9
  10 If you want to change installation directory use appropriate configure
  11 argument (see `./configure --help' for more details).
  12
  13 Additional configure options:
  14
  15     --enable-example
  16
  17         Build example client. You can run and study example clients in `client'
  18         subdirectory.
  19
  20     --enable-test
  21
  22         Build and run library internal tests. You can run tests by
  23         `make check'. You can run and study each test in `test' subdirectory.
  24
  25     --enable-online-test
  26
  27         Build and run library internal tests that require Internet access in
  28         addition. --enable-test must be supplied too. You can run tests by
  29         `make check'. You can run and study each test in `test/online'
  30         subdirectory.
  31
  32     --enable-debug
  33
  34         Switch on debugging mode, compile in debugging code.
  35
  36     --disable-fatalwarnings
  37
  38         Switch off compile mode when compiler raises error on warning. This is
  39         enabled to catch all code ambiguities by default.
  40
  41     --without-libcurl
  42
  43         Disable network operations by omitting cURL library. It disables
  44         on-line tests too. Library will keep capability to process local
  45         messages and delivery details. Library will not be able to connect to
  46         ISDS server in this mode.
  47
  48     --enable-curlreauthorizationbug
  49
  50         Compile in work-around for HTTP reauthorization bug in cURL library.
  51         This is disabled by default. This bug will be fixed in cURL 7.28.0
  52         by cURL commit ce8311c7e49eca93c136b58efa6763853541ec97. This bug
  53         affects changing ISDS password while OTP authentication method is in
  54         use.
  55
  56 Large File Support (LFS) Notice: libisds uses GPGME, and GPGME is compiled
  57 with LFS on usually. You need to keep LFS compatibility on reverse dependencies
  58 (libisds library, your application using libisds), otherwise strange things
  59 can happen (e.g. file/message/document sizes can mismatch). libisds switches
  60 LFS on too. Use --disable-largefile to switch it off if you think it's more
  61 appropriate. However recall this tweak when building your application.
  62
  63 Example clients and tests are not installed by `make install'.