assorted updates
[mesa.git] / docs / download.html
1 <HTML>
2
3 <TITLE>Getting Mesa</TITLE>
4
5 <BODY text="#000000" bgcolor="#55bbff" link="#111188">
6
7 <H1>Downloading / Unpacking</H1>
8
9 <p>
10 Mesa can be downloaded from the
11 <a href="http://www.sourceforge.net/projects/mesa3d" target="_parent">
12 SourceForge download area</A>.
13 </p>
14
15 <p>
16 Since version 2.3, Mesa is distributed in two pieces: main library code
17 and demos. If you're upgrading from a previous version of Mesa or you're not
18 interested in the demos you can just download the core Mesa archive file.
19 </p>
20
21 <p>
22 Mesa is available in at least three archive formats:
23 </p>
24
25 <pre>
26 1. GNU zip/tar
27
28 Download MesaLib-X.Y.tar.gz and optionally MesaDemos-X.Y.tar.gz
29 Unpack with:
30 gzcat MesaLib-X.Y.tar.gz | tar xf -
31 gzcat MesaDemos-X.Y.tar.gz | tar xf -
32 or
33 gunzip MesaLib-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
34 gunzip MesaDemos-X.Y.tar.gz ; tar xf MesaLib-X.Y.tar
35 or
36 tar zxf MesaLib-X.Y.tar.gz
37 tar zxf MesaDemos-X.Y.tar.gz
38
39 If you don't have gzcat try zcat instead.
40
41 2. Unix compressed/tar
42
43 Download MesaLib-X.Y.tar.Z and optionally MesaDemos-X.Y.tar.Z
44 Unpack with:
45 zcat MesaLib-X.Y.tar.Z | tar xf -
46 zcat MesaDemos-X.Y.tar.Z | tar xf -
47
48 3. ZIP format
49
50 Download MesaLib-X.Y.zip and optionally MesaDemos-X.Y.zip
51 Unpack with:
52 unzip MesaLib-X.Y.zip
53 unzip MesaDemos-X.Y.zip
54 </pre>
55
56 <p>
57 After unpacking you'll have these directories (and more):
58 </p>
59 <pre>
60 Makefile.X11 - top-level Makefile for X11-based systems
61 Make-config - system configurations used by the Makefile.X11
62 include/ - GL header (include) files
63 bin/ - shell scripts for making shared libraries, etc
64 lib/ - final client libraries, created during compilation
65 docs/ - documentation
66 src/ - source code for libraries
67 src/mesa - sources for the main Mesa library and device drivers
68 src/glu - libGLU source code
69 src/glw - Xt/Motif/OpenGL widget code
70
71
72 and if you downloaded and unpacked the MesaDemos.X.Y archive:
73
74 src/glut - GLUT source code
75 progs/ - OpenGL programs
76 progs/demos - original Mesa demos
77 progs/xdemos - GLX OpenGL/Mesa demos
78 progs/redbook - examples from the OpenGL Programming Guide
79 progs/samples - examples from SGI
80 progs/images/ - image files
81
82 </pre>
83
84 <p>
85 Proceed to <a href="install.html">compilation and installation
86 instructions</a>.
87 </p>
88
89 <H1>GLUT</H1>
90
91 <p>
92 Mesa 2.5 and later includes Mark Kilgard's GLUT library (GL Utility Toolkit).
93 GLUT is built automatically on systems which support it.
94 </p>
95 <p>
96 The GLUT tests, demos, examples, etc are not included, just the main library.
97 To obtain the latest complete release of GLUT please visit the
98 <a href="http://www.opengl.org/developers/documentation/glut/index.html"
99 target ="_parent">GLUT homepage</a>
100 </p>
101
102
103 </BODY>
104 </HTML>