关于如何有效地提供bug报告的文章
如何有效地报告 Bug作者:Simon Tatham 专业的自由软件程序员
翻译:Dasn
http://www.chiark.greenend.org.uk/~sgtatham/bugs-cn.html
建议magiclinux的用户按照比较规范的格式提供错误报告。
以下是debian的错误报告格式,可以参考。
您应该在主题行(Subject)清楚简洁地描述错误。这个标题将会做为错误跟踪系统中该份错误报告的标题,所以请尽量简洁清楚。
您需要在邮件属性一开始的地方放一个仿真文件头 (pseudo-header) 。也就是邮件属性的第一行应该像这样:
Package: <something>
将 <something> 替换成您要报告包含错误的软件包名称。
邮件属性的第二行应该像这样:
Version: <something>
将 <something> 替换成该软件包的版本。
您需要在仿真文件头中指定正确的 Package 以便让错误跟踪系统将信息送到软件包维护者手上。这里有相关的信息。
这些仿真文件头 (pseudo-header) 区域应该在一行的最前面。
请在您的报告中加入:
* 确切而完整的错误信息。这非常重要!
* 您做了或输入了些什么,以便重现该问题。
* 错误行为的描述:您预期应该有什么样的行为,而您看到的是如何。
* 您建议如何修正,或甚至您自己做的修补程序。
* 详细解释您如何设置该程序。包含完整的设置文件属性。
* 任何其他相依于这个问题软件包的软件包版本。
* 您使用的核心版本(输入 uname -a 来获取);您的共享 C 程序库(输入 ls -l /lib/libc.so.6 或 dpkg -s libc6 | grep ^Version 来获取);以及其他您觉得对解决问题有帮助的详细的 Debian 系统信息。例如,如果您的 Perl有问题,您可以提供 `perl' 程序的版本(输入 perl -v 或 dpkg -s perl | grep ^Version: 来获取)。
* 其他相关的硬件详细信息。如果您回报的是硬件驱动程序的问题,请列出您系统中所有的硬件,因为很多问题是源于 IRQ 或 I/O 地址的冲突。
另外也请加入其他相关的详情 -- 您不用担心报告太长。如果您在使用上发生问题的信息、纪录不大,您也可以将它们附加进来。(最好能够将文件用 uuencode 编码以免包含了一些特殊字符。) ok! Magiclinux.org好像就是这个样子的
页:
[1]