如何提交 BUG 报告

chaisave

Debian 保证让她的 bug 让大家都能看到，这样有利于问题的发现和解决。我们作为 Debian 的用户，虽然不能像 DD (Debian Developers) 一样对 Debian 作出直接的贡献，或许也没有那么多时间和财力帮助 Debian。但是我们可以作臭虫报告(bug report)。如果能提交 bug 报告。这样就能更好的帮助 Debian，同时也帮助了我们。

提交 bug 可以一般以 email 的形式发给 BTS (Debian Bug Tracking System).

建议您先看一下官方的《如何回报 Debian 中的错误》，它已经说得比较明白了。如果您还有疑虑，不妨继续看下去。

大家可能认为提交 bug report 是很难的事，有很多手续，要填许多东西。嗯，您猜对了一半。Debian 已经帮我们考虑到了，reportbug 是一个自动化的 bug 提交软件。Emacs 的使用者可以使用 debbugs-el 来提交错误报告。当然，最好您的 Debian 能够发信。如果不能。后面会提到解决的办法。
这里我们以 reportbug 为例，介绍一下它的使用，以及其他需要了解的知识。

1. 您需要先安装她，不用我说您也知道了，就是：
# apt-get install reportbug

2. 当发现 bug 后，如果您认准了就是软件的问题，而不是自己操作或者配置的问题。那么恭喜您，您发现了一个 bug！
这次是 openoffice.org-help-zh-cn 的问题，它的有个目录名肯定有不对。（我们以 openoffice.org-help-zh-cn 为例）

3. 运行 reportbug。
3.1. 它询问我们出问题的软件包的名字
然后它会自动查询相符的软件包名，然后让您选一个。

Getting status for openoffice.org-help-zh-cn...
Which of the following packages is the bug in?

这次它找到了：

1 openoffice.org-help-zh-cn  OpenOffice.org office suite help (simplified
                             Chinese)

2 openoffice.org-help-zh-cn  Source package

啊哈，这我知道，我用的是编译好的，应该是第一个。根据提示：

Select one of these packages:

我输入 “1”。

3.2. 然后 reportbug 会自己上网查询 BTS 里已有的有关 openoffice.org-help-zh-cn 的错误报告，然后一一列举出来，问你碰到的错误是不是在这里面。这次，似乎还没有人报告 openoffice.org-help-zh-cn 的这个问题。reportbug 告诉我们：

Querying Debian bug tracking system for reports on openoffice.org-help-zh-cn
No bug reports found.

3.3. 那好，没人报告的话，我来！reportbug 问你一个简要的错误描述，它将被作为错误报告信的标题。

Please briefly describe your problem (you can elaborate in a moment; an empty
response will stop reportbug). This should be a pithy summary of what is wrong
with the package, for example, "fails to send email" or "does not start with -q
option specified."

对了，在这里我们必须使用英文，因为 maintainer 和 软件的作者，或是将来其他报告错误的朋友极有可能不懂中文。不过别担心，
我们只要把错误讲清楚就可以了。这并不难。

好了，拟一个标题吧：
OOo can not find the help document in Chinese

3.4.然后 reportbug 又问了，让我指定一个错误的严重程度。

Please select a severity level: [normal]

很多时候，我们碰到的错误是 minor [2]。这次也不例外，我选择“2”

3.5.接着 reportbug 会启动一个编辑器来编辑具体的错误报告。我这里编辑器使用的是是 VIM （当然您可以自己设置[2]） 。
您可以发现，reportbug 已经把您的一些系统信息填好了，这些信息很可能对分析问题和解决它有帮助。在报告中有像这样的一行，
我们就在它下面写我们的发现：

*** Please type your report below this line ***

下面是我写的 bugreport：

1. 
   
2. After I have openoffice.org-help-zh-cn installed, when I try to find the help doc in OOo via
   
3. the menu of Help->Contents,  she always complains something like "file not found".
   
4. Here is a solution:
   
5. I found a directory of /usr/lib/openoffice/help/zh-cn, and I created a sym link to it, like:
   
6. WSh:/usr/lib/openoffice/help# ln -s zh-cn zh-CN
   
7. 
   
8. And, now I can use the help docs using Help->Contents as it should.
   
9. 
   
10. I think a patch for the rule file may solve this problem:
    
11. 
    
12. ---debian/rules          Fri Mar  1 11:05:44 2002
    
13. +++debian/rules         Fri Mar  1 13:25:14 2004
    
14. -HELPLANG=$(shell echo "$(SOURCE_NAME)" | sed 's/^.*-help-//')
    
15. +HELPLANG=$(shell echo "$(SOURCE_NAME)" | sed 's/^.*-help-//'| sed 's/-.*/\U&/')
    
16. 
    
17. 
    
18. Thanks
    

复制代码

写完了就可以保存退出了。罗嗦一句，您可千万别忘了保存后再退出哦！

3.6 现在，reportbug 会问您最后一个问题。没有其他要求的话，摁"y"， reportbug 就把报告信函发送给 BTS 了。如果需要添加附件或者需要重新修改报告，就选“a” 或者 “E”。如果您的 Debian 不能发信，您可以选“n”，把报告存成一个文件，再到能发送信件的机器上发送它。

4. 当然，BTS 会在收到您的报告后自动回信，告知您您的信件已经转交给了软件包的维护者，并给你所提交的 bug 指定一个 ID (比如, 654321)，以后就可以通过 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=654321 或者 654321@bugs.debian.org 来跟踪这个 bug。

5. 在维护者收到您的报告后，一般会及时回应。比如询问具体细节，或者告诉您一些解决的办法。
您可以直接回信给他/她，如果有必要还可以把信 CC 给 654321@bugs.debian.org。让其他朋友也知道问题现在进展如何。

6. 当问题解决(close)后，BTS 还会发一封信给您，告诉您最新的 deb 包已经就绪，不日将能使用。

7. The End.

[1] 关于错误的严重程度的具体说明可参见：http://www.debian.org/Bugs/Developer.zh-cn.html
[2] /etc/reportbug.conf 是一个不错的配置范例，它把几乎所有的配置都做了注释，
您很容易就能知道，自己该如何才能修改从而让自己满意。