问题标签 [perl-pod]

我想为perlop和写一个 Pod 文件perlopref。我的直觉是这样说

并让它产生（perlopref）

和 (perlop)

我有以下与 getopt::long 一起使用的 pod：

当我提供 -h 它会产生：

我的问题是：如何删除 -h 和 -i 之间的空行？

我注意到很多 Pod 在行之间有空白行，例如

是否严格需要这些空行，如果缺少这些空行，特定的解析器是否会感到不安。

perlpod 中cut的描述有点帮助，但我想知道其他构造：

要结束 Pod 块，请使用一个空行，然后是一个以“=cut”开头的行，然后是一个空行。这让 Perl（和 Pod 格式化程序）知道这是 Perl 代码恢复的地方。（“=cut”之前的空行在技术上不是必需的，但许多较旧的 Pod 处理器需要它。）

我最近开始尝试Dist::Zilla使用Path::Class. 我添加了[PodCoverageTests]插件，它报告了类中的一些故障，这是andPath::Class::Entity的抽象基类。Path::Class::FilePath::Class::Dir

我想要的是某种方式来告诉Entity不需要文档的测试代码，但它的两个派生类需要 - 即使方法只在父类中定义。有人知道有什么方法吗？

我是一名 Perl 程序员很长时间了，但我总是遇到 POD 中的文档问题。

当我在代码中使用 POD 注释时，代码很难阅读。当我在文件末尾使用 POD 注释时，存在文档与代码不同步的危险。

我想念一种类似于 Java 的文档风格。

我寻找一种更简单、更直观的文档风格。有这样的事吗？

我正在使用 perl 文档中关于如何在脚本中使用Getopt::Long的教程。在那里，它展示了如何使用Pod::Usage添加文档，而不必将所有内容都键入子例程或其他内容。无论如何，在示例中他们有这个；

我添加了一些我自己的论点。

我知道如何参考文档的第一部分。但是我如何引用第二部分pod2usage(2)？

当我=cut在第 1 部分的末尾添加一个新部分时，当我尝试让它显示它时，我会遇到一个命令提示符，就像它在没有显示该部分的情况下进入然后退出一样。难道我做错了什么？

我似乎记得有一个 POD 预览器的“官方”站点（perl.org 或 cpan.org）。一个人上传了一个文件，它会显示包含的 POD，就像它出现在 CPAN 上一样。有人有这个链接吗。我似乎找不到它。

我正在开发一个模块，该模块依赖Pod::Usage来解析调用脚本的 POD，然后将用法、帮助和手册文本发送到标量变量。我需要从该文本中删除最后的空格，所以我使用了一个我认为可行的简单正则表达式。它确实......但间歇性地。

这是问题的演示。任何见解将不胜感激。

在我的装有 Perl 5.10.1 的 Solaris 机器上，意外的行为（即，正则表达式未能删除最后的换行符）始终如一地发生。在带有 Perl 5.12.1 的 Windows 下，该行为是不稳定的（下面提供了输出）。

我的 Windows 盒子上的输出：

我需要将 Pod 转换为 HTML。有许多 Pod::HTML 和 Pod::Simple::* 模块。我应该使用哪一个？

因此，为了在weaver.ini插件本身中传递某些东西，似乎需要 Moose 属性。所以如果我有这样的东西weaver.ini

我的插件中需要一个相应的属性。

但是，我收到了错误

我不确定我哪里出错了。我试过改变语法，weaver.ini但似乎不是这样。