summaryrefslogtreecommitdiff
path: root/dist/Mesa/docs/debugging.html
diff options
context:
space:
mode:
authorMatthieu Herrb <matthieu@cvs.openbsd.org>2006-11-25 18:55:19 +0000
committerMatthieu Herrb <matthieu@cvs.openbsd.org>2006-11-25 18:55:19 +0000
commit0641eddccd060a4ae333378927ffb3d9c34ddb98 (patch)
tree4a34bd4f0351f8b1cb676d91595b5b8e14b3c563 /dist/Mesa/docs/debugging.html
parentd2ecd06125d3ab42e53ffdd86d7d3103a57e810b (diff)
Import MesaLibs 6.5.1. (in dist/ since its code is shared between lib
and xserver)...
Diffstat (limited to 'dist/Mesa/docs/debugging.html')
-rw-r--r--dist/Mesa/docs/debugging.html38
1 files changed, 38 insertions, 0 deletions
diff --git a/dist/Mesa/docs/debugging.html b/dist/Mesa/docs/debugging.html
new file mode 100644
index 000000000..2df62f56e
--- /dev/null
+++ b/dist/Mesa/docs/debugging.html
@@ -0,0 +1,38 @@
+<HTML>
+
+<TITLE>Debugging Tips</TITLE>
+
+<link rel="stylesheet" type="text/css" href="mesa.css"></head>
+
+<BODY>
+
+<H1>Debugging Tips</H1>
+
+<p>
+ Normally Mesa (and OpenGL) records but does not notify the user of
+ errors. It is up to the application to call
+ <code>glGetError</code> 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.
+</p>
+
+<p>
+ 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.
+</p>
+<p>
+ In your debugger you can set a breakpoint in _mesa_error() to trap Mesa
+ errors.
+</p>
+<p>
+ There is a display list printing/debugging facility. See the end of
+ src/dlist.c for details.
+</p>
+
+</BODY>
+</HTML>