eliot/INSTALL
2008-12-08 21:45:27 +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
See below for more details on the available interfaces.
* If you build from a release tarball, run the following commands:
./configure
make
Then, as root:
make install
See below for more details on the available interfaces.
There are in fact several interfaces to Eliot:
- one in text mode: mostly useful to debug Eliot
- one using the ncursesw library: nice and complete, but not really graphical
- a Qt interface: the best interface to use, it supports all the features.
This one is enabled by default if Qt development files are detected, but
you can force it with --enable-qt
These interfaces can be enabled or disabled at configuration time. Example:
./configure --disable-text --enable-ncurses --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, and Qt) will be downloaded
and cross-compiled (except Qt, which is already compiled).
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 may 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 && \
PKG_CONFIG_PATH="${INST}/lib/pkgconfig:${PKG_CONFIG_PATH}" \
CPPFLAGS=-I${INST}/include LDFLAGS=-L${INST}/lib \
CC=i586-mingw32msvc-gcc CXX=i586-mingw32msvc-g++ \
./configure --host=i586-mingw32msvc --build=i386-linux \
--with-boost=${INST}
- to compile, run 'make', possibly followed with 'make install'
- run 'make package-win32-zip' to get everything packed up in a nice .zip