Remove libGLU
[mesa.git] / docs / download.html
index 22a22e6d57a0b84b690671f4495b659bd433bc5a..a1a1baa28ff8302356b061660b22b0bbd9278d40 100644 (file)
-<HTML>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en">
+<head>
+  <meta http-equiv="content-type" content="text/html; charset=utf-8">
+  <title>Getting Mesa</title>
+  <link rel="stylesheet" type="text/css" href="mesa.css">
+</head>
+<body>
 
-<TITLE>Getting Mesa</TITLE>
-
-<BODY text="#000000" bgcolor="#55bbff" link="#111188">
-
-<H1>Downloading / Unpacking</H1>
+<h1>Downloading</h1>
 
 <p>
-Mesa can be downloaded from the
-<a href="http://www.sourceforge.net/projects/mesa3d" target="_parent">
-SourceForge download area</A>.
+Primary Mesa download site:
+<a href="ftp://ftp.freedesktop.org/pub/mesa/"
+target="_parent">freedesktop.org</a> (FTP)
 </p>
 
 <p>
-Since version 2.3, Mesa is distributed in two pieces:  main library code
-and demos.  If you're upgrading from a previous version of Mesa or you're not
-interested in the demos you can just download the core Mesa archive file.
+When a new release is coming, release candidates (betas) may be found
+<a href="ftp://ftp.freedesktop.org/pub/mesa/beta/" target="_parent">here</a>.
 </p>
 
+
+<h1>Unpacking</h1>
+
 <p>
-Mesa is available in at least three archive formats:
+Mesa releases are available in three formats: .tar.bz2, .tar.gz, and .zip
 </p>
 
+<p>
+To unpack .tar.gz files:
+</p>
+<pre>
+       tar zxf MesaLib-x.y.z.tar.gz
+</pre>
+or
+<pre>
+       gzcat MesaLib-x.y.z.tar.gz | tar xf -
+</pre>
+or
+<pre>
+       gunzip MesaLib-x.y.z.tar.gz ; tar xf MesaLib-x.y.z.tar
+</pre>
+<p>
+To unpack .tar.bz2 files:
+</p>
+<pre>
+       bunzip2 -c MesaLib-x.y.z.tar.gz | tar xf -
+</pre>
+<p>
+To unpack .zip files:
+</p>
 <pre>
-1. GNU zip/tar
-
-       Download MesaLib-X.Y.tar.gz and optionally MesaDemos-X.Y.tar.gz
-       Unpack with:
-               gzcat MesaLib-X.Y.tar.gz | tar xf -
-               gzcat MesaDemos-X.Y.tar.gz | tar xf -
-       or
-               gunzip MesaLib-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
-               gunzip MesaDemos-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
-       or
-               tar zxf MesaLib-X.Y.tar.gz
-               tar zxf MesaDemos-X.Y.tar.gz
-
-       If you don't have gzcat try zcat instead.
-
-2. Unix compressed/tar
-
-       Download MesaLib-X.Y.tar.Z and optionally MesaDemos-X.Y.tar.Z
-       Unpack with:
-               zcat MesaLib-X.Y.tar.Z | tar xf -
-               zcat MesaDemos-X.Y.tar.Z | tar xf -
-
-3. ZIP format
-
-       Download MesaLib-X.Y.zip and optionally MesaDemos-X.Y.zip
-       Unpack with:
-               unzip MesaLib-X.Y.zip
-               unzip MesaDemos-X.Y.zip
+       unzip MesaLib-x.y.z.zip
 </pre>
 
+
+<h1>Contents</h1>
+
 <p>
-After unpacking you'll have these directories (and more):
+After unpacking you'll have these files and directories (among others):
 </p>
 <pre>
-Makefile.X11   - top-level Makefile for X11-based systems
-Make-config    - system configurations used by the Makefile.X11
+Makefile       - top-level Makefile for most systems
+configs/       - makefile parameter files for various systems
 include/       - GL header (include) files
 bin/           - shell scripts for making shared libraries, etc
-lib/           - final client libraries, created during compilation
 docs/          - documentation
 src/           - source code for libraries
 src/mesa       - sources for the main Mesa library and device drivers
-src/glu                - libGLU source code
-src/glw                - Xt/Motif/OpenGL widget code
+src/gallium     - sources for Gallium and Gallium drivers
+src/glx                - sources for building libGL with full GLX and DRI support
+</pre>
 
 
-and if you downloaded and unpacked the MesaDemos.X.Y archive:
+<p>
+Proceed to the <a href="install.html">compilation and installation
+instructions</a>.
+</p>
 
-src/glut       - GLUT source code
-progs/         - OpenGL programs
-progs/demos    - original Mesa demos
-progs/xdemos   - GLX OpenGL/Mesa demos
-progs/redbook  - examples from the OpenGL Programming Guide
-progs/samples  - examples from SGI
-progs/images/  - image files
 
-</pre>
+<h1>Demos, GLUT, and GLU</h1>
 
 <p>
-Proceed to <a href="install.html">compilation and installation
-instructions</a>.
+A package of SGI's GLU library is available
+<a href="ftp://ftp.freedesktop.org/pub/mesa/glu/" target="_parent">here</a>
 </p>
 
-<H1>GLUT</H1>
+<p>
+A package of Mark Kilgard's GLUT library is available
+<a href="ftp://ftp.freedesktop.org/pub/mesa/glut/" target="_parent">here</a>
+</p>
 
 <p>
-Mesa 2.5 and later includes Mark Kilgard's GLUT library (GL Utility Toolkit).
-GLUT is built automatically on systems which support it.
+The Mesa demos collection is available
+<a href="ftp://ftp.freedesktop.org/pub/mesa/demos/" target="_parent">here</a>
 </p>
+
 <p>
-The GLUT tests, demos, examples, etc are not included, just the main library.
-To obtain the latest complete release of GLUT please visit the
-<a href="http://www.opengl.org/developers/documentation/glut/index.html"
-target ="_parent">GLUT homepage</a>
+In the past, GLUT, GLU and the Mesa demos were released in conjunction with
+Mesa releases.  But since GLUT, GLU and the demos change infrequently, they
+were split off into their own git repositories:
+
+<a href="http://cgit.freedesktop.org/mesa/glut/">GLUT</a>,
+<a href="http://cgit.freedesktop.org/mesa/glu/">GLU</a> and
+<a href="http://cgit.freedesktop.org/mesa/demos/">Demos</a>,
 </p>
 
 
-</BODY>
-</HTML>
+</body>
+</html>