考虑一下这个模块App::TimeTracker。如果你点击SYNOPSIS
部分的tracker
链接,你会在这里结束,而你本应该在这里结束。这里给出了负责该行为的Pod源代码,这表明使用了以下Pod格式化代码:
L<tracker>
我可以通过提供一个绝对链接来解决这个问题:
L<tracker|https://metacpan.org/pod/release/DOMM/App-TimeTracker-3.000/bin/tracker>
但这修复了指向3.000版本的链接,该版本将来可能会更改。
那么,总体上应该如何做到这一点呢?
使用不带版本号的完整路径:https://metacpan.org/pod/distribution/App-TimeTracker/bin/tracker
。
问题是tracker_bash_autocomplete没有被MetaCPAN作为文档正确地索引。NAME
部分有一个基于手册页的非常具体的格式,MetaCPAN必须遵守手册页才能知道如何链接到您的文档。将tracker bash autocomplete
放在连字符之前会使MetaCPAN将其索引为tracker
。
=head1 NAME
tracker_bash_autocomplete - whatever