gnucash/packaging/win32

These scripts try to download and install a Windows/mingw32 build
environment for GnuCash on Windows.

These scripts support two ways to build a Windows/mingw32 version of GnuCash:
- directly on a Windows PC
- via cross-compilation on Linux

1. Build GnuCash directly on a Windows PC
-----------------------------------------

Before you start with the automated build, you have to complete these
steps manually. The directory variables are set in `defaults.sh' and optionally
`custom.sh'.

Note: The mingw homepage is http://www.mingw.org. You can read more
      about mingw over there. The packages to download are all
      on sourceforge however, so the direct links are given here.

* Download MSYS from
  https://sourceforge.net/projects/mingw/files/MSYS%20Base%20System/msys-1.0.11/MSYS-1.0.11.exe/download
  to $DOWNLOAD_DIR
  Note: there may be a more recent version available when you read this, use
        whatever version that is available. BUT: be sure to use MSYS-xyz.exe
        (ie the MSYS installer) and not the *bin.tar.lzma. I got confused
        the first time I tried, because directory msys-1.0.12 existed on
        sourceforge, but it didn't have the windows installer. You should
        use the installer, not try to unpack the -bin.tar.lzma files. So
        choose whatever version that has got an installer.

* Install MSYS into $MSYS_DIR.

* Download mingwPORT's wget from
  https://sourceforge.net/projects/mingw/files/mingwPORT/Current%20Releases/wget-1.9.1-mingwPORT.tar.bz2/download
  to $DOWNLOAD_DIR
  Note: the version number may have changed when you try this. Use whatever version
        that is available

* Look at defaults.sh and create a file named custom.sh to specify adapted directory
  variables.  If you want verbose output of any script
  step, add "set -x" to that file.

* Either, download Qt from http://www.trolltech.com/developer/downloads/qt/windows,
  install it and set QTDIR in custom.sh, like "QTDIR=/c/Qt/4.2.3"; or skip building
  the AqBanking Setup Wizard by specifying "AQBANKING_WITH_QT=no".

Start/Enter any MSYS shell window. Let the automated build begin by:

  $INSTALLER_DIR/install.sh

Good luck!

To generate a self-installing setup.exe file that contains
*everything*, run the following command after install.sh has
completed:

  $INSTALLER_DIR/dist.sh
  
  
  Note: if you didn't download and install Qt earlier, this command will fail
        regardless of whether you disabled AQ_BANKING_WITH_QT or not. This is
        a bug in the configuration script for the installer builder (issc).

More information is collected on http://wiki.gnucash.org/wiki/Windows


2. Cross-compile GnuCash/win32 on a linux PC
--------------------------------------------

Cross-compiling a Windows/mingw32 executable of GnuCash on a Linux
host system. (Note: This used to work unchangedly in Sept'2006 but
probably not any longer.)

These steps need to be performed:

1. Look at defaults.sh and create a file named custom.sh to specify adapted
   directory variables.  If you want verbose output of any script
   step, add "set -x" to that file. Particularly for cross-compiling,
   set these variables:
   * cross_compile: should be set to yes
   * GLOBAL_DIR: the base directory for all other directory definitions,
     unless you explicitly override it for some directories.
   * MINGW_DIR: set this to your preferred prefix of the mingw32 gcc/binutils
     on your Linux installation.
     (It is strongly recommended to choose a prefix different
      from your normal compiler tool chain in order to distinguish
      your native vs. cross compiler more easily.) 

2. Then run the script create_cross_mingw.sh - it will
   download, compile, and install a mingw32 tool chain.

3. Download a binary windows packages for "guile" e.g. from
   http://www.tu-harburg.de/~et2cs/gnc/ and unpack it into the
   directory $GUILE_DIR as given in defaults.sh. (This is done because
   the build system for guile doesn't support cross-compiling.)

4. Call install.sh, which will read the directory settings from
   defaults.sh/custom.sh. It should download, compile, and install everything
   automatically. Eventually the windows gnucash is installed into
   $GNUCASH_DIR. 

5. The content of $GNUCASH_DIR (as well as all the other binary
   packages) should then be copied to a windows machine. The paths
   in $GNUCASH_DIR/bin/gnucash and/or $GNUCASH_DIR/bin/gnucash.cmd
   need to be adjusted for the installation location on the
   windows machine.

Good luck!