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 | 251 +++++++++++++++++++++++----------------------- 1 file changed, 123 insertions(+), 128 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,85 +237,89 @@ This is a handy way to compare multiple OpenGL implementations.

- -

1.7 Building OpenGL programs with pkg-config

-

-Running make install will install package configuration files -for the pkg-config utility. -

-

-When compiling your OpenGL application you can use pkg-config to determine -the proper compiler and linker flags. -

+ +

5. Building for other systems

-For example, compiling and linking a GLUT application can be done with: +Documentation for other environments (some may be very out of date):

-
-   gcc `pkg-config --cflags --libs glut` mydemo.c -o mydemo
-
- -
- - -

2. Windows Compilation and Installation

-

-Please see the instructions on building with SCons. -

+ - -

3. Building with SCons

+ +

6. Library Information

-To build Mesa with SCons on Linux or Windows do +When compilation has finished, look in the top-level lib/ +(or lib64/) directory. +You'll see a set of library files similar to this: 

-    scons
+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*
+

-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. +libGL is the main OpenGL library (i.e. Mesa). +
+libGLU is the OpenGL Utility library. +
+libOSMesa is the OSMesa (Off-Screen) interface library.

-To build Mesa with SCons for Windows on Linux using the MinGW crosscompiler toolchain do +If you built the DRI hardware drivers, you'll also see the DRI drivers: 

-    scons platform=windows toolchain=crossmingw machine=x86 mesagdi libgl-gdi
+-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
+

-This will create: -

- -

-Put them all in the same directory to test them. +If you built with Gallium support, look in lib/gallium/ for Gallium-based +versions of libGL and device drivers.

- -

4. Other systems

+ +

7. Building OpenGL programs with pkg-config

-Documentation for other environments (some may be very out of date): +Running make install will install package configuration files +for the pkg-config utility.

- +

+When compiling your OpenGL application you can use pkg-config to determine +the proper compiler and linker flags. +

+

+For example, compiling and linking a GLUT application can be done with: +

+
+   gcc `pkg-config --cflags --libs glut` mydemo.c -o mydemo
+
+
-- 2.30.2