docs/debugging.rst

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