[BACK] Return to INSTALL CVS log [TXT][DIR] Up to Nevrax / code / nel

Diff for /code/nel/INSTALL between version 1.15 and 1.29

version 1.15, 2001/04/10 13:44:50 version 1.29, 2002/05/02 12:49:16
Line 1 
Line 1 
  
 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 Requirements
 ============ ============
  
    The NeL library need the following libraries :    The NeL library needs the following libraries :
  
       - STLPort  4.0   <URL:http://www.stlport.org/>       - STLPort 4.5    <URL:http://www.stlport.org/>            (Mandatory)
       - FreeType 2     <URL:http://freetype.sourceforge.net/>       - LibXML 2.4.13  <URL:http://www.xmlsoft.org/>            (Mandatory)
       - Python   1.5   <URL:http://www.python.org/>       - FreeType 2     <URL:http://freetype.sourceforge.net/>   (NeL 3D)
        - OpenAL         <URL:http://www.openal.org/>             (NeL Sound)
        - Python 1.5     <URL:http://www.python.org/>             (NeL AI)
        - Direct Input 8 <URL:http://www.microsoft.com/directx>   (NeL MISC, Windows version)
        - EAX 2          <URL:http://eax.creative.com/>           (NeL Sound, Windows version)
  
    STLPort need to be compiled. NeL is using the SGI iostreams and it require    (Greater version of these libraries should also be ok, if not, contact us)
  
     STLPort needs to be compiled. NeL is using the SGI iostreams and it require
    the STLPort compilation and a linking of NeL with the STLPort library.    the STLPort compilation and a linking of NeL with the STLPort library.
  
    On a GNU/Linux platform you will need the following libraries and    On a GNU/Linux platform you will need the following libraries and
Line 28 
Line 25 
       - Libtool        <URL:http://www.gnu.org/software/libtool/libtool.html>       - Libtool        <URL:http://www.gnu.org/software/libtool/libtool.html>
       - Lex / Flex     <URL:http://www.gnu.org/software/flex/flex.html>       - Lex / Flex     <URL:http://www.gnu.org/software/flex/flex.html>
       - Yacc / Bison   <URL:http://www.gnu.org/software/bison/bison.html>       - Yacc / Bison   <URL:http://www.gnu.org/software/bison/bison.html>
       - Mesa     3.3   <URL:http://www.mesa3d.org/> 
        - Mesa  3.3      <URL:http://www.mesa3d.org/>             (NeL 3D)
  
    On some OpenGL implementations, you migth have some troubles, coming from    On some OpenGL implementations, you migth have some troubles, coming from
    the <GL/glext.h> file, to get NeL to compile. This file could be missing    the <GL/glext.h> file, to get NeL to compile. This file could be missing
Line 49 
Line 47 
    provided on your installation disk.     provided on your installation disk.
  
    The given sofware or library version numbers are the ones that we are    The given sofware or library version numbers are the ones that we are
    using. We don't know if it working with other (older or more recent)    using. We don't know if NeL will work with other (older or more recent)
    versions of these softwares or libraries. You are welcome to help us    versions of these softwares or libraries. You are welcome to help us
    to define more precisely these informations ;-)    to define more precisely these informations ;-)
  
     For windows users, note that you don't need to have the Direct Input (verion 8) dll
     on your system for NeL to run, but in this case, there will be no joystick support, and
     no low level access to keyboard and mouse. Anyway, you need dinput.lib to compile
  
  
 Compilation Compilation
 =========== ===========
Line 60 
Line 62 
    1. Windows compilation    1. Windows compilation
    ----------------------    ----------------------
  
       The compilation on Windows has been done only with Visual C++ 6.0 SP4.       The compilation on Windows has been done only with Visual C++ 6.0 SP5 + Processor Pack for SP5.
  
            SP5 and Processor Pack for SP5 can be found at:
  
                  <URL:http://msdn.microsoft.com/vstudio/downloads/ppack/download.asp>
  
  
       You first need to compile STLport and FreeType libraries. It's a quite       You first need to compile STLport and FreeType libraries. It's a quite
       long compilation process, and you should carefully read these libraries       long compilation process, and you should carefully read these libraries
