add example of mingw build

1 files changed, 43 insertions, 0 deletions

diff --git a/INSTALL b/INSTALL
index ae12452..c2c7675 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,5 +1,16 @@
 SoX Resampler Library       Copyright (c) 2007-13 robs@users.sourceforge.net
 
+INSTALLATION GUIDE CONTENTS
+
+* Standard build
+* Build customisation
+* Cross-compiling with mingw (linux host)
+* Integration with other build systems
+
+
+
+STANDARD BUILD
+
 1. Prerequisites:
 
     Before you can build this library, you need to have available on your
@@ -70,6 +81,38 @@ Options, if given, should be preceded with '-D', e.g.
 
 
 
+CROSS-COMPILING WITH MINGW (LINUX HOST)
+
+For example:
+
+    mkdir build
+    cd build
+    cmake -DCMAKE_TOOLCHAIN_FILE=~/Toolchain-x86_64-mingw-w64-mingw32.cmake \
+          -DCMAKE_INSTALL_PREFIX=install \
+          -DHAVE_WORDS_BIGENDIAN_EXITCODE=1 \
+          -DBUILD_TESTS=0 \
+          -DBUILD_EXAMPLES=1 \
+          ..
+    make
+
+where ~/Toolchain-x86_64-mingw-w64-mingw32.cmake might contain:
+
+    SET(CMAKE_SYSTEM_NAME Windows)
+    SET(CMAKE_C_COMPILER /usr/bin/x86_64-w64-mingw32-gcc)
+    SET(CMAKE_CXX_COMPILER /usr/bin/x86_64-w64-mingw32-g++)
+    SET(CMAKE_RC_COMPILER /usr/bin/x86_64-w64-mingw32-windres)
+    SET(CMAKE_Fortran_COMPILER /usr/bin/x86_64-w64-mingw32-gfortran)
+    SET(CMAKE_AR:FILEPATH /usr/bin/x86_64-w64-mingw32-ar)
+    SET(CMAKE_RANLIB:FILEPATH /usr/bin/x86_64-w64-mingw32-ranlib)
+    SET(CMAKE_FIND_ROOT_PATH /usr/x86_64-w64-mingw32)
+    SET(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+    SET(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
+    SET(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
+    SET(QT_BINARY_DIR /usr/x86_64-w64-mingw32/bin /usr/bin)
+    SET(Boost_COMPILER -gcc47)
+
+
+
 INTEGRATION WITH OTHER BUILD SYSTEMS
 
 Autotools-based systems might find it useful to create a file called