X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=docs%2Fdebugging.html;h=c6f69fe162da8ff043bd6a270d2210f565b0a860;hb=0709c0f6b40b1e365104b248464ffefa746b5052;hp=cdefa7d210d205e5b9473ccc2afa14bdf5e42163;hpb=0b27aceae2464db3dd149cf4fd667e353a655c5e;p=mesa.git diff --git a/docs/debugging.html b/docs/debugging.html index cdefa7d210d..c6f69fe162d 100644 --- a/docs/debugging.html +++ b/docs/debugging.html @@ -1,36 +1,43 @@ - + + + + + Debugging Tips + + + -Debugging Tips +
+ The Mesa 3D Graphics Library +
- + +
-

Debugging Tips

+

Debugging Tips

Normally Mesa (and OpenGL) records but does not notify the user of errors. It is up to the application to call glGetError to check for errors. Mesa supports an - environment variable, MESA_DEBUG, to help with debugging. If - MESA_DEBUG is defined, a message will be printed to stdout whenever - an error occurs. + environment variable, MESA_DEBUG, to help with debugging. If + MESA_DEBUG is defined, a message will be printed to stdout + whenever an error occurs.

- More extensive error checking is done when Mesa is compiled with the - DEBUG symbol defined. You'll have to edit the Make-config file and - add -DDEBUG to the CFLAGS line for your system configuration. You may - also want to replace any optimization flags with the -g flag so you can - use your debugger. After you've edited Make-config type 'make clean' - before recompiling. + More extensive error checking is done in DEBUG builds + (--buildtype debug for meson, build=debug for scons).

- In your debugger you can set a breakpoint in _mesa_error() to trap Mesa - errors. + In your debugger you can set a breakpoint in _mesa_error() to trap + Mesa errors.

There is a display list printing/debugging facility. See the end of - src/dlist.c for details. + src/dlist.c for details.

- - +
+ +