docs: Tell people how to easily generate the Fixes lines.
[mesa.git] / docs / download.html
index a1a1baa28ff8302356b061660b22b0bbd9278d40..8fe7c295b42c74014279a1c12cb9b92ea9e70c38 100644 (file)
@@ -2,76 +2,63 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Getting Mesa</title>
+  <title>Downloading and Unpacking</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
-<h1>Downloading</h1>
+<div class="header">
+  The Mesa 3D Graphics Library
+</div>
+
+<iframe src="contents.html"></iframe>
+<div class="content">
+
+<h1>Downloading and Unpacking</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>
+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>
 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>.
+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>
-Mesa releases are available in three formats: .tar.bz2, .tar.gz, and .zip
+Mesa releases are available in two formats: <code>.tar.xz</code> and <code>.tar.gz</code>.
 </p>
 
 <p>
-To unpack .tar.gz files:
+To unpack the tarball:
 </p>
 <pre>
-       tar zxf MesaLib-x.y.z.tar.gz
+       tar xf mesa-Y.N.P.tar.xz
 </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>
+<p>or</p>
 <pre>
-       bunzip2 -c MesaLib-x.y.z.tar.gz | tar xf -
-</pre>
-<p>
-To unpack .zip files:
-</p>
-<pre>
-       unzip MesaLib-x.y.z.zip
+       tar xf mesa-Y.N.P.tar.gz
 </pre>
 
 
-<h1>Contents</h1>
-
-<p>
-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
-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/glx                - sources for building libGL with full GLX and DRI support
-</pre>
-
+<h2>Contents</h2>
 
 <p>
 Proceed to the <a href="install.html">compilation and installation
@@ -79,21 +66,21 @@ instructions</a>.
 </p>
 
 
-<h1>Demos, GLUT, and GLU</h1>
+<h2>Demos, GLUT, and GLU</h2>
 
 <p>
 A package of SGI's GLU library is available
-<a href="ftp://ftp.freedesktop.org/pub/mesa/glu/" target="_parent">here</a>
+<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/" target="_parent">here</a>
+<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/" target="_parent">here</a>
+<a href="ftp://ftp.freedesktop.org/pub/mesa/demos/">here</a>
 </p>
 
 <p>
@@ -101,11 +88,11 @@ 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>,
+<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>
 
-
+</div>
 </body>
 </html>