Line 97 
Line 104 
            The STLPort include *must* be inserted before the microsoft one or            The STLPort include *must* be inserted before the microsoft one or
            the compiler will take microsoft STL instead of STLPort STL.            the compiler will take microsoft STL instead of STLPort STL.
            (use the arrow button to put the STLPort include at the top)            (use the arrow button to put the STLPort include at the top)
            ex: D:/stlport-4.0/stlport            ex: D:/stlport-4.5/stlport
  
          - Add the STLPort library directory to the "Library Files" category.          - Add the STLPort library directory to the "Library Files" category.
            ex: D:/stlport-4.0/lib            ex: D:/stlport-4.5/lib
  
          - Add the FreeType include directory to the "Include Files" category.          - Add the FreeType include directory to the "Include Files" category.
            ex: D:/freetype-2.0/include            ex: D:/freetype-2.0/include
Line 108 
Line 115 
          - Add the FreeType library directory to the "Library Files" category.          - Add the FreeType library directory to the "Library Files" category.
            ex: D:/freetype-2.0/obj            ex: D:/freetype-2.0/obj
  
                  
        Requirements for Nel Misc: Direct Input 8
  
           - Install the DirectX8 SDK
           - Add mssdk/include to the "Include Files" category.
             Add mssdk/lib to the "Library Files" category.
             Make sure these appear before visual c++ includes, as an older
             version of directX may be present in Visual C++ headers.
  
        Requirements for NeL Sound: OpenAL and EAX 2
  
           - Add the include and library directories for OpenAL:
             Add openaldir/win/ to the "Include Files" category.
             Add openaldir/win/al/ to the "Include Files" category.
             Add openaldir/win/openal32/release to the "Library Files" category.
             Add openaldir/win/alut/release to the "Library Files" category.
             (Please note the include directories are not located in
             openaldir/include/ but in openaldir/win/ on the Windows platform)
  
           - Add the include and library directories for EAX:
             Add eaxdir/include to the "Include Files" category.
             Add eaxdir/libs to the "Library Files" category.
  
           - At runtime, you will need openal32.dll and eax.dll in your path.
  
       Open the workspace file "nel.dsw" (in the menu [File -> Workspace]).       Open the workspace file "nel.dsw" (in the menu [File -> Workspace]).
  
       Setup Visual C++ to find the NeL include and library files :       Setup Visual C++ to find the NeL include and library files :
  
          - Add the NEL include directory to the "Library Files" category.          - Add the NEL include directory to the "Include Files" category.
            ex: D:/test/code/nel/include            ex: D:/test/code/nel/include
  
          - Add the STLPort library directory to the "Library Files" category.          - Add the NEL source directory to the "Include Files" category.
             ex: D:/test/code/nel/src
  
           - Add the NeL library directory to the "Library Files" category.
            ex: D:/test/code/nel/lib            ex: D:/test/code/nel/lib
  
  
Line 130 
Line 165 
   
          % ./bootstrap          % ./bootstrap
  
          % ./configure --with-stlport=<Path_to_the_stlport_headers_files> \          % ./configure --with-stlport=<Path_to_the_stlport_install_directory>
                        --with-python=<Path_to_the_python_headers_files> 
          % make          % make
  
       The "configure" script must be call with the "--with-stlport" and       The "configure" script must be call with the "--with-stlport".
       "--with-python" options. 
       The option "--with-stlport" allow to override the default STL headers       The option "--with-stlport" allow to override the default STL headers
       and the option "--with-python" tell to the configuration script, where 
       to find the Python headers files. 
  
       You migth need to specify the FreeType 2 installation prefix by using       It is possible to compile and install only the needed part of NeL.
       the "--with-freetype" argument (ex: "/usr/local" will look for the       So you may, by using --disable-<net|3d|pacs> and --enable-<sound|ai> :
       header files in "/usr/local/include" and the library files in the 
       "/usr/local/lid/ directory).          - misc
                default: Mandatory
           - net
                default: Enables
                desativate with: --disable-net
           - 3d
                default: Enable
                desativate with: --disable-3d
           - pacs
                default: Enable
                desativate with: --disable-pacs
           - sound
                default: Disable
                ativate with: --enable-sound
           - ai
                default: Disable
                ativate with: --enable-ai
  
       To pass additional arguments to the C++ compiler, use the command line :       To pass additional arguments to the C++ compiler, use the command line :
  
Line 169 
Line 217 
  
       % make install       % 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/>
        
  

Legend:
Removed from v.1.15 
changed lines
 Added in v.1.29