Suppose I have a module and a command-line interface to that.

Right now using Module::Build, if I create a directory called /bin those scripts get installed. I recently learned that Metacpan.org will treat POD files (.pod) as documentation for corresponding Perl modules (.pm). But will it do the same for command-line scripts?

And if I want to link to that command from a readme or the corresponding library, can I do that with L<> and have it link correctly on metacpan?

I can and will make experiments, but it would save a lot of spurious releases and testing and time waiting for indexing if someone out there just knew what works. Thanks.