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

Diff for /code/nel/INSTALL between version 1.9 and 1.19

version 1.9, 2001/02/16 09:29:04 version 1.19, 2001/10/08 14:52:19
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 need the following libraries :
  
       - STLPort  4.0   <URL:http://www.stlport.org/>       - STLPort 4.0    <URL:http://www.stlport.org/>            (Mandatory)
       - FreeType 2     <URL:http://www.freetype.org/>       - FreeType 2     <URL:http://freetype.sourceforge.net/>   (NeL 3D)
       - Python   1.5   <URL:http://www.python.org/>       - OpenAL         <URL:http://www.openal.org/>             (NeL Sound)
        - Python 1.5     <URL:http://www.python.org/>             (NeL AI)
        - LibXML         <URL:http://www.xmlsoft.org/>            (NeL Misc)
  
     STLPort need to be compiled. NeL is using the SGI iostreams and it require
     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
    softwares :    softwares :
Line 25 
Line 21 
       - 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/> 
  
    Some of the GNU/Linux distributions uses a "custom" version of Mesa which       - Mesa  3.3      <URL:http://www.mesa3d.org/>             (NeL 3D)
    include the last SGI's version of the glext.h file, which is good :-). 
    The other GNU/Linux distributions use a strict distribution of Mesa,    On some OpenGL implementations, you migth have some troubles, coming from
    which migth use an older version of that file. So if you encounter    the <GL/glext.h> file, to get NeL to compile. This file could be missing
    some problems during the NeL compilation concerning the GL_GLEXT_VERSION,    or not up to date. You will find the latest version of this file on SGI's
    you should download the last version of the glext.h on SGI's website :    website :
    <URL:http://oss.sgi.com/projects/ogl-sample/ABI/glext.h>. 
        - glext.h        <URL:http://oss.sgi.com/projects/ogl-sample/ABI/glext.h>
  
    Most of our documentation is done using Doxygen, so you might need it    Most of our documentation is done using Doxygen, so you might need it
    to read our prose and our code documentation. If you want have nice    to read our prose and our code documentation. If you want have nice
Line 61 
Line 57 
       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 SP4.
  
       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.       long compilation process, and you should carefully read these libraries
        documentation (at least the README and INSTALL files) before compiling
        and installing them.
  
        STLport Compilation :
  
           - Open a Dos window and go in the STLPort's src directory.
  
           - Rename or copy the "vc6-unicode.mak" to "Makefile".
  
           - Execute `nmake clean all` followed by `nmake install`.
  
        FreeType compilation, by using GNU Make :
  
           - You need to intall GNU make and to place it in the PATH.
  
             <URL:http://ftpsearch.lycos.com/swadv/AdvResults.asp?query=gnumake-win32>
  
           - Open a Dos window and go in the FreeType's directory.
  
           - Execute `make setup visualc' followed by `make`.
  
        FreeType compilation, by using an IDE :
  
           - Compile every (base and optionnal) library components listed
             at the end of the FreeType's INSTALL file.
  
       Set up Visual C++ to find the STLPort and FreeType libraries. This       Set up Visual C++ to find the STLPort and FreeType libraries. This
       is done in the [Tools -> Options -> Directories] menu :       is done in the [Tools -> Options -> Directories] menu :
Line 95 
Line 116 
    2. GNU/Linux compilation    2. GNU/Linux compilation
    ------------------------    ------------------------
  
       The compilation on GNU/Linux has been done only on RedHat 6.2 with 
       GCC 2.96. 
  
       In the NeL directory do :       In the NeL directory do :
  
          % ./configure --with-stlport=<Path_to_the_stlport_headers_files> \        In the case (ex: after a cvs checkout) that you need to rebuild the
                        --with-python=<Path_to_the_python_headers_files>        "configure" script and/or the "Makefile.in" files, execute the
         "bootstrap" script in the NeL directory :
  
           % ./bootstrap
  
           % ./configure --with-stlport=<Path_to_the_stlport_install_directory>
  
          % 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 124 
Line 161 
  
          % ./configure --help          % ./configure --help
  
       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 NeL directory : 
  
          % ./bootstrap 
  
  
 Installation Installation
 ============ ============
Line 145 
Line 176 
  
       % 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.9 
changed lines
 Added in v.1.19