third_party_mesa3d/docs/download.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>

<div class="header">
  <h1>The Mesa 3D Graphics Library</h1>
</div>

<iframe src="contents.html"></iframe>
<div class="content">

<h1>Downloading</h1>

<p>
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>
(HTTP).
</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
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>
	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 files and directories (among others):
</p>
<pre>
autogen.sh	- Autoconf script for *nix systems
scons/		- SCons script for Windows builds
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>.
</p>


<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>
A package of Mark Kilgard's GLUT library is available
<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/">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>

</div>
</body>
</html>
docs: consolidate html header and footer add doctype add character encoding add missing <head> tag unify html header and footer Signed-off-by: Brian Paul <brianp@vmware.com> 2012-06-12 09:05:03 +02:00			`<!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>`
Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. 2003-03-08 17:38:57 +00:00
docs: add new iframe layout 2012-09-18 18:57:02 +02:00			`<div class="header">`
			`<h1>The Mesa 3D Graphics Library</h1>`
			`</div>`

			`<iframe src="contents.html"></iframe>`
			`<div class="content">`

docs: consolidate html header and footer add doctype add character encoding add missing <head> tag unify html header and footer Signed-off-by: Brian Paul <brianp@vmware.com> 2012-06-12 09:05:03 +02:00			`<h1>Downloading</h1>`
Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. 2003-03-08 17:38:57 +00:00
			`<p>`
docs: point to fd.o for downloads instead of SourceForge 2009-09-03 15:44:49 -06:00			`Primary Mesa download site:`
docs: add HTTP link for Mesa downloads Bugzilla: https://bugs.freedesktop.org/show_bug.cgi?id=92628 Reviewed-by: Jose Fonseca <jfonseca@vmware.com> Reviewed-by: Ian Romanick <ian.d.romanick@intel.com> 2016-03-29 12:54:10 -06:00			`<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>`
			`(HTTP).`
Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. 2003-03-08 17:38:57 +00:00			`</p>`

docs: add a note about the new version scheme Signed-off-by: Eric Engestrom <eric.engestrom@imgtec.com> Reviewed-by: Brian Paul <brianp@vmware.com> 2017-02-08 04:27:00 -07:00			`<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>`

added pointer to beta/release candidates 2008-06-21 10:14:22 -06:00			`<p>`
docs: point to fd.o for downloads instead of SourceForge 2009-09-03 15:44:49 -06:00			`When a new release is coming, release candidates (betas) may be found`
docs: remove dead 'beta' link Release candidates haven't been in a 'beta' subdir in a long time, so let's replace the dead link with an explanation instead. Signed-off-by: Eric Engestrom <eric.engestrom@imgtec.com> Reviewed-by: Brian Paul <brianp@vmware.com> 2017-02-08 04:27:00 -07:00			`in the same directory, and are recognisable by the`
			`<tt>mesa-Y.N.P-<b>rc</b>X.tar.gz</tt> filename.`
added pointer to beta/release candidates 2008-06-21 10:14:22 -06:00			`</p>`

bunch of updates 2005-09-10 16:57:22 +00:00
docs: prefer lowercase html tags Signed-off-by: Brian Paul <brianp@vmware.com> 2012-06-12 09:05:36 +02:00			`<h1>Unpacking</h1>`
docs: freshen up the download/unpack instructions 2012-04-19 08:56:02 -06:00
bunch of updates 2005-09-10 16:57:22 +00:00			`<p>`
docs: fix unpacking instructions File names were wrong, file formats were wrong, bunzip command was wrong... I also removed all but the simplest example; people who use pipes already know how to untar, so let's simplify and remove potential confusion for non-tech-savvy users. Signed-off-by: Eric Engestrom <eric.engestrom@imgtec.com> Reviewed-by: Brian Paul <brianp@vmware.com> 2017-02-08 04:27:00 -07:00			`Mesa releases are available in two formats: <tt>.tar.xz</tt> and <tt>.tar.gz</tt>.`
download/install updates 2006-07-12 20:14:43 +00:00			`</p>`

bunch of updates 2005-09-10 16:57:22 +00:00			`<p>`
docs: fix unpacking instructions File names were wrong, file formats were wrong, bunzip command was wrong... I also removed all but the simplest example; people who use pipes already know how to untar, so let's simplify and remove potential confusion for non-tech-savvy users. Signed-off-by: Eric Engestrom <eric.engestrom@imgtec.com> Reviewed-by: Brian Paul <brianp@vmware.com> 2017-02-08 04:27:00 -07:00			`To unpack the tarball:`
bunch of updates 2005-09-10 16:57:22 +00:00			`<pre>`
docs: fix unpacking instructions File names were wrong, file formats were wrong, bunzip command was wrong... I also removed all but the simplest example; people who use pipes already know how to untar, so let's simplify and remove potential confusion for non-tech-savvy users. Signed-off-by: Eric Engestrom <eric.engestrom@imgtec.com> Reviewed-by: Brian Paul <brianp@vmware.com> 2017-02-08 04:27:00 -07:00			`tar xf mesa-Y.N.P.tar.xz`
bunch of updates 2005-09-10 16:57:22 +00:00			`</pre>`
			`or`
Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. 2003-03-08 17:38:57 +00:00			`<pre>`
docs: fix unpacking instructions File names were wrong, file formats were wrong, bunzip command was wrong... I also removed all but the simplest example; people who use pipes already know how to untar, so let's simplify and remove potential confusion for non-tech-savvy users. Signed-off-by: Eric Engestrom <eric.engestrom@imgtec.com> Reviewed-by: Brian Paul <brianp@vmware.com> 2017-02-08 04:27:00 -07:00			`tar xf mesa-Y.N.P.tar.gz`
Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. 2003-03-08 17:38:57 +00:00			`</pre>`
docs: update info about Mesa packaging/contents 2011-04-04 11:16:51 -06:00			`</p>`
bunch of updates 2005-09-10 16:57:22 +00:00

			`<h1>Contents</h1>`
Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. 2003-03-08 17:38:57 +00:00
			`<p>`
