a584a5a22517211c3f5f47e1f4157407cf8b3d82
[mesa.git] / docs / bugs.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <html lang="en">
3 <head>
4 <meta http-equiv="content-type" content="text/html; charset=utf-8">
5 <title>Report a Bug</title>
6 <link rel="stylesheet" type="text/css" href="mesa.css">
7 </head>
8 <body>
9
10 <div class="header">
11 The Mesa 3D Graphics Library
12 </div>
13
14 <iframe src="contents.html"></iframe>
15 <div class="content">
16
17 <h1>Report a Bug</h1>
18
19 <p>
20 The Mesa bug database is hosted on
21 <a href="https://freedesktop.org">freedesktop.org</a>.
22 The old bug database on SourceForge is no longer used.
23 </p>
24
25 <p>
26 To file a Mesa bug, go to
27 <a href="https://gitlab.freedesktop.org/mesa/mesa/issues">
28 GitLab on freedesktop.org</a>
29 </p>
30
31 <p>
32 Please follow these bug reporting guidelines:
33 </p>
34
35 <ul>
36 <li>Check if a new version of Mesa is available which might have fixed
37 the problem.
38 <li>Check if your bug is already reported in the database.
39 <li>Monitor your bug report for requests for additional information, etc.
40 <li>Attach the output of running glxinfo or wglinfo.
41 This will tell us the Mesa version, which device driver you're using, etc.
42 <li>If you're reporting a crash, try to use your debugger (gdb) to get a stack
43 trace. Also, recompile Mesa in debug mode to get more detailed information.
44 <li>Describe in detail how to reproduce the bug, especially with games
45 and applications that the Mesa developers might not be familiar with.
46 <li>Provide an <a href="https://github.com/apitrace/apitrace">apitrace</a>
47 or simple GLUT-based test program if possible.
48 </ul>
49
50 <p>
51 Bug reports will automatically be forwarded by bugzilla to the Mesa
52 developer's mailing list.
53 </p>
54
55 <p>
56 The easier a bug is to reproduce, the sooner it will be fixed.
57 Please do everything you can to facilitate quickly fixing bugs.
58 If your bug report is vague or your test program doesn't compile
59 easily, the problem may not be fixed very quickly.
60 </p>
61
62 </div>
63 </body>
64 </html>