If you find any bugs use the Nevrax Bug Tracking System :

   <URL:/bugs/>

If you need any help contact us on the NeL mailing-list :

   <URL:/mail/>


Requirements
============

   Snowballs need the folowing libraries :

      - STLPort 4.5           <URL:http://www.stlport.org/>
      - NeL                   <URL:/>
            Default install plus NeL Sound.
	    You need to launch the configure script with the '--enable-sound'
	    option.
      - NeLNS                 <URL:/>
            This is mandatory to run the Snowballs server but it isn't for
	    the Snowballs client.

   And the lastest Snowballs data pack available :

                              <URL:/download/cvs/>


Compilation
===========

   1. Windows compilation
   ----------------------

      The compilation on Windows has been done only with Visual C++ 6.0 SP4.

      Set up Visual C++ to find the STLPort libraries. This is done in the
      [Tools -> Options -> Directories] menu :

         - Add the STLPort include directory to the "Library Files" category.
           ex: D:/stlport-4.0/stlport

         - Add the STLPort library directory to the "Library Files" category.
           ex: D:/stlport-4.0/lib

      Open the workspace file "snowballs.dsw" (in the menu [File -> Workspace]).

      Setup Visual C++ to find the NeL include and library files :

         - Add the NEL include directory to the "Library Files" category.
           ex: D:/prefix/include

         - Add the STLPort library directory to the "Library Files" category.
           ex: D:/prefix/lib


   2. GNU/Linux compilation
   ------------------------

      In the case (ex: after a cvs checkout) that you need to rebuild the
      "configure" script and/or the "Makefile.in" files, execute the
      "bootstrap" script in the swnoballs directory :
 
         % ./bootstrap

      In the snowballs directory do :

         % ./configure --with-stlport=<Path_to_the_stlport_install_directory>

         % make

      The "configure" script must be call with the "--with-stlport" option.
      This option permit to override the default STL headers.

      To disable the client or the server compilation and install, use
      '--disable-client' and '--disable-server' options.

      To pass additional arguments to the C++ compiler, use the command line :

         % CXXFLAGS=-pipe ./configure --with-stlport=<STLPort_headers_path>

      To get the complete list of arguments of the "configure" script use the
      following command :

         % ./configure --help


Installation
============

   1. Windows installation
   -----------------------

      Not done yet.


   2. GNU/Linux installation
   --------------------------

      % make install


Contact us
==========

   If you find any bugs use the Nevrax Bug Tracking System :

      <URL:/bugs/>

   If you need any help contact us on the NeL mailing-list :

      <URL:/mail/>