附录B -- 如何报告bug

好的bug报告对任何软件项目的发展都是十分有价值的贡献。但是就象写好的软件一样，好的问题报告也需要一些工作。请明白大多数开发者忙的要死并且会收到多的变态的电子邮件。所以尽管你的反馈对改进MPlayer至关重要而且非常值得赞赏，希望你理解你必须提供我们需要的所有信息并且严格遵循这个文件中的指导进行。

如何修正bug

如果你觉得你有足够的技巧欢迎你尝试自己修正bug。或者也许你已经这么干了？请阅读这个简短的文件了解怎样让你的代码包括到MPlayer的代码中。如果你有问题可以从加入mplayer-dev-eng 邮件列表的人那里获得帮助。

如何报告bug

首先，请先尝试MPlayer最新的CVS版本，因为你的bug在那里可能已经被修正了。发展过程进展的相当快，官方发行版的大部分问题在几天甚至几小时之内就被报告了，因此请仅仅使用CVS来报告bug。CVS指令能在这个页面的底部或者 README中找到。如果这样做没有改进那么请查阅已知的bug列表和文件的其他部分。如果你的问题我们没有提到或者按照我们提供的步骤没有解决，那么请报告bug。

请不要私下向单独的开发者报告bug。这是一项社区工作所以可能有若干人都对它感兴趣。有时其它用户已经遇到过你的麻烦并且知道如何绕过这个问题即使它是MPlayer代码中的bug。

请尽可能详细的描述你的问题。做一些小的侦探工作来确定问题发生的情况的范围。这个bug只在一定的情况中出现吗？或是具体针对特定文件或者文件类型吗？它是针对于唯一的编码格式还是独立于编码格式的？你能用所有的输出驱动重现它吗？你提供的信息越多我们的修复你的问题的机会就越大。别忘了也要包括下面所要求的有价值的信息，否则我们将无法正确分析你的问题。

有篇文采飞扬的关于如何在公共论坛上提问的极好的指导是Eric S. Raymond写的 How To Ask Questions The Smart Way。你照着那些指示做是没问题的。但是请明白我们大家都在我们的自由时间自愿地回复邮件列表。我们十分忙碌并且不能保证你的问题一定能得到解决甚至得到回复。

向哪里报告错误？

订阅mplayer-users邮件列表：
http://mplayerhq.hu/mailman/listinfo/mplayer-users
同时，把你的bug发送到：
mplayer-users@mplayerhq.hu

这个列表使用的语言是英语。请遵循标准的Netiquette标准并且不要发送HTML邮件 到任何我们的邮件列表。你将被忽略或者封掉。如果你不知道什么是HTML邮件，以及它为什么邪恶，阅读这个不错的文件。它解释了所有细节和关掉HTML的指令。也请注意到我们不会个别地CC(抄送)给人因此最好通过订阅来保证你会收到答案。

报告什么？

系统信息：

你的Linux发行版或者操作系统，比如：。
- Red Hat7.1
- Slackware 7.0 + devel packs from 7.1 ...
内核版本：
uname -a
libc版本：
ls -l /lib/libc[.-]*
X版本：
X -version
gcc和ld版本：
gcc -v ld -v
binutils版本：
as --version
如果你有全屏模式方面的问题：
- 窗口管理器类型和版本
如果是buggy的GUI：
- GTK版本
- GLIB版本
- libpng版本
- bug发生时GUI的状态

硬件 & 驱动：

CPU信息(仅用于Linux)：
cat /proc/cpuinfo
显卡制造厂和型号，例如：。
- ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM
- Matrox G400 DH 32MB SGRAM
显卡驱动类型 & 版本，e.g：。
- X built-in driver
- nVidia 0.9.623
- Utah-GLX CVS 2001-02-17
- DRI from X 4.0.3
声卡类型 & 驱动，例如：。
- Creative SBLive! Gold with OSS driver from oss.creative.com
- Creative SB16 with kernel OSS drivers
- GUS PnP with ALSA OSS emulation
如果不放心的话对linux系统再附上lspci -vv的输出。

对于编译问题/错误

请包括这些文件：

configure.log
config.h
config.mak
libvo/config.mak

对于回放问题

请包括MPlayer的冗长水平为1的输出，但是记住当你把它粘贴到你的邮件中时不要删减输出内容。开发者们需要所有的信息来正确的分析问题。你可以像这样把输出导入到一个文件中：

mplayer -v [options] [filename] &> mplayer.log

如果你的问题是具体对于一个或更多的文件的，那么请上传捣乱的文件：

ftp://mplayerhq.hu/MPlayer/incoming/

再上传一个小的同样文件名的文本文件加上.txt的扩展名。在其中描述对于这个特别的文件你遇到的问题加上你的电子邮件地址还有MPlayer冗长水平为1的输出。通常文件的前1-5MB足以重现问题，但为了以防万一我们要求你运行：

dd if=yourfile of=smallfile bs=1024k count=5

它将截取'your-file'的头5兆并把他们写到'small-file'里。然后，测试一下这个小文件，如果bug仍然存在那么你的样本对我们来说是足够了。请永远不要通过邮件的发送这样文件！把它上传，然后只发送FTP-server上的文件的路径与文件名。如果文件在网上可以获得，那么发送准确的URL就足够了。

对于崩溃

如果你的崩溃有一个core dump那么继续阅读下一段，否则跳过它。

如何从一个core dump中提取出有意义的信息

请建立下面的命令文件：

disass $eip-32 $eip+32 printf "eax=%08lX\n",$eax printf "ebx=%08lX\n",$ebx printf "ecx=%08lX\n",$ecx printf "edx=%08lX\n",$edx printf "esp=%08lX\n",$esp printf "ebp=%08lX\n",$ebp printf "edi=%08lX\n",$edi printf "esi=%08lX\n",$esi

然后直接在你的命令行下执行下列命令：

gdb mplayer --core=core -batch --command=command_file > mplayer.bug

如何保存一个可再现的崩溃的信息

开启调试代码重新编译MPlayer：

./configure --enable-debug=3 make

然后用gdb运行MPlayer：

gdb mplayer

现在你在gdb内。输入：

run -v [options-to-mplayer] filename

然后再现你的崩溃。一旦你成功了，gdb将回到命令行，你需要输入

bt disass $eip-32 $eip+32

然后把完整的输出发给我们。

一般的注意事项

如果有什么东西特别大(比如log)最好把它压缩(最好是gzip或者bzip)之后上载到FTP server上并且在你的bug报告中只要包含路径和文件名。

我知道我在干什么...

如果你按照上述步骤建立了一个正确的bug报告而且你充满信心它是MPlayer中的bug，而不是因为编译错误或者文件损坏的问题，你已经阅读了文档并且找不到解决方案，此外你的声卡驱动正常，那么你可能想要订阅mplayer-advusers列表并把你的bug报告发到那里以便得到更快更好的答案。

请听从我们的劝告，如果你在那里问新手级的问题或者问用户手册中已经回答过的问题，你将被忽略或者被骂而不会得到答案。
因此，不要骂我们并且仅仅当你确实知道你在干什么并且觉得你已经是高级MPlayer用户或者是开发者再订阅 -advusers。如果你符合这些标准找出如何订阅应该不难...