X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=docs%2Finstall.html;h=3962ea5c91e12ace2584412944c6d754f1515223;hb=dff50ff592da7cb1d784fae794dd1647a5445bca;hp=16ef013688aaa3a04b8a9e3b87229142b25159d8;hpb=2b66417402bc595be301ab9ed7b9ea2a5f79e180;p=mesa.git diff --git a/docs/install.html b/docs/install.html index 16ef013688a..3962ea5c91e 100644 --- a/docs/install.html +++ b/docs/install.html @@ -1,58 +1,74 @@ -Compilation and Installation +Compiling and Installing -

Compilation and Installation

+

Compiling and Installing

  1. Unix / X11 +
  2. Windows -
  3. VMS +
  4. SCons
  5. Other
- +

1. Unix/X11 Compilation and Installation

-

1.1 Prerequisites for DRI and Hardware Acceleration

+ +

1.1 Prerequisites for DRI and hardware acceleration

-To build Mesa 7.1 with DRI-based hardware acceleration you must first have -the DRM version 2.3.1. +The following are required for DRI-based hardware acceleration with Mesa:

-

-You should also be using the Xorg server version 1.4 or 1.5. +

- -

1.2 Autoconf Compilation

+ +

1.2 Building with Autoconf

Mesa may be built using autoconf. This should work well on most GNU-based systems. -When that fails, the traditional Mesa build system is available. +If that fails the traditional Mesa build system is available. -

1.3 Traditional Compilation

+ +

1.3 Building with traditional Makefiles

The traditional Mesa build system is based on a collection of pre-defined system configurations.

-To see the list of configurations, type make alone. -Then choose a configuration from the list and type make configname. +To see the list of configurations, just type make. +Then choose a configuration from the list and type make +configname.

@@ -66,7 +82,7 @@ allow you to run OpenGL/GLX applications on any X server (regardless of whether it supports the GLX X server extension). You will not be able to use hardware 3D acceleration.

-To compile stand-alone Mesa type make in the top-level directory. +To compile stand-alone Mesa type make in the top-level directory. You'll see a list of supported system configurations. Choose one from the list (such as linux-x86), and type:

@@ -109,6 +125,7 @@ Later, if you want to rebuild for a different configuration run

+

1.4 The libraries

@@ -169,6 +186,7 @@ If you built the DRI hardware drivers, you'll also see the DRI drivers: +

1.5 Running the demos

@@ -244,6 +262,7 @@ Retrace your steps if this doesn't look right.

+

1.6 Installing the header and library files

@@ -284,7 +303,8 @@ This is a handy way to compare multiple OpenGL implementations.

-

1.7 Building OpenGL Programs With pkg-config

+ +

1.7 Building OpenGL programs with pkg-config

Running make install will install package configuration files @@ -309,20 +329,47 @@ For example, compiling and linking a GLUT application can be done with:

2. Windows Compilation and Installation

-Please see the README.WIN32 file. +Please see the instructions on building with SCons. +Alternatively see README.WIN32 file.

- - -

3. VMS Compilation and Installation

+ +

3. Building with SCons

-Please see the README.VMS file. +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 statetrackers=mesa drivers=softpipe,trace winsys=gdi
+
+

+This will create: +

+ +

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

@@ -333,6 +380,7 @@ Documentation for other environments (some may be very out of date):