in reply to Re: CPAN's rendering of POD links
in thread CPAN's rendering of POD links

Do you know how http://search.cpan.org/perldoc?Inline::C knows that http://search.cpan.org/~sisyphus/Inline-0.45/C/C.pod is the correct file? And when you click on source you go to http://search.cpan.org/src/SISYPHUS/Inline-0.45/C/C.pm? It parses package Inline::C; and parses 
=head1 NAME

Inline::C - Write Perl Subroutines in C

=head1 DESCRIPTION

[download]
L<Inline::C-Cookbook> might have better chance linking to http://search.cpan.org/~sisyphus/Inline-0.45/C/C-Cookbook.pod if name was 
=head1 NAME

Inline::C-Cookbook - A Cornucopia of Inline C Recipes

=cut

[download]
I'm not sure if its ever explicitly stated in any docs, but the NAME part before  - is used for linking.

Replies are listed 'Best First'.
Re^3: CPAN's rendering of POD links
by syphilis (Archbishop) on Jan 02, 2009 at 00:50 UTC
    I'm not sure if its ever explicitly stated in any docs, but the NAME part before - is used for linking

    I was unaware of any of that. I think I can see what you're getting at. I'm a little puzzled as to how that "Inline::C-Cookbook" in the "NAME" is going to convey the information that the file is actually in the "C" directory (rather than the top-level directory ... or even the non-existent "C-Cookbook" directory).

    I'll give it a go, next release.

    Cheers,
    Rob
[reply]

In Section Seekers of Perl Wisdom