BUILDING THE HUGO ENGINE FOR wxWIDGETS (formerly wxWindows)
-----------------------------------------------------------
Here are some brief notes on getting Hugo for wxWidgets (wxHugo)
built and running.


REQUIRED PACKAGES
-----------------
To compile wxHugo, you'll need:

(a) The wxHugo source (which you probably have, if you're reading this):

	hugov*_wxwin_source.tar.gz

(b) wxWidgets (formerly wxWindows) for your system, available from
    http://www.wxwidgets.org.  Version 2.4 or later is required.

(c) MikMod, if you're going to be supporting sound using the provided
    hesound.cpp source.  Version 3.1.9 or later is recommended.  Any
    fixes to the MikMod source are detailed in the file "mikmod_fixes".

The wxWidgets and MikMod libraries need to be compiled and installed
before building wxHugo.


UNIX/LINUX BUILD INSTRUCTIONS
-----------------------------

To build the Hugo Engine for wxWidgets (hewx), please follow the
following simple build instructions:

1.  If you haven't already done so, extract hugov*_wxwin_source.tar.gz
    by typing the following in a command shell:

	tar -xzf hugov*_wxwin_source.tar.gz

    This will create the Hugo directory and extract both the
    necessary source code into it.  It will create the "hewx",
    "source", and "gcc" subdirectories.  For building wxHugo,
    the "hewx" subdirectory is the one you'll be working with.

2.  Change to the "hugov*" directory created in (1) and
    build the wxHugo source package:

	cd hugov*
	make

If wxWidgets and MikMod were properly compiled and installed, wxHugo should
build successfully and create the executable file "hewx".


GTK 2 SUPPORT AND WXGTK 2.4
---------------------------

By default, wxHugo is currently packaged for GTK 1.2 support due to the
fact that the latest stable release of wxGTK at the time of release is 2.4,
for which GTK 2 support is still in development.  wxGTK 2.5 and later will
be built with GTK 2 support enabled by default.

Users with GTK 2 installed may wish to compile wxGTK and wxHugo with GTK 2
support.  (Some pre-packaged versions of wxGTK are built with GTK 2 support
by default.)  To do this, configure wxGTK 2.4 with --enable-gtk2 before
building.

It will then be necessary to edit the two indicated lines in the wxHugo
makefile (for LDFLAGS and SEARCHDIRS) to properly compile and link with
GTK 2.


TROUBLESHOOTING
---------------

If you receive compilation/runtime errors related to wxGTK or GTK symbols,
there is likely an incompatibility between library versions.  Possible
options include:

1.  Compile with explicit GTK 2 support as described in the section above
about "GTK 2 Support and wxGTK 2.4".

2.  If you receive errors about symbols such as "_gtk_accel_group_attach",
this is due to wxGTK 2.4's improper use of private GTK symbols that broke
with later GTK 2 releases.  You can either try to download and compile a
later version of wxGTK (the latest version as of this writing is the
development version 2.5.x), or apply the gtk2_wxgtk24.patch in the wxHugo
source package to the wxGTK 2.4 source to update the files menu.cpp and
settings.cpp in src/gtk.

3.  Otherwise, you can install (if it isn't already) GTK 1.2 from
http://www.gtk.org and compile with the GTK 1.2 options in the wxHugo
makefile (although this is probably a less desirable option since you'll
lose the benefits of GTK 2, including anti-aliased fonts, etc.).