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>Downloading and Unpacking</title>
  <link rel="stylesheet" type="text/css" href="mesa.css">
</head>
<body>

<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/">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
in the same directory, and are recognisable by the
<code>mesa-Y.N.P-<b>rc</b>X.tar.gz</code> filename.
</p>


<h2>Unpacking</h2>

<p>
Mesa releases are available in two formats: <code>.tar.xz</code> and <code>.tar.gz</code>.
</p>

<p>
To unpack the tarball:
</p>
<pre>
	tar xf mesa-Y.N.P.tar.xz
</pre>
<p>or</p>
<pre>
	tar xf mesa-Y.N.P.tar.gz
</pre>


<h2>Contents</h2>

<p>
Proceed to the <a href="install.html">compilation and installation
instructions</a>.
</p>


<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/">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://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>
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">`
docs: give download-article a primary heading It's generally frowned upon to have multiple H1 headings in HTML4. So let's add a primary heading for the article, and source that from the title used in the sidebar. While we're at it, let's update the title in the article to match the title from the sidebar as well. Signed-off-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@intel.com> 2019-05-06 12:50:34 +02:00			`<title>Downloading and Unpacking</title>`
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			`<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">`
docs: drop h1 in header It's generally frowned upon to have more than one H1 per document in HTML4. So let's put the text directly inside the header. This means we can drop the flex-based centering, which makes things a bit easier. We also need to change the padding to rem instead of em, because the em has now changed. Signed-off-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@intel.com> 2019-05-06 13:26:47 +02:00			`The Mesa 3D Graphics Library`
docs: add new iframe layout 2012-09-18 18:57:02 +02:00			`</div>`

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

docs: give download-article a primary heading It's generally frowned upon to have multiple H1 headings in HTML4. So let's add a primary heading for the article, and source that from the title used in the sidebar. While we're at it, let's update the title in the article to match the title from the sidebar as well. Signed-off-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@intel.com> 2019-05-06 12:50:34 +02:00			`<h1>Downloading and Unpacking</h1>`

			`<h2>Downloading</h2>`
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>`
docs: update HTTP -> HTTPS reference to reflect reality The link recently got updated to https. Signed-off-by: Emil Velikov <emil.velikov@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@imgtec.com> 2017-06-30 12:09:32 +01:00			`(HTTPS).`
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`
docs: use code instead of tt-tag The tt-tag has been removed from HTML5, so let's normalize this to code-tags intead. This just makes things a bit more consistent, as we've mixed these left and right so far anyway. Signed-off-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Reviewed-by: Emil Velikov <emil.velikov@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@intel.com> 2019-05-28 13:34:34 +02:00			`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`
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			`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`
docs: use code instead of tt-tag The tt-tag has been removed from HTML5, so let's normalize this to code-tags intead. This just makes things a bit more consistent, as we've mixed these left and right so far anyway. Signed-off-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Reviewed-by: Emil Velikov <emil.velikov@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@intel.com> 2019-05-28 13:34:34 +02:00			`<code>mesa-Y.N.P-<b>rc</b>X.tar.gz</code> 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: give download-article a primary heading It's generally frowned upon to have multiple H1 headings in HTML4. So let's add a primary heading for the article, and source that from the title used in the sidebar. While we're at it, let's update the title in the article to match the title from the sidebar as well. Signed-off-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@intel.com> 2019-05-06 12:50:34 +02:00			`<h2>Unpacking</h2>`
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: use code instead of tt-tag The tt-tag has been removed from HTML5, so let's normalize this to code-tags intead. This just makes things a bit more consistent, as we've mixed these left and right so far anyway. Signed-off-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Reviewed-by: Emil Velikov <emil.velikov@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@intel.com> 2019-05-28 13:34:34 +02:00			`Mesa releases are available in two formats: <code>.tar.xz</code> and <code>.tar.gz</code>.`
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:`
docs: close paragraphs before preformatted text It's illegal to nest block-level elements such as <pre> inside <p> in HTML. This means that when the paragraphs gets closed after a <pre>-tag, we end up closing a non-existent tag, so the browser inserts a dummy <p>-tag. This is entirely pointless, so let's just close these tags before the <pre>-tag instead. Signed-off-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@intel.com> 2019-04-18 16:12:08 +02:00			`</p>`
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>`
docs: close paragraphs before preformatted text It's illegal to nest block-level elements such as <pre> inside <p> in HTML. This means that when the paragraphs gets closed after a <pre>-tag, we end up closing a non-existent tag, so the browser inserts a dummy <p>-tag. This is entirely pointless, so let's just close these tags before the <pre>-tag instead. Signed-off-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@intel.com> 2019-04-18 16:12:08 +02:00			`<p>or</p>`
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>`
bunch of updates 2005-09-10 16:57:22 +00:00

docs: give download-article a primary heading It's generally frowned upon to have multiple H1 headings in HTML4. So let's add a primary heading for the article, and source that from the title used in the sidebar. While we're at it, let's update the title in the article to match the title from the sidebar as well. Signed-off-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@intel.com> 2019-05-06 12:50:34 +02:00			`<h2>Contents</h2>`
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>`


docs: give download-article a primary heading It's generally frowned upon to have multiple H1 headings in HTML4. So let's add a primary heading for the article, and source that from the title used in the sidebar. While we're at it, let's update the title in the article to match the title from the sidebar as well. Signed-off-by: Erik Faye-Lund <erik.faye-lund@collabora.com> Reviewed-by: Eric Engestrom <eric.engestrom@intel.com> 2019-05-06 12:50:34 +02:00			`<h2>Demos, GLUT, and GLU</h2>`
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>`
			`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: update repo URLs after GitLab move I also updated the developer instructions; presumably someone who's been given commit rights already knows how to clone a repository :) A more useful thing is to show how to update the pushurl, and how to use access tokens to push over HTTPS (especially for us at Intel, where non-http traffic is a pain). Signed-off-by: Eric Engestrom <eric.engestrom@intel.com> Reviewed-by: Emil Velikov <emil.l.velikov@gmail.com> Reviewed-by: Dylan Baker <dylan@pnwbakers.com> 2018-09-21 14:39:53 +01:00			`<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>,`
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>`