From 019f055f32a0c201c769daf9ebbdd76d609866f8 Mon Sep 17 00:00:00 2001 From: Emil Velikov Date: Wed, 29 Jun 2016 14:26:36 +0100 Subject: [PATCH] docs/autoconf: update glx driver / enable-debug text With earlier commit we folded all the xlib handling in --enable-glx, but we forgot to update the documentation. Elaborate on --enable-debug and drop mentions about depenencies. v2: Grammar - s|haven't|hasn't| (Eric) Signed-off-by: Emil Velikov Reviewed-by: Brian Paul --- docs/autoconf.html | 31 +++++++++++++------------------ 1 file changed, 13 insertions(+), 18 deletions(-) diff --git a/docs/autoconf.html b/docs/autoconf.html index 5c29e5e..21ff8c1 100644 --- a/docs/autoconf.html +++ b/docs/autoconf.html @@ -55,7 +55,7 @@ to your preference, type:

-This will produce libGL.so and several other libraries depending on the +This will produce libGL.so and/or several other libraries depending on the options you have chosen. Later, if you want to rebuild for a different configuration run make realclean before rebuilding.

@@ -133,9 +133,11 @@ There are also a few general options for altering the Mesa build:

--enable-debug
-

This option will enable compiler -options and macros to aid in debugging the Mesa libraries.

-
+

This option will set the compiler debug/optimisation levels (if the user +hasn't already set them via the CFLAGS/CXXFLAGS) and macros to aid in +debugging the Mesa libraries.

+ +

Note that enabling this option can lead to noticable loss of performance.

--disable-asm

There are assembly routines @@ -174,27 +176,22 @@ architecture, the following should be sufficient to configure multilib Mesa

-

2. Driver Options

+

2. GL Driver Options

There are several different driver modes that Mesa can use. These are described in more detail in the basic installation instructions. The Mesa driver is controlled through the -configure options --enable-xlib-glx, --enable-osmesa, -and --enable-dri. +configure options --enable-glx and --enable-osmesa

Xlib

It uses Xlib as a software renderer to do all rendering. It corresponds -to the option --enable-xlib-glx. The libX11 and libXext -libraries, as well as the X11 development headers, will be need to -support the Xlib driver. +to the option --enable-glx=xlib or --enable-glx=gallium-xlib.

DRI

This mode uses the DRI hardware drivers for -accelerated OpenGL rendering. Enable the DRI drivers with the option ---enable-dri. See the basic -installation instructions for details on prerequisites for the DRI -drivers. +accelerated OpenGL rendering. To enable use --enable-glx=dri +--enable-dri.

@@ -252,10 +249,8 @@ will create the libOSMesa16 library with a 16-bit color channel.

3. Library Options

-The configure script provides more fine grained control over the GL -libraries that will be built. More details on the specific GL libraries -can be found in the basic installation -instructions. +The configure script provides more fine grained control over the libraries +that will be built. -- 2.7.4