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

Diff for /www/report.html between version 1.3 and 1.4

version 1.3, 1998/11/12 16:30:31 version 1.4, 1999/05/10 14:55:28
Line 1 
Line 1 
 <HTML>  <html>
 <HEAD>  <head>
 <TITLE>OpenBSD problem reports</TITLE>  <title>OpenBSD problem reports</title>
 <LINK rev=made href=mailto:www@openbsd.org>  <link rev=made href=mailto:www@openbsd.org>
 <META name="resource-type" content="document">  <meta name="resource-type" content="document">
 <META name="description" content="OpenBSD problem report page">  <meta name="description" content="OpenBSD problem report page">
 <META name="keywords" content="openbsd,problemreports">  <meta name="keywords" content="openbsd,problemreports">
 <META name="distribution" content="global">  <meta name="distribution" content="global">
 <META name="copyright" content="This document copyright 1998 by OpenBSD.">  <meta name="copyright" content="This document copyright 1998 by OpenBSD.">
 </HEAD>  </head>
   
 <BODY bgcolor="#ffffff" text="#000000" link="#23238E">  <body bgcolor="#ffffff" text="#000000" link="#23238e">
   
 <H3><STRONG><font color=#0000e0><CENTER>OpenBSD problem reports</CENTER></font></strong>  <h3><strong><font color=#0000e0><center>OpenBSD problem reports</center></font></strong>
 <H4>  <hr>
 <H3><STRONG><font color=#0000e0>Released versions problem reports.</font></strong>  <h4>
 <H4>Before reporting bugs/problems with released versions,  <h3><strong><font color=#0000e0>Released versions problem reports.</font></strong>
   <h4>Before reporting bugs/problems with released versions,
 go through this checklist:  go through this checklist:
 <OL>  <ol>
 <LI>First check for <A href="http://www.openbsd.org/errata.html">patches  <li>First check for <a href="http://www.openbsd.org/errata.html">patches
         and notes regarding the release.</A>          and notes regarding the release.</a>
 <LI>Next find out if there is a <A href="http://www.openbsd.org/orders.html">  <li>Next find out if there is a <a href="http://www.openbsd.org/orders.html">
         newer release available.</A>          newer release available.</a>
 <LI>The last thing to check is for <A href="http://www.openbsd.org/plus.html">  <li>The last thing to check is for <a href="http://www.openbsd.org/plus.html">
         changes made between OpenBSD versions.</A>          changes made between OpenBSD versions.</a>
 </OL>  </ol>
 <P>  <p>
 If nothing looks like it addresses your problem, then it may be  If nothing looks like it addresses your problem, then it may be time to read
 time to read <U>man sendbug</U> before submitting a bug report.  <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sendbug&&sektion=1&format=html">
 <P>  man sendbug</a>
 Read further down for the <A HREF="#bugtypes">types of bug reports</A> desired.  before submitting a bug report.
   <p>
   Read further down for the <a href="#bugtypes">types of bug reports</a> desired.
   
 <H3><STRONG><font color=#0000e0>Current version problem reports.</font></strong>  <h3><strong><font color=#0000e0>Current version problem reports.</font></strong>
 <H4>  <h4>
 <OL>  <ol>
 <LI>Test the problem at least twice, with source updated a few days apart.  <li>Test the problem at least twice, with source updated a few days apart.
 <LI>Do not report source tree compilation problems, unless they persist.  <li>Do not report source tree compilation problems, unless they persist.
         They are almost always your mistake or they are being worked on          They are almost always your mistake or they are being worked on
         as you encounter them.  People working on the project are          as you encounter them.  People working on the project are
         doing <U>make build</U> at least once per day, and usually several times          doing <u>make build</u> at least once per day, and usually several times
         per day with different architectures.          per day with different architectures.
 <LI>Remember that the <A href="http://www.openbsd.org/anoncvs.html">anoncvs</A>  <li>Remember that the <a href="http://www.openbsd.org/anoncvs.html">anoncvs</a>
         servers are updated significantly behind the actual working source tree.          servers are updated significantly behind the actual working source tree.
 <LI>Check for <A href="http://www.openbsd.org/plus.html">changes  <li>Check for <a href="http://www.openbsd.org/plus.html">changes
         made between OpenBSD versions</A> to see if the problem has been          made between OpenBSD versions</a> to see if the problem has been
         addressed.          addressed.
 <LI>Much care is made in creating snapshots.  Sometimes mistakes are made,  <li>Much care is made in creating snapshots.  Sometimes mistakes are made,
         and our apologies are extended.  Reading/writing the e-mail lists          and our apologies are extended.  Reading/writing the e-mail lists
         is more appropriate than sending in a bug report.          is more appropriate than sending in a bug report.
 </OL>  </ol>
 <BR>  <br>
 <A NAME="bugtypes">  <a name="bugtypes">
 <H3><STRONG><font color=#0000e0>Sending in bug reports.</font></strong>  <h3><strong><font color=#0000e0>Sending in bug reports.</font></strong>
 <H4>  <h4>
   
 Try to pin-point the exact problem.  Never give vague instructions,  Try to pin-point the exact problem.  Never give vague instructions,
 or detail vague problems like "it crashes" or "I get strange interrupt  or detail vague problems like "it crashes" or "I get strange interrupt
Line 64 
Line 67 
 forums to make sure that someone else is not working on the problem  forums to make sure that someone else is not working on the problem
 (saving duplication of effort).  (saving duplication of effort).
   
 <P>  <p>
 New features are accepted, especially with code that implements  New features are accepted, especially with code that implements
 your suggested new feature.  your suggested new feature.
 If someone else writes code for your new feature, the chances are that  If someone else writes code for your new feature, the chances are that
 it will be misunderstood and created so that you will not recognize it.  it will be misunderstood and created so that you will not recognize it.
   
 <P>  <p>
 Please remember that projects resources are limited.  Please remember that projects resources are limited.
 <A href="http://www.openbsd.org/donations.html">Donations accepted.</A>  <a href="http://www.openbsd.org/donations.html">Donations accepted.</a>
   
 <P>  <p>
 Types of bug reports in order of desirability:  Types of bug reports in order of desirability:
 <OL>  <ol>
 <LI>Repeatable problems with source fixes are the best.  <li>Repeatable problems with source fixes are the best.
 <LI>Repeatable problems that are not specific to your hardware/software  <li>Repeatable problems that are not specific to your hardware/software
      layout.       layout.
 <LI>Repeatable problems specific to your software layout.  <li>Repeatable problems specific to your software layout.
 <LI>Repeatable problems specific to your hardware layout.  <li>Repeatable problems specific to your hardware layout.
 <LI>Non-repeatable problems -- or problems you do not wish to repeat.  <li>Non-repeatable problems -- or problems you do not wish to repeat.
   </ol>
   
 <hr>  <hr>
 <font size="-1">  <font size="-1">
Line 90 
Line 94 
 <img align=right alt="" height=46 width=201 src="images/openbsdpower.gif"></a>  <img align=right alt="" height=46 width=201 src="images/openbsdpower.gif"></a>
 </font>  </font>
   
 </OL>  </ol>
 </BODY>  </body>
 </HTML>  </html>
Legend:
Removed from v.1.3  
changed lines
  Added in v.1.4