download/install updates 2006-07-12 20:14:43 +00:00			`After unpacking you'll have these files and directories (among others):`
Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. 2003-03-08 17:38:57 +00:00			`</p>`
			`<pre>`
docs: update package contents Signed-off-by: Eric Engestrom <eric.engestrom@imgtec.com> Reviewed-by: Brian Paul <brianp@vmware.com> 2017-02-08 04:27:00 -07:00			`autogen.sh - Autoconf script for *nix systems`
			`scons/ - SCons script for Windows builds`
Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. 2003-03-08 17:38:57 +00:00			`include/ - GL header (include) files`
assorted updates 2003-09-03 23:04:31 +00:00			`bin/ - shell scripts for making shared libraries, etc`
Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. 2003-03-08 17:38:57 +00:00			`docs/ - documentation`
assorted updates 2003-09-03 23:04:31 +00:00			`src/ - source code for libraries`
			`src/mesa - sources for the main Mesa library and device drivers`
docs: update info about Mesa packaging/contents 2011-04-04 11:16:51 -06:00			`src/gallium - sources for Gallium and Gallium drivers`
download/install updates 2006-07-12 20:14:43 +00:00			`src/glx - sources for building libGL with full GLX and DRI support`
bunch of updates 2005-09-10 16:57:22 +00:00			`</pre>`
assorted updates 2003-09-03 23:04:31 +00:00
Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. 2003-03-08 17:38:57 +00:00
			`<p>`
bunch of updates 2005-09-10 16:57:22 +00:00			`Proceed to the <a href="install.html">compilation and installation`
Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. 2003-03-08 17:38:57 +00:00			`instructions</a>.`
			`</p>`


Remove libGLU It's been moved to its own repository, found at http://cgit.freedesktop.org/mesa/glu/ Acked-by: Kenneth Graunke <kenneth@whitecape.org> 2012-08-23 16:39:20 -07:00			`<h1>Demos, GLUT, and GLU</h1>`

			`<p>`
			`A package of SGI's GLU library is available`
docs: remove obsolete target attribute 2012-09-18 19:31:28 +02:00			`<a href="ftp://ftp.freedesktop.org/pub/mesa/glu/">here</a>`
Remove libGLU It's been moved to its own repository, found at http://cgit.freedesktop.org/mesa/glu/ Acked-by: Kenneth Graunke <kenneth@whitecape.org> 2012-08-23 16:39:20 -07:00			`</p>`
docs: freshen up the download/unpack instructions 2012-04-19 08:56:02 -06:00
			`<p>`
			`A package of Mark Kilgard's GLUT library is available`
docs: remove obsolete target attribute 2012-09-18 19:31:28 +02:00			`<a href="ftp://ftp.freedesktop.org/pub/mesa/glut/">here</a>`
docs: freshen up the download/unpack instructions 2012-04-19 08:56:02 -06:00			`</p>`

			`<p>`
			`The Mesa demos collection is available`
docs: remove obsolete target attribute 2012-09-18 19:31:28 +02:00			`<a href="ftp://ftp.freedesktop.org/pub/mesa/demos/">here</a>`
docs: freshen up the download/unpack instructions 2012-04-19 08:56:02 -06:00			`</p>`

			`<p>`
Remove libGLU It's been moved to its own repository, found at http://cgit.freedesktop.org/mesa/glu/ Acked-by: Kenneth Graunke <kenneth@whitecape.org> 2012-08-23 16:39:20 -07:00			`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:`

docs: https all the links \o/ Most of them already redirected to https anyway, so we might as well avoid the redirection and the security implications by linking directly to the right protocol. Signed-off-by: Eric Engestrom <eric@engestrom.ch> Reviewed-by: Brian Paul <brianp@vmware.com> 2017-02-09 02:10:17 +00:00			`<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>,`
docs: freshen up the download/unpack instructions 2012-04-19 08:56:02 -06:00			`</p>`

docs: add new iframe layout 2012-09-18 18:57:02 +02:00			`</div>`
docs: consolidate html header and footer add doctype add character encoding add missing <head> tag unify html header and footer Signed-off-by: Brian Paul <brianp@vmware.com> 2012-06-12 09:05:03 +02:00			`</body>`
			`</html>`