perldoc 不显示已安装 perl 模块的文档

Question

使用 cpan 命令从 Linux 命令行安装 Perl 模块效果很好，例如:

$ cpan [Module]

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

$ perldoc [Module]

但是通过 cfengine 执行此操作，它只会自动编写 cpan 命令的脚本(在 shellcommands: 列表中)，模块会安装, 但 perldoc 将无法工作:

$ perldoc Text::Histogram
No documentation found for "Text::Histogram".*

但是，调用:

$ man Text::Histogram

会工作得很好。

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

有什么提示吗？

Answer 1

perldoc 搜索 Perl 模块包含路径 (@INC)。如果 perldoc 找不到，perl 也找不到。尝试 perl -wle 'use The::Module' 看看 perl 是否可以加载它。如果它可以找到它，那么就会发生奇怪的事情。

如果您通过第三方程序安装模块(即使它只是使用 cpan 客户端)，可能发生的情况是，它是否安装到不同的位置和/或使用与您安装的不同的 perl在命令行上使用。这有很多原因，最有可能的三个是...

• 它的 PATH 与您不同，并且为不同的 perl 找到了不同的 cpan 副本。
• 它以不同的方式配置了 cpan 客户端以安装到不同的 PATH。
• cpan 被配置为安装在主目录下，并以不同的用户身份运行。

模块没有文档的可能性也很奇怪。

您可以使用 perldoc -D The::Module 查看 perldoc 正在做什么以查找模块(这在旧版本中可能是 -v)。