[BACK]Return to report.html CVS log [TXT][DIR] Up to [local] / www

Annotation of www/report.html, Revision 1.2

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