README

   1
   2 To produce a PDF manual, issue the command "make pdf" after running
   3 `./configure'.
   4
   5                                  -*-
   6
   7 If you do not wish to build the C++ components, use:
   8
   9 ./configure --disable-cxx
  10
  11                                  -*-
  12
  13 The `examples' subdirectory contains some examples of using libconfig
  14 from C and C++.
  15
  16                                  -*-
  17
  18 Flex and Bison are not required in order to build this
  19 package. However, you will need them if you modify the .l or .y files. See
  20 the list of required build tool versions below.
  21
  22                                  -*-
  23
  24 To successfully compile using MinGW (with gcc 4.4.0 or later), it may
  25 be necessary to modify the file "mingw32\4.4.0\libstdc++.la", changing line 11
  26 from:
  27
  28 library_names='libstdc++.dll.a'
  29
  30 to:
  31
  32 library_names='libstdc++.a'
  33
  34 (See http://trac.osgeo.org/geos/ticket/282 for more information).
  35
  36                                  -*-
  37
  38 To cross-compile for Android:
  39
  40 1) Create a standalone toolchain using the 'make-standalone-toolchain.sh'
  41 script included with the Android NDK. For example:
  42
  43 $ /pkg/android-ndk-r9d/build/tools/make-standalone-toolchain.sh \
  44   --platform=android-19 \
  45   --install-dir=/pkg/android-toolchain-19 \
  46   --system=linux-x86_64 \
  47   --arch=arm
  48
  49 2) Add the standalone toolchain's bin directory to the front of the path:
  50
  51 $ export PATH=/pkg/android-toolchain-19/bin:$PATH
  52
  53 3) Configure libconfig for cross-compilation:
  54
  55 $ ./configure --host=arm-linux-androideabi \
  56   --with-sysroot=/pkg/android-toolchain-19/sysroot
  57
  58 4) Build libconfig
  59
  60 $ make
  61
  62                                  -*-
  63
  64 Build tools dependencies. (These are only required if you are a maintainer.)
  65
  66 Autoconf 2.69
  67 Automake 1.14.1
  68 Bison 3.0.2
  69 Flex 2.5.39
  70 Libtool 2.4.2
  71
  72                                  -*-
  73
  74 Libconfig may be found on github at https://github.com/hyperrealm/libconfig
  75
  76
  77
  78 For some reason, we need to symlink /pkg/android-toolchain-19/sysroot/pkg -> /pkg