RESUME
------
Scripts to build binary digiKam installer for Windows under Linux using cross-compiler 
environnement MXE and NSIS application.

AUTHORS
-------
(c) 2015-2016 by :

Gilles Caulier <caulier dot gilles at gmail dot com>

DESCRIPTION
-----------
These files and scripts are used to make binary installer of the digiKam
Software Collection for Windows 32 bits or 64 bits. In addition to this README,
there are comments in the scripts that provide some additional explanation for
how they work.

Note : these cross-compiling scripts exists because the way provided by KDE team to compile 
a KDE application under Windows with MSVC compiler through emerge tool never work and is just
a big pain to use/configure/run with a Windows OS. Also KDE Windows initiative look like 
unmaintained/inactive since a while.
Another big advantage of cross-compiling is to not require a Windows to do the job, which 
is definitively a weird operating system to compile and hack.

REQUIREMENTS
------------
The scripts build digiKam with MXE cross compiler, so you will need all dependencies
and the other prerequisites for MXE. See http://mxe.cc/#requirements for details.

You will also need to install NSIS software (http://nsis.sourceforge.net/)
which does the actual packaging of the files needed to install digiKam.

COMPONENTS
----------
There are 4 scripts to be run by the user. 2 first ones installs
MXE and all dependencies, next one digiKam, and last one makes a 
binary installer for Windows.

SCRIPT DESCRIPTIONS
-------------------
All scripts should be run from within the digikam-package directory.

IMPORTANT: set properly the right architecture target in first : windows 32 or 64 bits.
Look in config.sh file for details.

* 01-build-mxe.sh:

This script downloads and configures a custom install
of MXE to ./build.

* 02-build-extralibs.sh:

This script configures, and compile a install to ./build
of extra libraries, including KF5 frameworks, and most important photo management
libs used by digiKam as Exiv2 and LensFun.

* 03-build-digikam.sh:

This script configures, and compile a custom install of digiKam to ./build.

* 04-build-installer.sh:

Once you've successfully built digiKam, ./build may contain over 4GB of files.
The make-installer.sh script grabs the ~200MB needed to run digiKam and showfoto.
These include applications documentations and translations.

This script creates Windows application links for the programs that will
be run by the user (digiKam, Showfoto, etc). It use makensis CLI tool from NSIS 
application dedicated to build Windows installer. This one is available for Linux
as Mingw package.

* rll.py

Run by 04-build-installer.sh. It is a python script that takes a list of binaries
and libraries supplied by 04-build-installer.sh and recursively lists the dlls on
which they depend, and their dependencies, etc...
Adapted with minimal modification (mostly deleting stuff) from
https://github.com/mpreisler/mingw-bundledlls

LICENSES
--------
The scripts and other contents of this package are licensed
under the GNU General Public License version 2, or any later version.
