-<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>
-<BODY text="#000000" bgcolor="#55bbff" link="#111188">
+<iframe src="contents.html"></iframe>
+<div class="content">
-<H1>Downloading / Unpacking</H1>
+<h1>Downloading</h1>
<p>
-Mesa can be downloaded from the
-<a href="http://www.sourceforge.net/projects/mesa3d" target="_parent">
-SourceForge download area</A>.
+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>
+(HTTPS).
</p>
<p>
-Since version 2.3, Mesa is distributed in two pieces: main library code
-and demos. If you're upgrading from a previous version of Mesa or you're not
-interested in the demos you can just download the core Mesa archive file.
+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>
-Mesa is available in at least three archive formats:
+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>
+
+<h1>Unpacking</h1>
+
+<p>
+Mesa releases are available in two formats: <tt>.tar.xz</tt> and <tt>.tar.gz</tt>.
+</p>
+
+<p>
+To unpack the tarball:
<pre>
-1. GNU zip/tar
-
- Download MesaLib-X.Y.tar.gz and optionally MesaDemos-X.Y.tar.gz
- Unpack with:
- gzcat MesaLib-X.Y.tar.gz | tar xf -
- gzcat MesaDemos-X.Y.tar.gz | tar xf -
- or
- gunzip MesaLib-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
- gunzip MesaDemos-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
- or
- tar zxf MesaLib-X.Y.tar.gz
- tar zxf MesaDemos-X.Y.tar.gz
-
- If you don't have gzcat try zcat instead.
-
-2. Unix compressed/tar
-
- Download MesaLib-X.Y.tar.Z and optionally MesaDemos-X.Y.tar.Z
- Unpack with:
- zcat MesaLib-X.Y.tar.Z | tar xf -
- zcat MesaDemos-X.Y.tar.Z | tar xf -
-
-3. ZIP format
-
- Download MesaLib-X.Y.zip and optionally MesaDemos-X.Y.zip
- Unpack with:
- unzip MesaLib-X.Y.zip
- unzip MesaDemos-X.Y.zip
+ tar xf mesa-Y.N.P.tar.xz
</pre>
+or
+<pre>
+ tar xf mesa-Y.N.P.tar.gz
+</pre>
+</p>
+
+
+<h1>Contents</h1>
<p>
-After unpacking you'll have these directories (and more):
+After unpacking you'll have these files and directories (among others):
</p>
<pre>
-Makefile.X11 - "old" top-level Makefile for X11-based systems
-Make-config - system configurations used by the Makefile.X11
-configure - the GNU autoconf script
-bin/ - shell scripts for making shared libraries, etc
+autogen.sh - Autoconf script for *nix systems
+scons/ - SCons script for Windows builds
include/ - GL header (include) files
-lib/ - client libraries, created during installation
-src/ - source code for the main libGL library
-si-glu/ - SGI Sample Implementation of libGLU
-src-glu/ - old source code for libGLU (obsolete)
+bin/ - shell scripts for making shared libraries, etc
docs/ - documentation
-util/ - handly utility functions
-widgets-mesa/ - Mesa widgets for Xt/Motif (obsolete)
-widgets-sgi/ - SGI OpenGL widgets for Xt/Motif
-
-and if you downloaded and unpacked the demos:
-
-src-glut/ - source code for GLUT toolkit
-demos/ - GLUT demos
-xdemos/ - X11 and SVGA demo programs
-samples/ - sample OpenGL programs from SGI
-book/ - example programs from the OpenGL Programming Guide,
- converted to GLUT by Mark Kilgard, from GLUT distribution.
-images/ - image files
-
+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 <a href="install.html">compilation and installation
+Proceed to
the <a href="install.html">compilation and installation
instructions</a>.
</p>
-<H1>GLUT</H1>
+
+<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>
-Mesa 2.5 and later includes Mark Kilgard's GLUT library (GL Utility Toolkit).
-GLUT is built automatically on systems which support it.
+A package of Mark Kilgard's GLUT library is available
+<a href="ftp://ftp.freedesktop.org/pub/mesa/glut/">here</a>
</p>
+
<p>
-The GLUT tests, demos, examples, etc are not included, just the main library.
-To obtain the latest complete release of GLUT please visit the
-<a href="http://www.opengl.org/developers/documentation/glut/index.html"
-target ="_parent">GLUT homepage</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://cgit.freedesktop.org/mesa/glut/">GLUT</a>,
+<a href="https://cgit.freedesktop.org/mesa/glu/">GLU</a> and
+<a href="https://cgit.freedesktop.org/mesa/demos/">Demos</a>,
+</p>
-</BODY>
-</HTML>
+</div>
+</body>
+</html>
projects / mesa.git / blobdiff