On Fri, 18 Nov 2005, John Siracusa wrote:
On 11/17/05 11:08 PM, Ken Williams wrote:
On Nov 17, 2005, at 7:16 PM, John Siracusa wrote:
How do I link to a POD document form within my POD in such a way that
search.cpan.org will make the correct link? I tried doing this:
L<My::Foo>
to link to My/Foo.pod in my module, but that doesn't work.
`perldoc perlpod` seems to suggest that you've got the correct syntax.
Is My::Foo in this case actually found at all by search.cpan.org?
Where does the generated link go to?
Well, here's the non-version-specific link:
http://search.cpan.org/dist/Rose-DB-Object/lib/Rose/DB/Object/Tutorial.pod
But if you click on the instance of L<Rose::DB::Object::Tutorial> near the
start of the DESCRIPTION section on this page:
http://search.cpan.org/~jsiracusa/Rose-DB-Object/lib/Rose/DB/Object.pm
you'll see that it doesn't work. It takes me here:
http://search.cpan.org/perldoc?Rose%3A%3ADB%3A%3AObject%3A%3ATutorial
which is a 404.
What looks like is happening is that search.cpan.org
(sometimes) converts links in the docs into things
of the form
http://search.cpan.org/perldoc?Module::Name
This seems to work if Module::Name is a registered name
(eg, a query in CPAN.pm turns up some information on
it), but doesn't for modules (or pure pod files) like
Rose::DB::Object::Tutorial for which CPAN.pm doesn't
know anything about (ie, it doesn't appear in the
CPAN/PAUSE indices).
--
best regards,
randy kobes
