Annotation of www/report.html, Revision 1.1
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>
! 90: <img align=right alt="" height=46 width=201 src="http://www.openbsd.org/openbsdpower.gif"></a>
! 91: </font>
! 92:
! 93: </OL>
! 94: </BODY>
! 95: </HTML>