docs/download.html

   1 <HTML>
   2
   3 <TITLE>Getting Mesa</TITLE>
   4
   5 <link rel="stylesheet" type="text/css" href="mesa.css"></head>
   6
   7 <BODY>
   8
   9 <H1>Downloading</H1>
  10
  11 <p>
  12 Last development release: <b>6.5.2</b>
  13 </p>
  14
  15 <p>
  16 Last stable release: <b>6.4.2</b>
  17 </p>
  18
  19 <p>
  20 Primary download site:
  21 <a href="http://sourceforge.net/project/showfiles.php?group_id=3"
  22 target="_parent">SourceForge</a>
  23 </p>
  24
  25
  26 <p>
  27 Mesa is distributed in several parts:
  28 </p>
  29 <ul>
  30 <li><b>MesaLib-x.y.z</b> - the main Mesa library source code, drivers
  31     and documentation.
  32 </li>
  33 <li><b>MesaDemos-x.y.z</b> - OpenGL demonstration and test programs.
  34     Most of the programs require GLUT (either the
  35     <a href="http://www.opengl.org/resources/libraries/glut"
  36     target="_parent">original GLUT by Mark Kilgard</a> or
  37     <a href="http://freeglut.sourceforge.net" target="_parent">freeglut</a> or
  38     <a href="http://openglut.sourceforge.net" target="_parent">OpenGLUT</a>).
  39 </li>
  40 <li><b>MesaGLUT-x.y.z</b> - Mark Kilgard's GLUT, easily compiled and used
  41     with Mesa.  Plus, other implementation of GLUT for DOS, OS/2, BeOS, etc.
  42 </li>
  43 </ul>
  44
  45 <p>
  46 If you're not interested in running the demos, you'll only need the first
  47 package.
  48 </p>
  49
  50 <p>
  51 If you're new to this and not sure what you're doing, grab all three packages.
  52 </p>
  53
  54 <p>
  55 The packages are available in .tar.gz, .tar.bz2 and .zip formats.
  56 Other sites might offer additional package formats.
  57 </p>
  58
  59 <H1>Unpacking</H1>
  60
  61 <p>
  62 All the packages should be in the same directory prior to unpacking.
  63 </p>
  64
  65 <ul>
  66 <li>To unpack .tar.gz files:
  67 <pre>
  68         tar zxf MesaLib-X.Y.tar.gz
  69         tar zxf MesaDemos-X.Y.tar.gz
  70         tar zxf MesaGLUT-X.Y.tar.gz
  71 </pre>
  72 or
  73 <pre>
  74         gzcat MesaLib-X.Y.tar.gz | tar xf -
  75         gzcat MesaDemos-X.Y.tar.gz | tar xf -
  76         gzcat MesaGLUT-X.Y.tar.gz | tar xf -
  77 </pre>
  78 or
  79 <pre>
  80         gunzip MesaLib-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
  81         gunzip MesaDemos-X.Y.tar.gz ; tar xf MesaDemos-X.Y.tar
  82         gunzip MesaGLUT-X.Y.tar.gz ; tar xf MesaGLUT-X.Y.tar
  83 </pre>
  84 <li>To unpack .tar.bz2 files:
  85 <pre>
  86         bunzip2 -c MesaLib-X.Y.tar.gz | tar xf -
  87         bunzip2 -c MesaDemos-X.Y.tar.gz | tar xf -
  88         bunzip2 -c MesaGLUT-X.Y.tar.gz | tar xf -
  89 </pre>
  90 <li>To unpack .zip files:
  91 <pre>
  92         unzip MesaLib-X.Y.zip
  93         unzip MesaDemos-X.Y.zip
  94         unzip MesaGLUT-X.Y.zip
  95 </pre>
  96 </ul>
  97
  98
  99 <h1>Contents</h1>
 100
 101 <p>
 102 After unpacking you'll have these files and directories (among others):
 103 </p>
 104 <pre>
 105 Makefile        - top-level Makefile for most systems
 106 configs/        - makefile parameter files for various systems
 107 include/        - GL header (include) files
 108 bin/            - shell scripts for making shared libraries, etc
 109 docs/           - documentation
 110 src/            - source code for libraries
 111 src/mesa        - sources for the main Mesa library and device drivers
 112 src/glu         - libGLU source code
 113 src/glx         - sources for building libGL with full GLX and DRI support
 114 src/glw         - Xt/Motif/OpenGL widget code
 115 </pre>
 116
 117 If you downloaded and unpacked the MesaDemos.X.Y package:
 118
 119 <pre>
 120 progs/demos     - original Mesa demos
 121 progs/xdemos    - GLX OpenGL/Mesa demos
 122 progs/redbook   - examples from the OpenGL Programming Guide
 123 progs/samples   - examples from SGI
 124 progs/images/   - image files
 125 </pre>
 126
 127 If you downloaded and unpacked the MesaGLUT.X.Y package:
 128 <pre>
 129 src/glut        - GLUT library source code
 130 </pre>
 131
 132 <p>
 133 Proceed to the <a href="install.html">compilation and installation
 134 instructions</a>.
 135 </p>
 136
 137
 138 </BODY>
 139 </HTML>