Как сделать ссылку Pod из модуля на скрипт внутри одного дистрибутива?

Question

Рассмотрим этот модуль App :: TimeTracker . Если вы нажмете на ссылку tracker в разделе SYNOPSIS, вы получите здесь , тогда как вы должны были здесь . Исходный код Pod, отвечающий за поведение, дан здесь , что показывает, что использовался следующий код форматирования Pod:

L<tracker>

Я могу решить проблему, предоставив вместо этого абсолютную ссылку:

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

но это исправляет ссылку на версию 3.000, которая может измениться в будущем.

Так как это вообще должно быть сделано?

Answer 1

Используйте полный путь без номера версии: https://metacpan.org/pod/distribution/App-TimeTracker/bin/tracker.

Answer 2

Проблема в том, что tracker_bash_autocomplete неправильно индексируется как документация MetaCPAN. Раздел NAME имеет очень специфический формат, основанный на man-страницах, которые необходимо соблюдать, чтобы MetaCPAN знал, как ссылаться на вашу документацию. Помещение tracker bash autocomplete перед дефисом делает MetaCPAN индексированным как tracker.

=head1 NAME

tracker_bash_autocomplete - whatever