docs: Tell people how to easily generate the Fixes lines.
[mesa.git] / docs / download.html
index 3c4d5976c2c92a4b76e945d9d4777ef65f572d20..8fe7c295b42c74014279a1c12cb9b92ea9e70c38 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>Downloading and Unpacking</title>
+  <link rel="stylesheet" type="text/css" href="mesa.css">
+</head>
+<body>
 
-<TITLE>Getting Mesa</TITLE>
+<div class="header">
+  The Mesa 3D Graphics Library
+</div>
 
-<link rel="stylesheet" type="text/css" href="mesa.css"></head>
+<iframe src="contents.html"></iframe>
+<div class="content">
 
-<BODY>
+<h1>Downloading and Unpacking</h1>
 
-<H1>Downloading</H1>
+<h2>Downloading</h2>
 
 <p>
 Primary Mesa download site:
-<a href="ftp://ftp.freedesktop.org/pub/mesa/"
-target="_parent">freedesktop.org</a> (FTP)
+<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>
+(HTTPS).
 </p>
 
 <p>
-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>.
+Starting with the first release of 2017, Mesa's version scheme is
+year-based. Filenames are in the form <code>mesa-Y.N.P.tar.gz</code>, where
+<code>Y</code> is the year (two digits), <code>N</code> is an incremental number
+(starting at 0) and <code>P</code> is the patch number (0 for the first
+release, 1 for the first patch after that).
 </p>
 
-
 <p>
-The Mesa package is named MesaLib-x.y.z.{tar.bz2, tar.gz, zip} where x.y.z
-is the version.  There are three types of compressed archives.
-</p>
-<p>
-In the past, there was also MesaGLUT-x.y.z.{tar.bz2, tar.gz, zip} packages which
-contained Mark Kilgard's GLUT library.
-Most Linux distributions include an implementation of GLUT (such as freeglut).
-</p>
-<p>
-In the past, the Mesa demos collection was distributed as
-MesaDemos-x.y.z.{tar.bz2, tar.gz, zip}.
-Now, the
-<a href="ftp://ftp.freedesktop.org/pub/mesa/demos/" target="_parent">
-Mesa demos</a> are distributed separately.
+When a new release is coming, release candidates (betas) may be found
+in the same directory, and are recognisable by the
+<code>mesa-Y.N.P-<b>rc</b>X.tar.gz</code> filename.
 </p>
 
 
-<H1>Unpacking</H1>
+<h2>Unpacking</h2>
 
 <p>
-To unpack .tar.gz files:
+Mesa releases are available in two formats: <code>.tar.xz</code> and <code>.tar.gz</code>.
 </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:
+To unpack the tarball:
 </p>
 <pre>
-       bunzip2 -c MesaLib-x.y.z.tar.gz | tar xf -
+       tar xf mesa-Y.N.P.tar.xz
 </pre>
-<p>
-To unpack .zip files:
-</p>
+<p>or</p>
 <pre>
-       unzip MesaLib-x.y.z.zip
+       tar xf mesa-Y.N.P.tar.gz
 </pre>
 
 
-<h1>Contents</h1>
+<h2>Contents</h2>
+
+<p>
+Proceed to the <a href="install.html">compilation and installation
+instructions</a>.
+</p>
+
+
+<h2>Demos, GLUT, and GLU</h2>
 
 <p>
-After unpacking you'll have these files and directories (among others):
+A package of SGI's GLU library is available
+<a href="ftp://ftp.freedesktop.org/pub/mesa/glu/">here</a>
 </p>
-<pre>
-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
-docs/          - documentation
-src/           - source code for libraries
-src/mesa       - sources for the main Mesa library and device drivers
-src/gallium     - sources for Gallium and Gallium drivers
-src/glu                - libGLU source code
-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 MesaGLUT.x.y.z package:
-<pre>
-src/glut       - GLUT library source code
-</pre>
+<p>
+A package of Mark Kilgard's GLUT library is available
+<a href="ftp://ftp.freedesktop.org/pub/mesa/glut/">here</a>
+</p>
 
 <p>
-Proceed to the <a href="install.html">compilation and installation
-instructions</a>.
+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="https://gitlab.freedesktop.org/mesa/glut">GLUT</a>,
+<a href="https://gitlab.freedesktop.org/mesa/glu">GLU</a> and
+<a href="https://gitlab.freedesktop.org/mesa/demos">Demos</a>,
+</p>
 
-</BODY>
-</HTML>
+</div>
+</body>
+</html>