Summary:
--------
StdAir aims at providing a clean API, and the corresponding C++
implementation, for the basis of Airline IT and travel distribution
Business Object Model (BOM), that is, to be used by several other open
source projects, such as AirRAC, RMOL, AirInv, AvlCal, AirSched, SimFQT,
SimLFS, SimCRS, TravelCCM, SEvMgr, TraDemGen, TvlSim, OpenTREP, etc.

StdAir is the one of the components of the Travel Market Simulator
(http://www.travel-market-simulator). However, it may be used in a
stand-alone mode.

Getting and installing from the Fedora/CentOS/RedHat distribution:
------------------------------------------------------------------
Just use Yum:
yum -y install stdair-devel stdair-doc

You can also get the RPM packages (which may work on Linux
distributions like Novel Suse and Mandriva) from the Fedora repository
(e.g., for Fedora 18, 
http://fr2.rpmfind.net/linux/fedora/releases/18/Everything/)


Building the library and test binary from Git repository:
----------------------------------------------------------------
The Sourceforge Git repository may be cloned as following:
git clone ssh://stdair.git.sourceforge.net/gitroot/stdair/stdair stdairgit
cd stdairgit
git checkout trunk

Then, you need the following packages (Fedora/RedHat/CentOS names here, 
but names may vary according to distributions):
  * cmake
  * gcc-c++
  * boost-devel
  * readline-devel
  * soci-mysql-devel
  * zeromq-devel
  * python-devel
  * gettext-devel
  * doxygen
  * ghostscript (optional)
  * texlive-latex (optional)
  * rpm-build (optional)

Building the library and test binary from the tarball:
------------------------------------------------------
The latest stable source tarball (stdair*.tar.gz or .bz2) can be found here:
http://sourceforge.net/project/showfiles.php?group_id=267760

To customise the following to your environment, you can alter the path
to the installation directory:
export INSTALL_BASEDIR=/home/user/dev/deliveries
export LIBSUFFIX_4_CMAKE="-DLIB_SUFFIX=64"

Then, as usual:
* To configure the project, type something like:
  mkdir build && cd build
  cmake -DCMAKE_INSTALL_PREFIX=${INSTALL_BASEDIR}/stdair-1.00.1 \
	-DCMAKE_BUILD_TYPE:STRING=Debug -DENABLE_TEST:BOOL=ON \
	-DINSTALL_DOC:BOOL=ON -DRUN_GCOV:BOOL=OFF ${LIBSUFFIX_4_CMAKE} ..
* To build the project, type:
  make
* To test the project, type:
  make check
* To install the library (libstdair*.so*) and the binary (stdair), just type:
  make install
  cd /home/user/dev/deliveries
  rm -f stdair-stable && ln -s stdair-1.00.1 stdair-stable
  cd -
* To package the source files, type:
  make dist
* To package the binary and the (HTML and PDF) documentation:
  make package
* To browse the (just installed, if enabled) HTML documentation:
  midori file://${INSTALL_BASEDIR}/stdair-1.00.1/share/doc/stdair-1.00.1/html/index.html
* To browse the (just installed, if enabled) PDF documentation:
  evince ${INSTALL_BASEDIR}/stdair-1.00.1/share/doc/stdair-1.00.1/html/refman.pdf
* To run the local binary version:
  ./stdair/stdair -b
* To run the installed version:
  /home/user/dev/deliveries/stdair-stable/bin/stdair -b
  ${INSTALL_BASEDIR}/stdair-stable/bin/stdair -b

Denis Arnaud (December 2012)