03fa60b4dc5ec3e43f12353cab55be5fbbc8edb6
[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 There's also the MesaGLUT-x.y.z.{tar.bz2, tar.gz, zip} packages which
29 contain Mark Kilgard's GLUT library.
30 This is optional.
31 Most Linux distributions include an implementation of GLUT (such as freeglut).
32 </p>
33 <p>
34 In the past, the Mesa demos collection was distributed as
35 MesaDemos-x.y.z.{tar.bz2, tar.gz, zip}.
36 Now, the
37 <a href="ftp://ftp.freedesktop.org/pub/mesa/demos/" target="_parent">
38 Mesa demos</a> are distributed separately.
39 </p>
40
41
42 <H1>Unpacking</H1>
43
44 <p>
45 To unpack .tar.gz files:
46 </p>
47 <pre>
48 tar zxf MesaLib-x.y.z.tar.gz
49 </pre>
50 or
51 <pre>
52 gzcat MesaLib-x.y.z.tar.gz | tar xf -
53 </pre>
54 or
55 <pre>
56 gunzip MesaLib-x.y.z.tar.gz ; tar xf MesaLib-x.y.z.tar
57 </pre>
58 <p>
59 To unpack .tar.bz2 files:
60 </p>
61 <pre>
62 bunzip2 -c MesaLib-x.y.z.tar.gz | tar xf -
63 </pre>
64 <p>
65 To unpack .zip files:
66 </p>
67 <pre>
68 unzip MesaLib-x.y.z.zip
69 </pre>
70
71
72 <h1>Contents</h1>
73
74 <p>
75 After unpacking you'll have these files and directories (among others):
76 </p>
77 <pre>
78 Makefile - top-level Makefile for most systems
79 configs/ - makefile parameter files for various systems
80 include/ - GL header (include) files
81 bin/ - shell scripts for making shared libraries, etc
82 docs/ - documentation
83 src/ - source code for libraries
84 src/mesa - sources for the main Mesa library and device drivers
85 src/gallium - sources for Gallium and Gallium drivers
86 src/glu - libGLU source code
87 src/glx - sources for building libGL with full GLX and DRI support
88 src/glw - Xt/Motif/OpenGL widget code
89 </pre>
90
91 If you downloaded and unpacked the MesaGLUT.x.y.z package:
92 <pre>
93 src/glut - GLUT library source code
94 </pre>
95
96 <p>
97 Proceed to the <a href="install.html">compilation and installation
98 instructions</a>.
99 </p>
100
101
102 </BODY>
103 </HTML>