docs: update bug reporting guidelines
authorBrian Paul <brianp@vmware.com>
Sun, 2 Jul 2017 14:48:26 +0000 (08:48 -0600)
committerBrian Paul <brianp@vmware.com>
Mon, 3 Jul 2017 14:14:08 +0000 (08:14 -0600)
Suggest attaching output of glxinfo/wglinfo.  Suggest providing
an apitrace.

docs/bugs.html

index 445d9cac1e3733fb04b63de93aa59309a946f916..44955d3f7c329d97da44d4e5daab3dbd89c72d36 100644 (file)
@@ -37,11 +37,14 @@ Please follow these bug reporting guidelines:
 the problem.
 <li>Check if your bug is already reported in the database.
 <li>Monitor your bug report for requests for additional information, etc.
+<li>Attach the output of running glxinfo or wglinfo.
+This will tell us the Mesa version, which device driver you're using, etc.
 <li>If you're reporting a crash, try to use your debugger (gdb) to get a stack
 trace. Also, recompile Mesa in debug mode to get more detailed information.
 <li>Describe in detail how to reproduce the bug, especially with games
 and applications that the Mesa developers might not be familiar with.
-<li>Provide a simple GLUT-based test program if possible
+<li>Provide an <a href="https://github.com/apitrace/apitrace">apitrace</a>
+or simple GLUT-based test program if possible.
 </ul>
 
 <p>