From 0b27aceae2464db3dd149cf4fd667e353a655c5e Mon Sep 17 00:00:00 2001 From: Brian Paul Date: Sat, 8 Mar 2003 17:38:57 +0000 Subject: Documentation/website overhaul. The website content and doc/ directory are now merged and are one and the same. --- docs/debugging.html | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 docs/debugging.html (limited to 'docs/debugging.html') diff --git a/docs/debugging.html b/docs/debugging.html new file mode 100644 index 0000000000..cdefa7d210 --- /dev/null +++ b/docs/debugging.html @@ -0,0 +1,36 @@ + + +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. +

+ +

+ 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. +

+

+ 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. +

+ + + -- cgit v1.2.3