/** \page osxbuild Building GnuCash on OSX

\section osxprepare Preparation

There are notable problems building gnucash with the default
auto tools installed in OSX and even installing the GNU versions
via fink may not be sufficient - OSX may still call the BSD version
in preference to the newly installed GNU version.

To avoid these problems, you are advised to change your PATH variable
in ~/.bashrc to put the Fink binaries ahead of the main OSX binaries
in your path or export a new PATH in the script that calls autogen.sh.
Instead of:
\verbatim
PATH=/usr/bin/:/sbin/:/usr/sbin/:/bin:/opt/local/bin:/sw/bin
/endverbatim
use:
/verbatim
PATH=/sw/bin:/usr/bin/:/sbin/:/usr/sbin/:/bin:/opt/local/bin
/endverbatim

Then, when calling ./autogen.sh and ./configure, it is necessary
to direct OSX to the correct Guile installation environment using:

\verbatim
#!/bin/bash
guile16-build env LIBRARY_PATH=/sw/lib CPATH=/sw/include \
./autogen.sh
guile16-build env LIBRARY_PATH=/sw/lib CPATH=/sw/include \
./configure <your configure options>
guile16-build env LIBRARY_PATH=/sw/lib CPATH=/sw/include \
make
\endverbatim

If (when) you do a 'make distclean', this whole process will have to
be done again.

If you have to change automake or autoconf versions, make sure you
remove the autom4te.cache/ directory before running autogen.sh again.

\section osxtools OSX tools

GnuCash recommends <b>only>/b> the most recent versions of each of the 
GNU auto tools available via Fink. As of November 2005, these were:

\verbatim
                 10.3         10.4
autoconf2.5     2.59-6       2.59-6
automake1.9     1.9.5-1      1.9.6-1
libtool14       1.5.18-1     1.5.20-1
\endverbatim

Currently, these versions are only available in the unstable (CVS) version
of Fink.

http://pdb.finkproject.org/index.php

*/

