docs: add release notes for 19.1.7
[mesa.git] / docs / download.html
index 856c2a53ca23889e17df3666db808e374a468f1a..8fe7c295b42c74014279a1c12cb9b92ea9e70c38 100644 (file)
@@ -2,82 +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>
 
 <div class="header">
-  <h1>The Mesa 3D Graphics Library</h1>
+  The Mesa 3D Graphics Library
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>Downloading</h1>
+<h1>Downloading and Unpacking</h1>
+
+<h2>Downloading</h2>
 
 <p>
 Primary Mesa download site:
-<a href="ftp://ftp.freedesktop.org/pub/mesa/">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/">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:
-</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>
-
-<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
@@ -85,7 +66,7 @@ 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
@@ -107,9 +88,9 @@ 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>