| 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 in DEBUG builds |
| (``--buildtype debug`` for Meson). |
| |
| 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/mesa/main/dlist.c`` for details. |
