added -lstc++ info, convert more plain text to html
[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 - "old" top-level Makefile for X11-based systems
61 Make-config - system configurations used by the Makefile.X11
62 configure - the GNU autoconf script
63 bin/ - shell scripts for making shared libraries, etc
64 include/ - GL header (include) files
65 lib/ - client libraries, created during installation
66 src/ - source code for the main libGL library
67 si-glu/ - SGI Sample Implementation of libGLU
68 src-glu/ - old source code for libGLU (obsolete)
69 docs/ - documentation
70 util/ - handly utility functions
71 widgets-mesa/ - Mesa widgets for Xt/Motif (obsolete)
72 widgets-sgi/ - SGI OpenGL widgets for Xt/Motif
73
74 and if you downloaded and unpacked the MesaDemos.X.Y archive:
75
76 src-glut/ - source code for GLUT toolkit
77 demos/ - GLUT demos
78 xdemos/ - X11 and SVGA demo programs
79 samples/ - sample OpenGL programs from SGI
80 book/ - example programs from the OpenGL Programming Guide,
81 converted to GLUT by Mark Kilgard, from GLUT distribution.
82 images/ - image files
83
84 </pre>
85
86 <p>
87 Proceed to <a href="install.html">compilation and installation
88 instructions</a>.
89 </p>
90
91 <H1>GLUT</H1>
92
93 <p>
94 Mesa 2.5 and later includes Mark Kilgard's GLUT library (GL Utility Toolkit).
95 GLUT is built automatically on systems which support it.
96 </p>
97 <p>
98 The GLUT tests, demos, examples, etc are not included, just the main library.
99 To obtain the latest complete release of GLUT please visit the
100 <a href="http://www.opengl.org/developers/documentation/glut/index.html"
101 target ="_parent">GLUT homepage</a>
102 </p>
103
104
105 </BODY>
106 </HTML>