configure options for Heroes
============================
`configure' will do its best to find the libraries and functions
needed by the game. Still, you may give several options to `configure'
to help it, or to fine tune special features of Heroes.
`--enable-html-doc[=DIR]'
Build and install html documentation in directory `DIR'. If `DIR'
is not given, install in `$datadir/heroes/doc'.
`--disable-sound'
Turn off sound support. Sound is enabled by default, unless no
sound engine is found).
`--disable-joystick'
Do not include joystick support in the game. Joystick support is
enabled by default, unless you don't have GII or joystick support
in SDL.
`--with-sdl[=DIR]'
Specify that you want to link with SDL. This is the default if
LibGGI is not installed. If you installed SDL in some
non-standard place, you can specify the installation path as an
argument. For example:
./configure --with-sdl=/home/adl/usr
`configure' will then look for `/home/adl/usr/bin/sdl-config' and
configure Heroes accordingly.
`--with-ggi[=DIR]'
Link with LibGGI. This is the default if LibGGI is installed. If
you installed LibGGI in some non-standard place, you can specify
the installation path as an argument
`--with-allegro[=DIR]'
Link with Allegro. This is the default is neither LibGGI not SDL
can be used. If you installed Allegro in some non-standard place,
you can specify the installation path as an argument
`--with-mikmod[=DIR]'
Use LibMikMod four sound output. This is the default if LibMikMod
is installed and LibGGI have been selected. You may specify where
LibMikMod is installed using the optional argument.
`--with-sdl-mixer[=DIR]'
Use SDL_mixer for sound output. This is the default if SDL_mixer
is installed and SDL has been selected. You may specify where
SDL_mixer is installed using the optional argument. Using this
option implies `--with-sdl'.
`--disable-heroes-debug'
Turn off tracing support. See the description of the
`HEROES_DEBUG' variable (Note:Environment). This is enabled by
default to facilitate bug reporting. Using this options should
reduce the size of the resulting binary, and speed up the game by
an indiscernible amount.
The following options are for developing purpose. The default
configuration should be suitable for end users (i.e. players) but people
attempting to hack the code may want debugging symbols or compiler
warnings.
`--enable-debug'
`--disable-debug'
This is a three state option. The default is to compile with
debugging symbols: this produce bigger binaries but allow to get
helpfull coredumps, without slowing down the game. You may want
to use `--enable-debug' to include more debugging data and turn on
some debugging code. Use `--disable-debug' to turn this off.
Translators: you _do want_ to turn this option on, really! Because
the debugging code includes some checks on the translated messages.
`--disable-optimizations'
Turn off compiler optimizations options. This can ease debugging.
If you want to supply your own optimizations options, use
something like `--enable-optimizations='-O3 -march=pentium''.
`--enable-warnings'
Try to turn on a large bunch of compiler warnings.
`--enable-assert'
Turn on some assertions squattered over the source code. This can
slow down things a bit.
`--enable-devel'
Is a shorthand for `--enable-debug --disable-optimizations
--enable-warnings --enable-assert'.
`--with-mpatrol'
Link with MPatrol, a `malloc()' debugger.
`--with-mtrace'
Use GNU libc's `mtrace()' facility to check `malloc()' usage.
`--with-dmalloc'
Link with Dmalloc, a `malloc()' debugger.
`--with-efence'
Link with Electric Fence, a `malloc()' debugger.
`--enable-mem-debug'
Check for `mtrace()', Dmalloc, or Electric Fence. Use the first
found.
`--enable-gprof'
Enable profiling support with `gcc', you need `gprof' to inspect
the file resulting from a run of Heroes.
`--disable-display'
This disable all screen output, making the game rather unplayable.
This suppress decencies over third party libraries like GGI or SDL,
therefore you may find it useful with some debugging tools like
checkergcc.