Search code examples
perlperl-podmetacpan

How to make a Pod link from a module to a script within the same distribution?

Consider this module App::TimeTracker. If you click on the tracker link in the SYNOPSIS section you end up here whereas you should have ended up here. The Pod source code responsible for the behavior is given here, which shows that the following Pod formatting code was used:

L<tracker>

I can fix the problem by providing an absolute link instead:

L<tracker|https://metacpan.org/pod/release/DOMM/App-TimeTracker-3.000/bin/tracker>

but this fixes the link to version 3.000 which may change in the future.

So how should this be done in general?

Solution

  • Use the full path without the version number: https://metacpan.org/pod/distribution/App-TimeTracker/bin/tracker.