# Appendix?D.?報告bug的樣例指導 這是Subversion項目針對新用戶如何報告bug的在線指導的少許修改版本。為什么項目有一個這樣的指導的重要性請見[Chapter?8, *管理志愿者*](# "Chapter?8.?管理志愿者")的[the section called “將每個用戶當作潛在的志愿者”](# "將每個用戶當作潛在的志愿者")。原始的文檔位于[http://svn.collab.net/repos/svn/trunk/www/bugs.html](http://svn.collab.net/repos/svn/trunk/www/bugs.html)。 ~~~ Subversion中如何報告Bug 該文檔說明了如何以及在何處報告Bug。（這里不是所有現存Bug的列表 - 您可以 在這里得到。） 何處報告Bug --------------------- * 如果是Subversion本身的Bug，可以發送郵件到users@subversion.tigris.org。 如果確認是bug，或許您可以將其輸入問題跟蹤系統。（或者如果您對Bug 非常確定，可以直接在我們的開發列表dev@subversion.tigris.org發布。 但是，如果您不能確定，最好首先在users@提交；某人會告訴您您所遇到的 情況是否與預期一致。） * 如果是APR庫的Bug，請同時在以下列表中報告： dev@apr.apache.org，dev@subversion.tigris.org * 如果是Neon HTTP庫的Bug，請同時在以下列表中報告： neon@webdav.org，dev@subversion.tigris.org * 如果是Apache HTTPD 2.0的Bug，請同時在以下列表中報告： dev@httpd.apache.org，dev@subversion.tigris.org。Apache httpd 開發者郵件列表流量較大，您的報告可能會被錯過。您也可以在 http://httpd.apache.org/bug_report.html發起一個bug。 * 如果您的毯子有bug，請給他一個擁抱讓它保持溫暖。 如何報告一個Bug ------------------- 首先，請確保它是一個bug。如果Subversion無法按照您的預期工作，請檢查 文檔和郵件列表，確保它確實應該按照您的預期工作。當然，如果是常識， 例如Subversion破壞了您的數據并導致您的顯示器冒煙，您可以相信自己的 判斷。但是如果并不確定，請繼續在用戶郵件列表users@subversion.tigris.org 中詢問，或者在IRC的irc.freenode.net中的頻道#svn中詢問。 一旦您確定是一個bug，最重要的事情得到一個簡單的描述和重現步驟。例如， 如果您發現的bug，只會發生在5個文件的10次提交中，請設法使之在單個文件 的單個提交中發生。重現步驟越簡單，開發者越有可能重現bug并修正它。 當您寫下重現步驟時，不要僅僅寫下使bug發生的散文描述，而應當給出一個 您所運行命令的一系列文本腳本，及其輸出。請使用復制粘貼，如果與文件 有關，請包含文件名，如果您覺得與內容有關，也請提供文件內容。最好是能 提供打包的重現步驟腳本，那會使我們獲益良多。 快速健全性檢查：您正在運行Subversion最近的版本，對吧？:-)或許bug已經 修正；請對最新的Subversion開發樹運行重現步驟進行測試。 除了重現步驟，我們也需要重現Bug的完整環境描述。包括： * 您的操作系統 * Subversion的發布版本和修訂版本 * 構建Subversion的編譯器和配置選項 * 您對Subversion的私下修改 * 運行Subversion的Berkeley DB版本，如果使用的話 * 所有其他可能相關的事情，寧肯信息多一點也不要少一點。 一旦完成了這些，您就準備好了編寫報告了。從對Bug的簡短描述開始，也就是 您對Subversion的預期行為方式，與之對應的實際行為方式。雖然Bug對 你是顯而易見的，但對其他人可能并不是這么明顯，所以最好可以避免猜謎游 戲。然后是環境描述，以及重現步驟。如果您希望也可以包含對于原因的猜測， 甚至是修正bug的補丁，那樣就太棒了 - 關于發送補丁的指導請看 http://svn.collab.net/repos/svn/trunk/www/hacking.html#patches。 將所有信息發送到dev@subversion.tigris.org，或者如果您已經在此詢問并被 要求發起一個問題，可以根據這里的指導進入問題跟蹤系統。 謝謝。我們知道要發起一個有效的bug報告還有很多事情要做，但是一個好的報告 可以為開發者節省大量時間，會讓bug更有可能被修正。 ~~~