问题标签 [perldoc]

使用命令从 Linux 命令行安装 Perl 模块cpan可以正常工作，例如：

完成后，我可以通过以下方式查看模块的文档：

但是通过这样做cfengine，它只会自动编写cpan命令脚本（在shellcommands:列表中），模块被安装，但perldoc不适用于它：

但是，调用：

会工作得很好。

为此设置一个通用环境变量（例如perldoc手册页建议的）似乎不可行，因为我观察到.pm文件被放置在非常不同的地方。

对此有任何提示吗？

当我在示例中遇到此问题时，我只是在浏览 perldocs（http://perldoc.perl.org/perlre.html#Regular-Expressions - 请参阅捕获组示例）

我找不到任何关于该语法含义的文档。

那么正则表达式 /${a}/ 在这种情况下是什么意思呢？

我编写了一个foo.pm从 Web 服务收集一些数据的类。在里面foo.pm我添加了 perldoc 来描述功能以及使用的简短指南。它的所有方法都有一个参考。

我还编写了一个子类cachedFoo.pm，它foo.pm用作基类，将自己的构造函数包装在foo'new方法周围，并foo使用数据库连接进行升级以缓存结果。我已经cachedFoo.pm为其他内容添加了 perldoc。

现在我只希望我的同事使用cachedFoo.pm. foo.pm我应该从to复制所有继承方法的 perldoc，cachedFoo.pm还是应该说“查看访问器的基类文档”？或者还有其他方法吗？

我喜欢一种文字编程风格，在他们记录的代码旁边有 POD 注释。不幸的是，这会使代码膨胀，这不是很 Perlish ;-) 我现在能找到的最好的方法是像这样使用Dist::Zilla和Pod::Weaver：

有人可能会争论删除空行，但这也会降低可读性。没有像这样重复和不必要的语法，有没有办法写得更简洁：

并将其扩展到完整的 POD：

我认为它应该可能与 Pod::Weaver 插件一起使用，但试图理解 Pod::Weaver 与 Dist::Zilla 和 PPI 相结合的架构让我的大脑受伤:-(

也许我做的不对，但是对于很多POD 链接示例，代码在pod2html中不起作用。

例如：

似乎与C:\perldoc filenameand一起使用C:\pod2text filename，但C:\pod2html --title=SomeText --outfile=filename.html filename输出：

你们认为这是我的安装或代码的问题吗？我如何解决它？

更新：

这是我的模块版本：

我的 POD 文档中有以下行：

我希望将其格式化为：

但是，当我运行时pod2html，我收到以下错误：

根据Perlpod文档和Perlpodspec文档，这应该是正确的。或者，至少在我看来是这样的。

我究竟做错了什么？

顺便说一句，这些链接确实适用于pod2markdown.

我知道这是一个愚蠢的问题。我已经使用 Perl 大约 2 个月了，我对perldoc. 我曾经man perldoc了解如何使用它，并试图找到有关该@ISA变量的文档。

但是当我这样做时：

它说

我用对了perldoc吗？还是我需要安装一些东西？

我不知道如何在我的 Perl 文档中正确显示撇号。例如，文本'test'显示为âtestâ。

• E<39>也呈现为â
  • 还I<'>
  • 还S<'>
  • 还E<apos>
• C<'>呈现为"'"（显然终端不是问题）
• F<'>呈现为下划线â

我也试过用 运行perldoc，-T但-n nroff没有-n troff任何区别。运行-t修复了撇号问题，但也会杀死所有其他文本属性。

我已经忍受了一段时间，但它真的开始让我恼火。我怎样才能让它们正确显示？

我最近接触了一些 Perl 代码，它的某些方面对我来说仍然难以捉摸。就是这个：

我知道 at-symbol 定义collection为一个数组。我也搜索了一下，并登陆了 perldoc，特别是关于I/O Operators的部分。我发现空文件句柄特别有趣；代码如下。

在同一主题上，我还注意到这种语法也是有效的：

根据 perldoc 它实际上是在调用一个内部函数，该函数glob以类似于以下代码的方式调用：

问题

第一行中提到的小于、星号、大于 ( <*> ) 符号实际上是做什么的？它是对内部开放和引用的 glob 的引用吗？会不会是特殊情况，例如空文件句柄？或者它可以是完全不同的东西，比如遗留实现？

我有一个简单的 POD 文本文件：

根据文件的此文字十六进制转储，它以 UTF-8 编码：

“ü”被编码为两个字节 C3 和 BC。

但是当我perldoc在文件上运行时，它会将我可爱的格式化 UTF-8 字符转换为 ASCII。

更重要的是，它正确处理了将“ü”表示为“ue”的德语约定。

为什么要这样做？

我可以在我的文件中添加一个额外的声明来阻止它发生吗？

经过进一步调查后，App::perlbrew我发现不同之处在于拥有特定版本的 Pod::Perldoc。

但是，如果可能的话，我仍然想要一种使 Pod::Perldoc 3.14、3.15 和 3.19 行为“正确”的方法。