docs: update package contents
[mesa.git] / docs / download.html
index 2d587f35f9f344910fca128968808fb393b801b1..8670b03d94a8ed2b8be3a391a2abeeb73612d874 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>
+<div class="header">
+  <h1>The Mesa 3D Graphics Library</h1>
+</div>
 
-<link rel="stylesheet" type="text/css" href="mesa.css"></head>
+<iframe src="contents.html"></iframe>
+<div class="content">
 
-<BODY>
-
-<H1>Downloading</H1>
+<h1>Downloading</h1>
 
 <p>
-Current development release: <b>7.1</b>
-<br>
-Last stable release: <b>7.0.4</b>
+Primary Mesa download site:
+<a href="ftp://ftp.freedesktop.org/pub/mesa/">ftp.freedesktop.org</a> (FTP)
+or <a href="https://mesa.freedesktop.org/archive/">mesa.freedesktop.org</a>
+(HTTP).
 </p>
 
 <p>
-Primary download site:
-<a href="http://sourceforge.net/project/showfiles.php?group_id=3"
-target="_parent">SourceForge</a>
+Starting with the first release of 2017, Mesa's version scheme is
+year-based. Filenames are in the form <tt>mesa-Y.N.P.tar.gz</tt>, where
+<tt>Y</tt> is the year (two digits), <tt>N</tt> is an incremental number
+(starting at 0) and <tt>P</tt> is the patch number (0 for the first
+release, 1 for the first patch after that).
 </p>
 
 <p>
-When a new release is coming, release candidates (betas) can be found
-<a href="http://www.mesa3d.org/beta/">here</a>.
-</p>
-
-
-<p>
-Mesa is distributed in several parts:
+When a new release is coming, release candidates (betas) may be found
+in the same directory, and are recognisable by the
+<tt>mesa-Y.N.P-<b>rc</b>X.tar.gz</tt> filename.
 </p>
-<ul>
-<li><b>MesaLib-x.y.z</b> - the main Mesa library source code, drivers
-    and documentation.
-</li>
-<li><b>MesaDemos-x.y.z</b> - OpenGL demonstration and test programs.
-    Most of the programs require GLUT (either the
-    <a href="http://www.opengl.org/resources/libraries/glut"
-    target="_parent">original GLUT by Mark Kilgard</a> or
-    <a href="http://freeglut.sourceforge.net" target="_parent">freeglut</a> or
-    <a href="http://openglut.sourceforge.net" target="_parent">OpenGLUT</a>).
-</li>
-<li><b>MesaGLUT-x.y.z</b> - Mark Kilgard's GLUT, easily compiled and used
-    with Mesa.  Plus, other implementation of GLUT for DOS, OS/2, BeOS, etc.
-</li>
-</ul>
 
-<p>
-If you're not interested in running the demos, you'll only need the first
-package.
-</p>
 
-<p>
-If you're new to this and not sure what you're doing, grab all three packages.
-</p>
+<h1>Unpacking</h1>
 
 <p>
-The packages are available in .tar.gz, .tar.bz2 and .zip formats.
-Other sites might offer additional package formats.
+Mesa releases are available in two formats: <tt>.tar.xz</tt> and <tt>.tar.gz</tt>.
 </p>
 
-<H1>Unpacking</H1>
-
 <p>
-All the packages should be in the same directory prior to unpacking.
-</p>
-
-<ul>
-<li>To unpack .tar.gz files:
-<pre>
-       tar zxf MesaLib-X.Y.tar.gz
-       tar zxf MesaDemos-X.Y.tar.gz
-       tar zxf MesaGLUT-X.Y.tar.gz
-</pre>
-or
+To unpack the tarball:
 <pre>
-       gzcat MesaLib-X.Y.tar.gz | tar xf -
-       gzcat MesaDemos-X.Y.tar.gz | tar xf -
-       gzcat MesaGLUT-X.Y.tar.gz | tar xf -
+       tar xf mesa-Y.N.P.tar.xz
 </pre>
 or
 <pre>
-       gunzip MesaLib-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
-       gunzip MesaDemos-X.Y.tar.gz ; tar xf MesaDemos-X.Y.tar
-       gunzip MesaGLUT-X.Y.tar.gz ; tar xf MesaGLUT-X.Y.tar
+       tar xf mesa-Y.N.P.tar.gz
 </pre>
-<li>To unpack .tar.bz2 files:
-<pre>
-       bunzip2 -c MesaLib-X.Y.tar.gz | tar xf -
-       bunzip2 -c MesaDemos-X.Y.tar.gz | tar xf -
-       bunzip2 -c MesaGLUT-X.Y.tar.gz | tar xf -
-</pre>
-<li>To unpack .zip files:
-<pre>
-       unzip MesaLib-X.Y.zip
-       unzip MesaDemos-X.Y.zip
-       unzip MesaGLUT-X.Y.zip
-</pre>
-</ul>
+</p>
 
 
 <h1>Contents</h1>
@@ -105,32 +62,17 @@ or
 After unpacking you'll have these files and directories (among others):
 </p>
 <pre>
-Makefile       - top-level Makefile for most systems
-configs/       - makefile parameter files for various systems
+autogen.sh     - Autoconf script for *nix systems
+scons/         - SCons script for Windows builds
 include/       - GL header (include) files
 bin/           - shell scripts for making shared libraries, etc
 docs/          - documentation
 src/           - source code for libraries
 src/mesa       - sources for the main Mesa library and device drivers
-src/glu                - libGLU source code
+src/gallium     - sources for Gallium and Gallium drivers
 src/glx                - sources for building libGL with full GLX and DRI support
-src/glw                - Xt/Motif/OpenGL widget code
 </pre>
 
-If you downloaded and unpacked the MesaDemos.X.Y package:
-
-<pre>
-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>
-
-If you downloaded and unpacked the MesaGLUT.X.Y package:
-<pre>
-src/glut       - GLUT library source code
-</pre>
 
 <p>
 Proceed to the <a href="install.html">compilation and installation
@@ -138,5 +80,33 @@ instructions</a>.
 </p>
 
 
-</BODY>
-</HTML>
+<h1>Demos, GLUT, and GLU</h1>
+
+<p>
+A package of SGI's GLU library is available
+<a href="ftp://ftp.freedesktop.org/pub/mesa/glu/">here</a>
+</p>
+
+<p>
+A package of Mark Kilgard's GLUT library is available
+<a href="ftp://ftp.freedesktop.org/pub/mesa/glut/">here</a>
+</p>
+
+<p>
+The Mesa demos collection is available
+<a href="ftp://ftp.freedesktop.org/pub/mesa/demos/">here</a>
+</p>
+
+<p>
+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>
+
+</div>
+</body>
+</html>