Squashed commit of the following:
[mesa.git] / docs / download.html
1 <HTML>
2
3 <TITLE>Getting Mesa</TITLE>
4
5 <link rel="stylesheet" type="text/css" href="mesa.css"></head>
6
7 <BODY>
8
9 <H1>Downloading</H1>
10
11 <p>
12 Primary Mesa download site:
13 <a href="ftp://ftp.freedesktop.org/pub/mesa/"
14 target="_parent">freedesktop.org</a> (FTP)
15 </p>
16
17 <p>
18 When a new release is coming, release candidates (betas) may be found
19 <a href="ftp://ftp.freedesktop.org/pub/mesa/beta/" target="_parent">here</a>.
20 </p>
21
22
23 <p>
24 The Mesa package is named MesaLib-x.y.z.{tar.bz2, tar.gz, zip} where x.y.z
25 is the version. There are three types of compressed archives.
26 </p>
27 <p>
28 In the past, there was also MesaGLUT-x.y.z.{tar.bz2, tar.gz, zip} packages which
29 contained Mark Kilgard's GLUT library.
30 Most Linux distributions include an implementation of GLUT (such as freeglut).
31 </p>
32 <p>
33 In the past, the Mesa demos collection was distributed as
34 MesaDemos-x.y.z.{tar.bz2, tar.gz, zip}.
35 Now, the
36 <a href="ftp://ftp.freedesktop.org/pub/mesa/demos/" target="_parent">
37 Mesa demos</a> are distributed separately.
38 </p>
39
40
41 <H1>Unpacking</H1>
42
43 <p>
44 To unpack .tar.gz files:
45 </p>
46 <pre>
47 tar zxf MesaLib-x.y.z.tar.gz
48 </pre>
49 or
50 <pre>
51 gzcat MesaLib-x.y.z.tar.gz | tar xf -
52 </pre>
53 or
54 <pre>
55 gunzip MesaLib-x.y.z.tar.gz ; tar xf MesaLib-x.y.z.tar
56 </pre>
57 <p>
58 To unpack .tar.bz2 files:
59 </p>
60 <pre>
61 bunzip2 -c MesaLib-x.y.z.tar.gz | tar xf -
62 </pre>
63 <p>
64 To unpack .zip files:
65 </p>
66 <pre>
67 unzip MesaLib-x.y.z.zip
68 </pre>
69
70
71 <h1>Contents</h1>
72
73 <p>
74 After unpacking you'll have these files and directories (among others):
75 </p>
76 <pre>
77 Makefile - top-level Makefile for most systems
78 configs/ - makefile parameter files for various systems
79 include/ - GL header (include) files
80 bin/ - shell scripts for making shared libraries, etc
81 docs/ - documentation
82 src/ - source code for libraries
83 src/mesa - sources for the main Mesa library and device drivers
84 src/gallium - sources for Gallium and Gallium drivers
85 src/glu - libGLU source code
86 src/glx - sources for building libGL with full GLX and DRI support
87 src/glw - Xt/Motif/OpenGL widget code
88 </pre>
89
90 If you downloaded and unpacked the MesaGLUT.x.y.z package:
91 <pre>
92 src/glut - GLUT library source code
93 </pre>
94
95 <p>
96 Proceed to the <a href="install.html">compilation and installation
97 instructions</a>.
98 </p>
99
100
101 </BODY>
102 </HTML>