                             **** WAIT! ****

If you're planning to use FXRuby on Windows, be aware that the Pragmatic
Programmers' Ruby installer for Windows contains a version of FXRuby,
although it may not be the most recent one.

                             The Basics
                            ============

This is more or less a plain text transcription of the first part of the
build instructions found in the FXRuby User's Guide here:

    http://www.fxruby.org/doc/build.html

If you have additional questions about how the build and installation process
works you might want to also read that document.

These instructions assume that you've already downloaded, compiled and
installed FOX. And if you're reading this, you must have already downloaded
and unpacked the FXRuby source tarball. The next step is to change directories
to the top-level and type:

    ruby install.rb config

By default, the install.rb script will look for the FOX include files and
library in the standard /usr/local/include/fox and /usr/local/lib directories,
respectively. You can override these locations by passing a few additional
arguments to install.rb during this step, e.g.

    ruby install.rb config -- \
        --with-fox-include=/home/lyle/fox-1.0.42/include \
        --with-fox-lib=/home/lyle/fox-1.0.42/src/.libs

Once the build has been configured, you can start the build by typing:

    ruby install.rb setup

It will take quite awhile to build FXRuby, even on a fast machine, so this
might be a good time to take a coffee break. If you run into problems during
the compilation, please check the list of things that go wrong:

    http://www.fxruby.org/doc/build.html#TRAGEDIES

before sending Lyle an e-mail. There's a good chance that someone else has
run into this problem already and that we've documented the workaround(s).

Once it's finished compiling, install FXRuby by typing:

    ruby install.rb install

