问题标签 [perldoc]

根据Pod::Usage 的文档，pod2usage(-verbose => 2)“打印了整个手册页”。但是，在某些情况下，会显示脚本的 perl 源代码，而不是格式正确的联机帮助页。

这是一个例子：

运行脚本：

我正在寻找 $term/$TERM 的正确设置，以便在 XQuartz 的窗口中使用。xterm 和 vt100 都不能正常工作。它们确实可以显示纯文本，但是当我尝试使用一些非纯文本时它们会遇到麻烦。

手册页通常显示正常，但有时它们会出现问题。（不幸的是，目前我想不出一个好的坏例子。）

现在，当我尝试显示 POD 时，我看到了这个。这是一些简单的 pod 和一些 perldoc 以不同的 $term 设置运行：

我在 tcsh 和 bash 中遇到了同样的问题。

Perldoc 曾经在 OSX 上的 xterms 上运行良好。几年前这种行为开始了，我终于厌倦了它，并试图让它再次工作。（Perldoc，一些手册页，嗯，还有一些我看到过这个问题的东西。）

非常感谢你的帮忙！

版本：XQuartz 2.7.11；OSX 10.13.4；Perl v5.26.2；Perldoc v3.28

作为一名 perl 开发人员，我知道perldoc实用程序。我是 python 新手，我一直在寻找相同的东西并找到了pydoc。但是 pydoc 的问题是它也在执行我的脚本，而我只想看到写在三引号内的文档。任何帮助，将不胜感激。

我正在运行这个：

并得到上述错误。我已经正确安装了 ensembl，但 perldoc 显示错误。你能就解决这个问题提出你的建议吗？谢谢！

我发现perldoc.pl具有很高的可用性级别是最新的版本 5.30.0。

Perl.org链接到perldoc.perl.org，它在 5.26.1 版本停止。但另一方面，它链接到下载（5.28.2 版）到草莓 Perl（实际上是 5.30.0 版），我觉得这很令人困惑。

我已经知道 Perl 6 是一种完全不同的语言。5.26.* 之后可能还有其他语言障碍吗？

背景

由于我很少使用它，所以当我重新进入 Perl 时，程序更新是起点。这就是为什么我有兴趣在安装之前研究delta 文档 ，而这个 delta 很难找到。

我正在寻找一种在 Perl 中实现 JSDoc 样式注释的方法。当我搜索“JSDoc”和“Perl”时，我让自己陷入了一些谷歌循环，因为显然 JSDoc 是/是用 Perl 编写的，因此我所有的研究都把我推向了错误的方向。

我知道 POD 是生成 CPAN 样式文档的标准，但我没有任何运气挖掘出任何详细示例：

我希望拥有的是能够处理类似于 JSDoc 的评论的东西，它支持如下评论：

在谷歌搜索的随机截图中，我看到了一个这样的例子：

这让我相信在某个地方，有一个代码注释库可以处理这个问题。

有什么建议吗？

仅供参考，我正在使用 Eclipse 和 Epic，所以如果有可以在该环境中实现的解决方案并且可能可以输出代码提示等，则可以加分

我有这个 POD：

podchecker不抱怨。perldoc显示了这一点：

我希望“要检查的内容”行进一步缩进。

如何更改我的 POD 以显示缩进的参数？有没有比使用=items 更好的方法呢？

这曾经是一个超级简单的不费吹灰之力。例如，如果我正在寻找 python 文档，我会首先在谷歌上搜索：

python 文档 pdf

……瞧！第一个结果正是我们所需要的：一个包含 Python 的 PDF 的可下载文件。有 27 个文件，但其中一个文件记录了 Python 核心。

但我不是在寻找全面的 Python 文档。我正在寻找相同类型的文档，但对于 Perl。做同样的谷歌搜索：

Perl 文档 pdf

（或类似的查询）将显示对perl.org、perldoc.perl.org、perl.developpez.com、perl.mines-albi.fr等的引用，但没有一个提供单个综合 PDF 的下载链接，该链接记录了核心珀尔。

曾经有一个可下载的大 PDF 文件（从一个大的联机帮助页构建），自某些 5.x 版本以来就消失了。我知道这个核心 Perl 文档的所有部分都可以在 perl.org、perldoc.perl.org 中在线获得，而在 perldoc 中可以离线获得。这对于想要在终端或浏览器上重复手动查询的人来说非常棒。我只是问在哪里可以找到包含整个核心 Perl 文档的单个 PDF 文件，就像有一个用于：

• Python（如上所述。请参阅：https ://docs.python.org/3/archives/python-3.9.7-docs-pdf-letter.zip ，在 zip 中作为“reference.pdf”）
• MySQL ( https://downloads.mysql.com/docs/refman-8.0-en.pdf )
• JavaScript/ECMAScript ( https://www.ecma-international.org/wp-content/uploads/ECMA-262_12th_edition_june_2021.pdf )

抱歉，如果我遗漏了一些明显的东西。

请注意：我不是在寻找“书籍推荐”，因为我的问题的 SO 评论已经断言（随后将该问题标记为不合适）。我知道书。如果我想要它们，我会从亚马逊购买。

我正在尝试提取 Perl POD 的一部分，仅此而已。如果我运行以下命令：

然后我得到输出：

我怎样才能得到special pod而没有别的？

我尝试过的事情：

• 不接受的代码、指令和目标
• 附加代码（以及 cut、pod 和 whiteline）处理程序
• 网络搜索（充其量，这会显示如何使用格式名称）

有没有一种简单的方法可以只从 POD 中获取特定格式，或者我应该自己解析文件？