bugs.htm 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head>
  2. <meta http-equiv="Content-Language" content="en-us">
  3. <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
  4. <meta name="GENERATOR" content="Microsoft FrontPage 5.0">
  5. <meta name="ProgId" content="FrontPage.Editor.Document">
  6. <title>Bugs</title>
  7. </head>
  8. <body bgcolor="#ffffff" text="#000000">
  9. <table border="1" bgcolor="#007f7f" cellpadding="2">
  10. <tbody><tr>
  11. <td bgcolor="#ffffff">
  12. <img src="../c++boost.gif" alt="c++boost.gif (8819 bytes)" width="277" height="86"></td>
  13. <td><a href="../index.htm"><font face="Arial" color="#ffffff"><big>Home</big></font></a></td>
  14. <td><a href="../libs/libraries.htm"><font face="Arial" color="#ffffff"><big>
  15. Libraries</big></font></a></td>
  16. <td><a href="../people/people.htm"><font face="Arial" color="#ffffff"><big>
  17. People</big></font></a></td>
  18. <td><a href="faq.htm"><font face="Arial" color="#ffffff"><big>FAQ</big></font></a></td>
  19. <td><a href="index.htm"><font face="Arial" color="#ffffff"><big>More</big></font></a></td>
  20. </tr>
  21. </tbody>
  22. </table>
  23. <h1>What to do about Boost bugs</h1>
  24. <ol>
  25. <li>Make sure the bug isn't already fixed in the latest sources. The most
  26. recent version of everything on the Boost web site is available from
  27. the <a href="http://www.boost.org/more/download.html#CVS">boost public CVS
  28. repository</a>.<br>
  29. <br>
  30. </li>
  31. <li>If you are a Boost user, or a Boost developer that doesn't have a CVS
  32. write access: <br>
  33. <br>
  34. <ol>
  35. <li>Submit a bug report to either
  36. <a href="http://www.boost.org/more/mailing_lists.htm#users">boost-users list</a>,
  37. <a href="http://www.boost.org/more/mailing_lists.htm#main">boost mailing
  38. list</a>, or our <a href="http://sourceforge.net/tracker/?group_id=7586">bug
  39. tracking facility</a> at SourceForge; submitting it to either of the mailing
  40. lists is a preferred way - because many of the Boost developers read the
  41. lists on a daily basis, this way you are likely to get a quicker response,
  42. and the discussions that often arise there from (possible) bug reports are
  43. quite interesting and educational as well;<br>
  44. <br>
  45. </li>
  46. <li>If you have a proposed patch to the code, post it along with your bug
  47. report, preferably in the <em>context diffs</em> format (<code>diff -c</code>);
  48. if you can, send a patch relative to the current CVS state. A canonical
  49. example of creating a patch file follows (let's assume that you've found
  50. a bug in the file <code>intentional_bug.hpp</code>:<br>
  51. <br>
  52. <ol>
  53. <li>Download the latest version of <code>intentional_bug.hpp</code> from CVS.</li>
  54. <li>Make sure that the bug is still present in the code.</li>
  55. <li>Copy the file <code>intentional_bug.hpp</code> to a file called <code>intentional_bug.hpp.orig</code>.</li>
  56. <li>Apply your changes to <code>intentional_bug.hpp</code>.</li>
  57. <li>Run "<code>diff -c intentional_bug.hpp.orig intentional_bug.hpp &gt; intentional_bug.hpp.patch</code>" from the command prompt.</li>
  58. <li>Submit the patch file together with an explanation of the bug
  59. and the proposed fix; and don't forget to include the word <b>patch</b> or <b>bug</b>
  60. in the subject if you're submitting to the <a href="http://www.boost.org/more/mailing_lists.htm#main">boost mailing list</a>.<br>
  61. <br>
  62. </li>
  63. </ol>
  64. </li>
  65. </ol>
  66. </li>
  67. <li>If you are a Boost developer, and you have a CVS write access: <br>
  68. <br>
  69. <ol>
  70. <li>If the bug is trivial (e.g. misspelled name, missed <code>typename</code>,
  71. etc.), and you are willing to make a fix, either make your changes locally
  72. and contact the library author(s)/maintainer(s) about it, or go ahead and
  73. check the fix into CVS, but post a notification about it to the
  74. <a href="http://www.boost.org/more/mailing_lists.htm#main">boost mailing
  75. list</a> (if the author is not very active on the list, you also might want
  76. to consider <code>cc</code>'ing him as well); <br>
  77. <br>
  78. </li>
  79. <li>If the bug is non-trivial, and/or you don't have the time and resources to fix it,
  80. submit a bug report (see p. 2 above); chances are that the maintainer(s)
  81. will respond promptly and take care of the problem; <br>
  82. <br>
  83. </li>
  84. <li>Otherwise, create a temporary branch in CVS, make your changes there, and
  85. ask the library author(s)/maintainer(s) to review them; if they are ok with
  86. the new code, either you or they can integrate the fixes into the main
  87. trunk. </li>
  88. </ol>
  89. </li>
  90. </ol>
  91. <hr>
  92. <p>Contributed by <a href="../people/aleksey_gurtovoy.htm">Aleksey Gurtovoy</a></p>
  93. <p>Revised <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->18 January, 2002<!--webbot bot="Timestamp" i-checksum="38453" endspan -->
  94. </p>
  95. <br>
  96. </body></html>
粤ICP备19079148号