eliot/INSTALL
Olivier Teulière 0a4b342f78 - Players can now have a name
- Use player names in the ncurses interface
 - In training mode, create the hidden player in the constructor, not in start()
 - When the AI has nothing to play, change the letters instead of simply passing
 - New Makefile to build the win32 dependencies automatically (INSTALL file updated)
2008-01-19 19:33:08 +00:00

86 lines
2.9 KiB
Text

Installation on Linux/Unix
==========================
In the following, do not forget that the ./configure command can take options.
Run ./configure --help to have the list of available options.
* If you build from a CVS snapshot, run the following commands:
./bootstrap
./configure
make
Then, as root:
make install
No graphical interface is built by default, see below for more details.
* If you build from a release tarball, run the following commands:
./configure
make
Then, as root:
make install
No graphical interface is built by default, see below for more details.
There are in fact several interfaces to Eliot:
- one in text mode: mostly useful to debug Eliot
- one using the ncursesw library: nice but not really graphical
- a wxWidgets interface: complete, but it does not allow multiplayer
modes, only training mode
- a Qt interface: currently under construction, it will replace the
wxWidgets interface when finished. It will support all Eliot features.
These interfaces can be enabled or disabled at configuration time. Example:
./configure --disable-text --enable-ncurses --disable-wxwidgets --enable-qt
Windows build
=============
There are 2 ways to proceed:
* cross-compilation from a Linux host, using the mingw32 cross-compiler
* directly on Windows, using Cygwin (http://www.cygwin.com/)
Only the cross-compilation is officially supported (but adapting these
instructions for Cygwin shouldn't be too hard; patches welcome!).
Here are the steps for the cross-compilation:
* install the build environment (this step is not documented here,
as it is out of the scope of this document)
* build and install dependencies:
The Makefile in the 'extras/contrib' directory should be able to do it for you:
cd extras/contrib && make all
Eliot dependencies (libiconv, boost, wxWidgets and Qt) will be downloaded
and cross-compiled, except Qt, which is only downloaded. Install it with
Wine, ignoring the warning that mingw is not found.
The dependencies are installed in 'extras/contrib/inst'
* build Eliot:
- if you don't have the 'configure' script, generate it:
./bootstrap
- because of a bug in gettext, you need to apply a little patch to the files
installed in the 'intl' directory:
- download the patch here (link in the top-left-hand corner)
http://www.koders.com/noncode/fid46DF595700FEB564B6EF45BFF55067F95DCF0420.aspx
- apply the patch:
patch -p2 < gettext-win32.patch
- configure with the following command:
export INST=`pwd`/extras/contrib/inst && \
CPPFLAGS=-I${INST}/include LDFLAGS=-L${INST}/lib \
CC=i586-mingw32msvc-gcc CXX=i586-mingw32msvc-g++ \
./configure --host=i586-mingw32msvc --build=i386-linux \
--enable-wxwidgets --with-wx-config=${INST}/bin/wx-config \
--with-boost=${INST}
- to compile, run 'make', possibly followed with 'make install'