1Debugging Tips
2==============
3
4Normally Mesa (and OpenGL) records but does not notify the user of
5errors. It is up to the application to call ``glGetError`` to check for
6errors. Mesa supports an environment variable, ``MESA_DEBUG``, to help
7with debugging. If ``MESA_DEBUG`` is defined, a message will be printed
8to stdout whenever an error occurs.
9
10More extensive error checking is done in DEBUG builds
11(``--buildtype debug`` for meson, ``build=debug`` for scons).
12
13In your debugger you can set a breakpoint in ``_mesa_error()`` to trap
14Mesa errors.
15
16There is a display list printing/debugging facility. See the end of
17``src/dlist.c`` for details.
18