perlthanks - 云端在线

程序：

您的姓名

perlbug - 如何提交有关 Perl 的错误报告

概要

错误

错误 [ -v [ -a 地址 [ -s 主题 [ -b 身体 | -f 输入文件 [ -F 输出文件 ]
[ -r 退货地址 [ -e 编辑 [ -c 管理员地址 | -C [ -S [ -t [ -d [ -A ]
[ -h [ -T ]

错误 [ -v [ -r 退货地址 ]
[ -A [ -好的 | -好的 | -诺克 | -不行 ]

非常感谢

商品描述

该程序旨在帮助您生成和发送错误报告（以及感谢信）
关于 perl5 及其附带的模块。

在大多数情况下，您可以从命令行以交互方式运行它，而无需任何特殊
参数并按照提示操作。

如果您发现了一个带有非标准端口的错误（不属于
分配)、二进制发行版或非核心模块（例如 Tk、DBI 等），然后
请参阅该发行版附带的文档以确定正确的
报告错误的地方。

如果您无法使用 错误 （很可能是因为您的系统
没有办法发送 perlbug 识别的邮件），你可以使用这个工具
撰写您的报告并将其保存到一个文件中，然后您可以将其发送到 perlbug@perl.org
使用您的常规邮件客户端。

在极端的情况下， 错误 在您的系统上可能无法很好地引导您完成
编写错误报告。 在这些情况下，您可以使用 错误 -d 得到系统
包含在手动编写的错误报告中的配置信息
perlbug@perl.org.

报告错误时，请查看此清单：

您运行的是哪个版本的 Perl？
在命令行中输入“perl -v”来查找。

您是否正在运行最新发布的 perl 版本？
看着 http://www.perl.org/ 找出答案。 如果您使用的不是最新发布的
版本，请尝试在最新的稳定版本上复制您的错误。

请注意，有关旧版本 Perl 中的错误的报告，尤其是那些表明
您还没有测试过当前稳定版的 Perl，收到的可能会更少
来自构建和维护 Perl 的志愿者的关注，而不是报告中的错误
当前版本。

此工具不适用于报告 Perl 5.0 之前的任何版本中的错误。

您确定您遇到的是错误吗？
我们得到的大量错误报告被证明是记录在
珀尔。 浏览一下，确保您遇到的问题不是故意的
Perl 发行版附带的文档。

鉴于 Perl 文档的庞大数量，这不是一项微不足道的任务，但如果
您可以指向表明您所看到的行为的文档 错,
您的问题可能会受到更多关注。 你可能想开始 文件
perltrap 用于指向新的（和有经验的）Perl 程序员运行的常见陷阱的指针
入。

如果您不确定遇到的错误消息的含义， 文件
perldiag 的解释。 如果消息不在 perldiag 中，则可能不是
由 Perl 生成。 您可能有幸查阅您的操作系统文档
代替。

如果您使用的是非 UNIX 平台 文件 perlport，因为某些功能可能是
未实施或工作方式不同。

您可以使用 Perl 调试器找出问题所在。 为了
有关如何使用调试器的信息 文件 调试。

你有合适的测试用例吗？
重现错误越容易，修复的可能性就越大——如果没有人
可以重复您的问题，它可能不会得到解决。

一个好的测试用例具有以下大部分属性：简短、简单的代码； 很少依赖
外部命令、模块或库； 没有平台相关的代码（除非它是一个
特定于平台的错误）； 清晰、简单的文档。

一个好的测试用例几乎总是被包含在 Perl 测试中的一个很好的候选者
套房。 如果您有时间，请考虑编写您的测试用例，以便轻松完成
包含在标准测试套件中。

您是否已包含所有相关信息？
务必包括 确切 错误消息，如果有的话。 “Perl 出现错误”不是
确切的错误信息。

如果您获得核心转储（或等效的），您可以使用调试器（DBX, GDB等）到
生成要包含在错误报告中的堆栈跟踪。

注意：除非你的 Perl 已经用调试信息编译（通常 -g)，堆栈跟踪
可能有点难以使用，因为它很可能只包含
函数名而不是它们的参数。 如果可能，请使用 debug 重新编译 Perl
信息并重现崩溃和堆栈跟踪。

你能用简单的英语描述这个错误吗？
一个可重现的错误越容易理解，它就越有可能被修复。
您可以提供对问题的任何见解都会有很大帮助。 换句话说，
尝试分析问题（尽可能地）并报告您的发现。

你能自己修复这个错误吗？
如果是这样，那是个好消息； 带有补丁的错误报告可能会收到大量
比那些没有补丁的人更多的关注和兴趣。 请附上您的补丁
报告使用“-p”选项。 发送补丁时，使用“git
格式补丁”如果可能，尽管使用“diff -pu”创建的统一差异可以
也差不多。

您的补丁可能会与更改请求或更详细的请求一起返回
关于你的修复的解释。

以下是创建高质量补丁的一些提示：

确保补丁没有反转（diff 的第一个参数通常是
原始文件，第二个参数是您更改的文件）。 确保你测试你的补丁
通过在发送之前将其与“git am”或“patch”程序一起应用。
尝试遵循与您尝试修补的代码相同的风格。 确保您的
补丁确实有效（“进行测试”，如果您正在修补的内容被 Perl 的
测试套件）。

可以使用“perlbug”提交报告吗？
错误 除其他外，将确保您的报告包含关键信息
关于你的 perl 版本。 如果“perlbug”在您完成后无法邮寄您的报告
输入它，您可能需要自己编写消息，添加由
“perlbug -d”并将其通过电子邮件发送至 perlbug@perl.org. 如果由于某种原因，您无法运行
“perlbug”在您的系统上，确保包括由
运行“perl -V”（注意大写的 V）。

无论您使用“perlbug”还是手动发送电子邮件，请确保您的主题行
信息丰富。 “一个错误”没有提供信息。 “perl 崩溃”和“帮助！！！”都不是。
这些都没有帮助。 对错误的简洁描述很好。

您可以使用“perlbug”提交感谢信吗？
是的，您可以通过使用“-T”选项或通过调用程序来做到这一点
“谢谢”。 感谢信很好。 它让人们微笑。

完成您的工作后，请准备好等待，被告知错误在您的代码中，或者
可能根本得不到答复。 维护 Perl 的志愿者很忙，所以如果
您的问题是您自己代码中的一个明显错误，难以理解或者是
现有报告的副本，您可能不会收到个人回复。

如果修复错误对您很重要，请监控 perl5-porters@perl.org
邮件列表（邮件列表经过审核，您的消息可能需要一段时间才能显示）和
Perl 开发版本的提交日志，并鼓励维护者善待
冰镇饮料的文字或提议。 （请善待维护者。骚扰或
燃烧它们可能会产生与您想要的相反的效果。）

随时更新有关您的错误的票证 http://rt.perl.org 如果有新版本
Perl 已发布，但您的错误仍然存​​在。

配置

-a 发送报告的地址。 默认为 perlbug@perl.org.

-A 不要向回复地址发送收到错误的确认。 一般是
如果你是一个积极关注的 perl 维护者，那么使用这个选项才是明智之举
perl 搬运工让您的消息到达。

-b 报告正文。 如果未包含在命令行中，或包含在带有 -f,
您将有机会编辑消息。

-C 不要将副本发送给管理员。

-c 发送报告副本的地址。 默认为本地 perl 的地址
管理员（在构建 perl 时记录）。

-d 数据模式（重定向或管道输出时的默认模式）。 这会打印出你的
配置数据，无需邮寄任何东西。 你可以用这个 -v 要得到
更完整的数据。

-e 编辑器使用。

-f 包含报告正文的文件。 使用它可以快速发送准备好的
信息。

-F 将结果输出到的文件，而不是作为电子邮件发送。 特别有用
在没有直接互联网连接的机器上运行 perlbug 时。

-h 打印选项的简要摘要。

-好的 向 perl 搬运工报告在此系统上的成功构建。 势力 -S 和 -C. 势力
并提供值 -s 和 -b. 如果不能，只提示输入退货地址
猜一猜（用于 使）。 指定的荣誉返回地址 -r。 您可以
使用这个 -v 以获得更完整的数据。 仅当本系统发生时才报告
小于 60 天。

-好的 As -好的 除了它会报告旧系统。

-诺克 报告在此系统上构建失败。 势力 -C. 强制和提供一个值
HPMC胶囊 -s，然后要求您编辑报告并说明出了什么问题。
或者，可以使用准备好的报告提供 -f. 只提示输入
如果无法猜到则返回地址（用于与 使）。 荣誉返回地址
指定为 -r. 你可以用这个 -v 以获得更完整的数据。 仅有的
如果此系统不到 60 天，则进行报告。

-不行 As -诺克 除了它会报告旧系统。

-p 要包含的一个或多个补丁文件或其他文本附件的名称
那个报告。 多个文件必须用逗号分隔。

-r 您的退货地址。 如果您不这样做，程序会要求您确认其默认值
使用此选项。

-S 发送无需确认。

-s 邮件中包含的主题。 如果您不提供，系统会提示您
在命令行上。

-t 测试模式。 目标地址默认为 perlbug-test@perl.org.

-T 发送感谢信而不是错误报告。

-v 在报告中包含详细的配置数据。

作者

肯尼斯·阿尔巴诺夫斯基 (kjahds@kjahds.com>)，随后 DOC古鲁萨米·萨拉西 (Gurusamy Sarathy)
(<gsar@activestate.com>), 汤姆克里斯蒂安森 (tchrist@perl.com>), 内森·托金顿
(<gnat@frii.com>), 查尔斯 F.兰德尔 (cfr@pobox.com>), 迈克盖伊 (mjtg@cam.ac.uk>),
多米尼克·邓洛普 (domo@computer.org>), Hugo van der Sanden (hv@crypt.org>), 贾科
希塔涅米 (jhi@iki.fi>), 克里斯南多 (pudge@pobox.com>), 乔恩·奥尔旺
(<orwant@media.mit.edu>, 理查德·弗利 (理查德.foley@rfi.net>), 杰西文森特
(<jesse@bestpractical.com>) 和 Craig A. Berry (craigberry@mac.com>）。

使用 onworks.net 服务在线使用 perlthanks