docs: reorder heading and notice
[mesa.git] / docs / download.html
index 7db23de37c9b83bf84251820a6717e1438a353d6..3807f836d142e51f272d952e54e11e4d76ba82ba 100644 (file)
 
 <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 <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) 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
+<tt>mesa-Y.N.P-<b>rc</b>X.tar.gz</tt> filename.
 </p>
 
 
 <h1>Unpacking</h1>
 
 <p>
-Mesa releases are available in three formats: .tar.bz2, .tar.gz, and .zip
+Mesa releases are available in two formats: <tt>.tar.xz</tt> and <tt>.tar.gz</tt>.
 </p>
 
 <p>
-To unpack .tar.gz files:
+To unpack the tarball:
 </p>
 <pre>
-       tar zxf MesaLib-x.y.z.tar.gz
-</pre>
-or
-<pre>
-       gzcat MesaLib-x.y.z.tar.gz | tar xf -
+       tar xf mesa-Y.N.P.tar.xz
 </pre>
-or
+<p>or</p>
 <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>
-       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>
-
-
 <p>
 Proceed to the <a href="install.html">compilation and installation
 instructions</a>.
@@ -90,17 +68,17 @@ instructions</a>.
 
 <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>
@@ -108,9 +86,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>