home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 6 / AACD06.ISO / AACD / System / Mesa-3.1 / docs / INSTALL < prev    next >
Text File  |  1999-10-21  |  6KB  |  220 lines
  1.  
  2.              Mesa compilation and installation instructions
  3.  
  4.  
  5. Mesa 3.1 now uses GNU autoconfig for compilation and installation.
  6. Previously, traditional Makefiles were used to compile Mesa.
  7.  
  8. You now have the choice of how you want to build Mesa:
  9.  
  10.   NEW-STYLE:  Basically, type "./configure" followed by "make"
  11.               This should work on most Unix-like operating systems.
  12.               For more details, see the NEW-STYLE section below.
  13.  
  14.   OLD-STYLE:  Simply type "make" and you'll see a list of supported
  15.               system configurations.  Pick one and type "make <config>"
  16.               For more details, see the OLD-STYLE section below.
  17.  
  18.  
  19.  
  20. ===============================================================================
  21. NEW-STYLE Mesa compilation and installation instructions begin here
  22. -------------------------------------------------------------------------------
  23.  
  24. 0) If you've downloaded Mesa via CVS there will not be a "configure"
  25.    script.  You'll have to run the "bootstrap" script first.  This script
  26.    may not work on any OS other than Linux.
  27.  
  28. 1) Run the configure script
  29.  
  30.     ./configure [options]
  31.  
  32. Possible options are:
  33.  
  34. --prefix=DIR
  35.     The toplevel directory of the hierachy in which Mesa
  36.     will be installed (DIR/include,DIR/lib etc.).
  37.     The default is "/usr/local".
  38.  
  39. --sysconfdir=DIR
  40.     The directory where Mesa configuration files
  41.     will be stored.    The default is "$prefix/etc".
  42.     You may want to overwrite the default with --sysconfdir=/etc.
  43.  
  44. --enable-static
  45.     Enable building of static libraries.
  46.     Static libraries are NOT built by default.
  47.     
  48. --disable-shared
  49.     Disable building of shared libraries.
  50.     Shared libraries are built by default.
  51.  
  52. --enable-debug
  53.     Enable debugging messages (disabled by default).
  54.     
  55. --enable-profile
  56.     Enable profiling (disabled by default).
  57.     
  58. --disable-optimize
  59.     Disable extra optimizations (enabled by default,
  60.     i.e., optimize for maximum performance).
  61.     
  62. --enable-warn
  63.     Enable extended compiler warnings (disabled by default).
  64.     
  65. --enable-x86[=ARG]
  66. --disable-x86
  67.     Enable/disable x86 assembler support to speed up Mesa
  68.     (autodetected by default). You may set `on' or `off'.
  69.     
  70. --enable-3dnow[=ARG]
  71. --disable-3dnow
  72.     Enable/disable 3Dnow support to speed up Mesa
  73.     (autodetected by default). You may set `on' or `off'.
  74.     
  75. --enable-mmx[=ARG]
  76. --disable-mmx
  77.     Enable/disable MMX support to speed up Mesa
  78.     (autodetected by default). You may set `on' or `off'.
  79.     
  80. --with-glide[=DIR]
  81. --without-glide
  82.     Enable/disable support for Glide (autodetected by default).
  83.     DIR is the installation directory of Glide.
  84.     If Glide cannot be found, the driver won't be built.
  85.     
  86. --with-glut[=DIR]
  87. --without-glut
  88.     Don't/use already-installed GLUT (autodetected by default).
  89.     DIR is the installation directory of Glut.
  90.     If GLUT cannot be found, the version shipped with Mesa will be built.
  91.     
  92. --with-ggi[=DIR]
  93. --without-ggi
  94.     Enable/disable support for GGI (autodetected by default).
  95.     DIR is the installation directory of GGI.
  96.     If GGI cannot be found, the driver won't be built.
  97.  
  98. --disable-ggi-fbdev
  99.     Don't build the GGI fbdev target (autodetected by default).
  100.     
  101. --disable-ggi-genkgi
  102.     Don't build the GGI generic KGI driver (autodetected by default).
  103.     
  104. --disable-ggi-savage4
  105.     Don't build the GGI Savage4 KGI driver (autodetected by default).
  106.     
  107. --disable-osmesa
  108.     Disable OSmesa (offscreen rendering) support (enabled by default).
  109.  
  110. --with-svga[=DIR]
  111. --without-svga
  112.     Enable/disable support for SVGALib (autodetected by default).
  113.     DIR is the installation directory of SVGALib.
  114.     If SVGALib cannot be found, the driver won't be built.
  115.  
  116. --x-includes=DIR
  117.     Search for the X include files in DIR.
  118.     
  119. --x-libraries=DIR
  120.     Search for the X library files in DIR.
  121.  
  122. User specific compiler options can be set using the shell variable
  123. CFLAGS. For instance,
  124.     CFLAGS="-g -O2" ./configure
  125. (on some systems: env CFLAGS="-g -O2" ./configure)
  126. sets the compiler flags to "-g -O2".
  127.  
  128. For more options run "./configure --help" and read INSTALL.GNU.
  129.  
  130.  
  131. 2) To build the Mesa libraries run:
  132.  
  133.     make
  134.  
  135. Optionally, you can strip the libraries using
  136.  
  137.     make strip
  138.     
  139. Now make sure that you have the permissions to install Mesa in the 
  140. specified directories, for example, by becoming super user ("su")
  141. Then run:
  142.  
  143.     make install
  144.  
  145. Mesa is now installed.
  146. Please don't move the installed files but rerun all installation
  147. steps if you want to use other directories.
  148.  
  149.  
  150. 3) To test whether Mesa works properly you might want to run the Mesa demos:
  151.  
  152.     make check
  153.     
  154. Builds all demos.
  155.  
  156.     make exec
  157.  
  158. Builds and executes all demos.    
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165. ===============================================================================
  166. OLD-STYLE Mesa compilation and installation instructions begin here
  167. -------------------------------------------------------------------------------
  168.  
  169. To build Mesa on most Unix-like operations systems, start by typing
  170. "make" alone.  You'll see a list of supported system configurations.
  171. Choose one, call it <config>, type "make <config>".
  172.  
  173. For system-specific information check out these files in the docs/
  174. directory:
  175.  
  176.     System                README file
  177.     -----------------        ------------
  178.     Unix/X11            README.X11
  179.     Windows 95/N%            README.WIN32
  180.     DOS                README.DOS
  181.     Linux/Windows w/ 3Dfx hardware    README.3DFX
  182.     Linux with GGI            README.GGI
  183.     Linux with threading        README.MITS
  184.     Amigas with Amiwin        README.AMIWIN
  185.     BeOS                README.BEOS
  186.     LynxOS                README.LYNXOS
  187.     SciTech MGL            README.MGL
  188.     IBM OS/2            README.OS2
  189.     Windows w/ S3 Virge hardware    README.VIRGE
  190.     VMS                README.VMS
  191.     Allegro DJGPP            README.DJA
  192.     Direct3D driver            README.D3D
  193.  
  194.  
  195. Header and library files:
  196.    After you've compiled Mesa and tried the demos I recommend the following
  197.    procedure for "installing" Mesa on Unix systems.
  198.  
  199.    Copy the Mesa include/GL directory to /usr/local/include:
  200.     cp -r include/GL /usr/local/include
  201.  
  202.    Copy the Mesa library files to /usr/local/lib:
  203.     cp lib/* /usr/local/lib
  204.  
  205.     (actually, use "cp -d" on Linux to preserve symbolic links)
  206.  
  207.    Create a few symbolic links so that compiling OpenGL applications is easy:
  208.     cd /usr/local/lib
  209.     IF USING STATIC (lib*.a) FILES THEN
  210.         ln -s libMesaGL.a libGL.a
  211.         ln -s libMesaGLU.a libGLU.a
  212.     ELSE
  213.         ln -s libMesaGL.so libGL.so
  214.         ln -s libMesaGLU.so libGLU.so
  215.     ENDIF
  216.  
  217.  
  218. ===============================================================================
  219. $Id: INSTALL,v 1.5 1999/10/20 18:53:46 brianp Exp $
  220.