From 7103a18c1242af7d3ec36a947841fa52e7f86bed Mon Sep 17 00:00:00 2001 From: Brian Paul Date: Thu, 19 Apr 2012 09:56:36 -0600 Subject: [PATCH] docs: overhaul the Mesa build/install instructions Rearrange thing in general. Mark the legacy Makefile system as deprecated. --- docs/install.html | 279 +++++++++++++++++++++++----------------------- 1 file changed, 137 insertions(+), 142 deletions(-) diff --git a/docs/install.html b/docs/install.html index 46d0b4c7b01..2ba7cb8677b 100644 --- a/docs/install.html +++ b/docs/install.html @@ -10,30 +10,24 @@

Compiling and Installing

    -
  1. Unix / X11 +
  2. Prerequisites for building -
  3. Windows -
  4. Building with SCons -
  5. Other +
  6. Building with autoconf (Linux/Unix/X11) +
  7. Building with SCons (Windows) +
  8. Building with legacy Makefiles (deprecated) +
  9. Building for other systems +
  10. Library Information +
  11. Building OpenGL programs with pkg-config
-
- - - -

1. Unix/X11 Compilation and Installation

 -

1.1 General prerequisites for building

+

1. Prerequisites for building

+

1.1 General

 @@ -155,58 +195,9 @@ Later, if you want to rebuild for a different configuration run

- -

1.5 The libraries

- -

-When compilation has finished, look in the top-level lib/ -(or lib64/) directory. -You'll see a set of library files similar to this: -

-
-lrwxrwxrwx    1 brian    users          10 Mar 26 07:53 libGL.so -> libGL.so.1*
-lrwxrwxrwx    1 brian    users          19 Mar 26 07:53 libGL.so.1 -> libGL.so.1.5.060100*
--rwxr-xr-x    1 brian    users     3375861 Mar 26 07:53 libGL.so.1.5.060100*
-lrwxrwxrwx    1 brian    users          11 Mar 26 07:53 libGLU.so -> libGLU.so.1*
-lrwxrwxrwx    1 brian    users          20 Mar 26 07:53 libGLU.so.1 -> libGLU.so.1.3.060100*
--rwxr-xr-x    1 brian    users      549269 Mar 26 07:53 libGLU.so.1.3.060100*
-lrwxrwxrwx    1 brian    users          12 Mar 26 07:53 libglut.so -> libglut.so.3*
-lrwxrwxrwx    1 brian    users          16 Mar 26 07:53 libglut.so.3 -> libglut.so.3.7.1*
--rwxr-xr-x    1 brian    users      597754 Mar 26 07:53 libglut.so.3.7.1*
-lrwxrwxrwx    1 brian    users          14 Mar 26 07:53 libOSMesa.so -> libOSMesa.so.6*
-lrwxrwxrwx    1 brian    users          23 Mar 26 07:53 libOSMesa.so.6 -> libOSMesa.so.6.1.060100*
--rwxr-xr-x    1 brian    users       23871 Mar 26 07:53 libOSMesa.so.6.1.060100*
-
- -

-libGL is the main OpenGL library (i.e. Mesa). -
-libGLU is the OpenGL Utility library. -
-libglut is the GLUT library. -
-libOSMesa is the OSMesa (Off-Screen) interface library. -

- -

-If you built the DRI hardware drivers, you'll also see the DRI drivers: -

-
--rwxr-xr-x   1 brian users 16895413 Jul 21 12:11 i915_dri.so
--rwxr-xr-x   1 brian users 11849858 Jul 21 12:12 r200_dri.so
--rwxr-xr-x   1 brian users 16050488 Jul 21 12:11 r300_dri.so
--rwxr-xr-x   1 brian users 11757388 Jul 21 12:12 radeon_dri.so
-
- -

-If you built with Gallium support, look in lib/gallium/ for Gallium-based -versions of libGL and device drivers. -

- - -

1.6 Installing the header and library files

+

Installing the header and library files

The standard location for the OpenGL header files on Unix-type systems is @@ -246,8 +237,70 @@ This is a handy way to compare multiple OpenGL implementations.

+ + + +

5. Building for other systems

+ +

+Documentation for other environments (some may be very out of date): +

+ + + + + + +

6. Library Information

+ +

+When compilation has finished, look in the top-level lib/ +(or lib64/) directory. +You'll see a set of library files similar to this: +

+
+lrwxrwxrwx    1 brian    users          10 Mar 26 07:53 libGL.so -> libGL.so.1*
+lrwxrwxrwx    1 brian    users          19 Mar 26 07:53 libGL.so.1 -> libGL.so.1.5.060100*
+-rwxr-xr-x    1 brian    users     3375861 Mar 26 07:53 libGL.so.1.5.060100*
+lrwxrwxrwx    1 brian    users          11 Mar 26 07:53 libGLU.so -> libGLU.so.1*
+lrwxrwxrwx    1 brian    users          20 Mar 26 07:53 libGLU.so.1 -> libGLU.so.1.3.060100*
+-rwxr-xr-x    1 brian    users      549269 Mar 26 07:53 libGLU.so.1.3.060100*
+lrwxrwxrwx    1 brian    users          14 Mar 26 07:53 libOSMesa.so -> libOSMesa.so.6*
+lrwxrwxrwx    1 brian    users          23 Mar 26 07:53 libOSMesa.so.6 -> libOSMesa.so.6.1.060100*
+-rwxr-xr-x    1 brian    users       23871 Mar 26 07:53 libOSMesa.so.6.1.060100*
+
+ +

+libGL is the main OpenGL library (i.e. Mesa). +
+libGLU is the OpenGL Utility library. +
+libOSMesa is the OSMesa (Off-Screen) interface library. +

+ +

+If you built the DRI hardware drivers, you'll also see the DRI drivers: +

+
+-rwxr-xr-x   1 brian users 16895413 Jul 21 12:11 i915_dri.so
+-rwxr-xr-x   1 brian users 16895413 Jul 21 12:11 i965_dri.so
+-rwxr-xr-x   1 brian users 11849858 Jul 21 12:12 r200_dri.so
+-rwxr-xr-x   1 brian users 16050488 Jul 21 12:11 r300_dri.so
+-rwxr-xr-x   1 brian users 11757388 Jul 21 12:12 radeon_dri.so
+
+ +

+If you built with Gallium support, look in lib/gallium/ for Gallium-based +versions of libGL and device drivers. +

+ + -

1.7 Building OpenGL programs with pkg-config

+

7. Building OpenGL programs with pkg-config

Running make install will install package configuration files @@ -268,64 +321,6 @@ For example, compiling and linking a GLUT application can be done with:
- -

2. Windows Compilation and Installation

- -

-Please see the instructions on building with SCons. -

- - - - -

3. Building with SCons

- -

-To build Mesa with SCons on Linux or Windows do -

-
-    scons
-
-

-The build output will be placed in -build/platform-machine-debug/..., where platform is for -example linux or windows, machine is x86 or x86_64, optionally followed -by -debug for debug builds. -

- -

-To build Mesa with SCons for Windows on Linux using the MinGW crosscompiler toolchain do -

-
-    scons platform=windows toolchain=crossmingw machine=x86 mesagdi libgl-gdi
-
-

-This will create: -

- -

-Put them all in the same directory to test them. -

- - - -

4. Other systems

- -

-Documentation for other environments (some may be very out of date): -

- - - - -