Annotation of www/report.html, Revision 1.4
1.4 ! deraadt 1: <html>
! 2: <head>
! 3: <title>OpenBSD problem reports</title>
! 4: <link rev=made href=mailto:www@openbsd.org>
! 5: <meta name="resource-type" content="document">
! 6: <meta name="description" content="OpenBSD problem report page">
! 7: <meta name="keywords" content="openbsd,problemreports">
! 8: <meta name="distribution" content="global">
! 9: <meta name="copyright" content="This document copyright 1998 by OpenBSD.">
! 10: </head>
! 11:
! 12: <body bgcolor="#ffffff" text="#000000" link="#23238e">
! 13:
! 14: <h3><strong><font color=#0000e0><center>OpenBSD problem reports</center></font></strong>
! 15: <hr>
! 16: <h4>
! 17: <h3><strong><font color=#0000e0>Released versions problem reports.</font></strong>
! 18: <h4>Before reporting bugs/problems with released versions,
1.1 deraadt 19: go through this checklist:
1.4 ! deraadt 20: <ol>
! 21: <li>First check for <a href="http://www.openbsd.org/errata.html">patches
! 22: and notes regarding the release.</a>
! 23: <li>Next find out if there is a <a href="http://www.openbsd.org/orders.html">
! 24: newer release available.</a>
! 25: <li>The last thing to check is for <a href="http://www.openbsd.org/plus.html">
! 26: changes made between OpenBSD versions.</a>
! 27: </ol>
! 28: <p>
! 29: If nothing looks like it addresses your problem, then it may be time to read
! 30: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sendbug&&sektion=1&format=html">
! 31: man sendbug</a>
! 32: before submitting a bug report.
! 33: <p>
! 34: Read further down for the <a href="#bugtypes">types of bug reports</a> desired.
! 35:
! 36: <h3><strong><font color=#0000e0>Current version problem reports.</font></strong>
! 37: <h4>
! 38: <ol>
! 39: <li>Test the problem at least twice, with source updated a few days apart.
! 40: <li>Do not report source tree compilation problems, unless they persist.
1.1 deraadt 41: They are almost always your mistake or they are being worked on
42: as you encounter them. People working on the project are
1.4 ! deraadt 43: doing <u>make build</u> at least once per day, and usually several times
1.1 deraadt 44: per day with different architectures.
1.4 ! deraadt 45: <li>Remember that the <a href="http://www.openbsd.org/anoncvs.html">anoncvs</a>
1.1 deraadt 46: servers are updated significantly behind the actual working source tree.
1.4 ! deraadt 47: <li>Check for <a href="http://www.openbsd.org/plus.html">changes
! 48: made between OpenBSD versions</a> to see if the problem has been
1.1 deraadt 49: addressed.
1.4 ! deraadt 50: <li>Much care is made in creating snapshots. Sometimes mistakes are made,
1.1 deraadt 51: and our apologies are extended. Reading/writing the e-mail lists
52: is more appropriate than sending in a bug report.
1.4 ! deraadt 53: </ol>
! 54: <br>
! 55: <a name="bugtypes">
! 56: <h3><strong><font color=#0000e0>Sending in bug reports.</font></strong>
! 57: <h4>
1.1 deraadt 58:
59: Try to pin-point the exact problem. Never give vague instructions,
60: or detail vague problems like "it crashes" or "I get strange interrupt
61: issues on this one box that I built." Talk to others on IRC or some
62: other forum to confirm that it is new, repeatable, etc. and make sure
63: it is not a local problem. And please don't start fixing problems that
64: require significant work until you are sure you understand them, especially
65: during our release periods when we must not change major sections of code.
66: If you are going to write significant amounts of code, check various
67: forums to make sure that someone else is not working on the problem
68: (saving duplication of effort).
69:
1.4 ! deraadt 70: <p>
1.1 deraadt 71: New features are accepted, especially with code that implements
72: your suggested new feature.
73: If someone else writes code for your new feature, the chances are that
74: it will be misunderstood and created so that you will not recognize it.
75:
1.4 ! deraadt 76: <p>
1.1 deraadt 77: Please remember that projects resources are limited.
1.4 ! deraadt 78: <a href="http://www.openbsd.org/donations.html">Donations accepted.</a>
1.1 deraadt 79:
1.4 ! deraadt 80: <p>
1.1 deraadt 81: Types of bug reports in order of desirability:
1.4 ! deraadt 82: <ol>
! 83: <li>Repeatable problems with source fixes are the best.
! 84: <li>Repeatable problems that are not specific to your hardware/software
1.1 deraadt 85: layout.
1.4 ! deraadt 86: <li>Repeatable problems specific to your software layout.
! 87: <li>Repeatable problems specific to your hardware layout.
! 88: <li>Non-repeatable problems -- or problems you do not wish to repeat.
! 89: </ol>
1.1 deraadt 90:
91: <hr>
92: <font size="-1">
93: <a href=ftp://ftp.openbsd.org/pub/OpenBSD/tools/openbsdpower.gif>
1.3 deraadt 94: <img align=right alt="" height=46 width=201 src="images/openbsdpower.gif"></a>
1.1 deraadt 95: </font>
96:
1.4 ! deraadt 97: </ol>
! 98: </body>
! 99: </html>