在 Perl POD 中,链接到内部函数的正确方法是什么?

KJ7*_*LNW 4 documentation perl perl-pod

perlpod文档说可以,L<link to something>但它没有指出引用 Perl 核心函数的正确方法(或者如果确实如此,对我来说并不明显)。

具体来说,我想链接到 所显示的内容perldoc -f wantarray。链接到它的正确方法是什么,以便当您单击 MetaCPAN 和其他遵循链接的 POD 查看器中的链接时,L<...>它会将您带到文档?wantarray

(请注意,这wantarray只是一个内置的 Perl 函数,例如printor open。)

zdi*_*dim 5

我发现最好的方法是在 CPAN 上调出手册页 (perldoc)

L<perlfunc/wantarray>

L<File::Find>

L<perlop>

L<perlsyn/"For Loops">
Run Code Online (Sandbox Code Playgroud)

这些会在 CPAN 上显示页面:wantarrayFile::Findperlopperlsyn 中的“For Loops”。它们在各自的perldoc页面上链接,并且看起来完全相同(除了perldoc页面可能具有的方便的目录之外)。或者使用L<wantarray|perlfunc/wantarray>,但尝试一下,因为它首先带有推断的链接文本

通过在perldoc上查找(可能的)其他类型页面并使用其页面顶部的链接“CPAN”来查找它们的语法。

由于问题与 CPAN 内容有关,因此使用 CPAN 的POD 渲染器 (pod2html)对这些内容进行了测试和处理。

如果这些 CPAN 托管页面不能解决问题,那么我只能看到使用perldoc页面的 URL。


顺便说一句,UNIX 手册页直接在文档中工作:

L<crontab(5)>
Run Code Online (Sandbox Code Playgroud)

这会显示http://man.he.net/man5/crontab