Editing WxHaskell/Building (section)

=== Building wxHaskell ===

Since wxHaskell 0.12.1.1, we only support building using Cabal.

For all platforms installation is straightforward, provided that:
# wx-config is somewhere in the path
# The WXWIN environment variable points to the root of your wxWidgets installation
# WINDOWS PLATFORMS ONLY:  You may also need to set WXCFG=gcc_dll\mswu

You can then install wxhaskell as follows (''in a Windows cmd.exe shell, not an MSys shell''):

 > cabal update
 > cabal install wx

Note that on Windows 7 machines, your command window must be running as Administrator.

Note that on Unix systems, you may prefer something like

 > sudo cabal install --global wx

Windows developers who don't update environment variables can do something like this in an MS-DOS shell:

 > Set CPLUS_INCLUDE_PATH=C:\MinGW\include\c++\3.4.5;C:\MinGW\include\c++\3.4.5\mingw32\
 > Set WXWIN=C:\path\to\wxWidgets-2.8.10 
 > Set WXCFG=gcc_dll\mswu
 > cabal install wx

The Windows installation is global by default.

==== Out of memory errors ====

There have been reports of out of memory errors when compiling wxcore on some machines, notably 64 bit Linux hosts. Wxcore contains some very large auto-generated source files, and increasing the memory available to the GHC runtime can help.

Try something like:

 > export GHCRTS='-M512m'

to allocate 512 MB to the GHC RTS. This has been reported to be sufficient.