docs: reorder heading and notice
[mesa.git] / docs / bugs.html
index 76507b895e60c7d4e26080e63c7e5089a009669b..2653ffd74e6e599f841f80244ac4b31b2cc4a6cb 100644 (file)
@@ -1,29 +1,55 @@
-<HTML>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en">
+<head>
+  <meta http-equiv="content-type" content="text/html; charset=utf-8">
+  <title>Mesa Bug Reporting</title>
+  <link rel="stylesheet" type="text/css" href="mesa.css">
+</head>
+<body>
 
-<TITLE>Mesa Bug Reporting</TITLE>
+<div class="header">
+  <h1>The Mesa 3D Graphics Library</h1>
+</div>
 
-<BODY text="#000000" bgcolor="#55bbff" link="#111188">
+<iframe src="contents.html"></iframe>
+<div class="content">
 
-<H1>Bug Database</H1>
+<h1>Report a bug</h1>
 
 <p>
-Bug reports can be filed in the Bugzilla database hosted on
-<a href="http://freedesktop.org" target="_parent">freedesktop.org</a>.
+The Mesa bug database is hosted on
+<a href="https://freedesktop.org">freedesktop.org</a>.
+The old bug database on SourceForge is no longer used.
 </p>
+
+<p>
+To file a Mesa bug, go to
+<a href="https://bugs.freedesktop.org/enter_bug.cgi?product=Mesa">
+Bugzilla on freedesktop.org</a>
+</p>
+
 <p>
-Please follow these guidelines:
+Please follow these bug reporting guidelines:
 </p>
 
 <ul>
-<li>Make sure you're using the most recent version of Mesa
-<li>Make sure your bug isn't already reported
-<li>Include as much information as possible in the report
-<li>Provide a simple GLUT-based test program if possible
-<li>Check back for follow-ups to the report
+<li>Check if a new version of Mesa is available which might have fixed
+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 an <a href="https://github.com/apitrace/apitrace">apitrace</a>
+or simple GLUT-based test program if possible.
 </ul>
 
 <p>
-Bug reports will automatically be forwarded to the Mesa developer's list.
+Bug reports will automatically be forwarded by bugzilla to the Mesa
+developer's mailing list.
 </p>
 
 <p>
@@ -33,5 +59,6 @@ If your bug report is vague or your test program doesn't compile
 easily, the problem may not be fixed very quickly.
 </p>
 
-</BODY>
-</HTML>
+</div>
+</body>
+</html>