Yes, there are a couple issues with links from the PDL documentation. They stem from the fact that the documentation on pdl.perl.org is generated on a personal machine (usually mine), then uploaded. The local copy of the documentation (on your personal computer--(do "help url" from a perldl shell) has internal links to the PDL documentation, but the links to non-PDL modules are broken. We try to fix this on the website by using a PHP pre-processor to reform non-PDL module links to external sites : search.cpan.org (or maybe to perldoc.perl.org). But it doesn't always work correctly--see http://sourceforge.net/p/pdl/bugs/254/ .
It was mentioned that we should link to metacpan.org instead, but they also have problems with indexing PDL modules correctly. For normal Perl modules this is not a problem, but for PDL, in which the documentation is generated at build time, it causes these problems. Fundamentally, the reliance on pod2html to generate the html docs during build is not ideal. Patches welcome, but it's an ugly problem! cheers, Derek On Oct 2, 2013, at 2:45 PM, duckyphysics wrote: > On Oct 2, 2013, at 12:42 PM, Chris Marshall <[email protected]> wrote: >> >> Yes, but where did you get the referring URL from? I looked at the >> web site and couldn't find a link like that. > > It's found through a site search, either from the built-in widget located at > http://pdl.perl.org, or through google directly. I originally found it > searching for "fits header" but "core" returns it as the top result. In fact, > all of the widget search results that I'm seeing take one to pages within > http://pdl.perl.org/PDLdocs/ > > There seem to be differing copies of documentation. I notice that going to > clicking "documentation" on http://perl.pdl.org > (http://pdl.perl.org/?docs=Modules&title=PDL::Modules) and then scrolling > down and clicking "core" takes one to a completely different set of > documentation (http://pdl.perl.org/?docs=Core&title=PDL::Core), which also > lists Astro::FITS::Header, and *that* link does work: > http://search.cpan.org/~tjenness/Astro-FITS-Header-3.07/lib/Astro/FITS/Header.pm > > > >> >> >> --Chris >> >> On Tue, Oct 1, 2013 at 6:24 PM, duckyphysics <[email protected]> wrote: >>> Thanks. I gave the referring URL in my initial message: >>> http://pdl.perl.org/PDLdocs/Core.html >>> >>> The Astro package is referenced several times on that page. I'm actually >>> trying to obtain (or at least read the documentation for) >>> Astro::FITS::Header because I want to create a valid FITS header from >>> scratch that will behave correctly in SAODS9. When I try to set keywords in >>> a perl hash, not all of them are propagated through to the final image that >>> DS9 sees. >>> >>> >>> >>>> You'll have to give the URL of the page referring to the dead >>>> link for it to be removed or fixed. Astro::FITS::Header is not >>>> in the PDL distribution so maybe that is why the link doesn't go >>>> anywhere. The docs are available via perldoc if you have the >>>> module installed, or http://search.cpan.org or http://metacpan.org >>>> if needed. >>>> >>>> --Chris >>>> >>>> >>>> On Mon, Sep 30, 2013 at 8:00 PM, duckyphysics <[email protected]> >>>> wrote: >>>>> Hello, >>>>> >>>>> I was following a link from http://pdl.perl.org/PDLdocs/Core.html to >>>>> http://pdl.perl.org/Astro/FITS/Header.html, but the latter is dead. Upon >>>>> further investigation, everything under /Astro gives 404. The page >>>>> provides the following error text: >>>>> >>>>> -- >>>>> An error has been encountered in accessing this page. >>>>> >>>>> 1. Server: pdl.perl.org >>>>> 2. URL path: /Astro/FITS/Header.html >>>>> 3. Error notes: NONE >>>>> 4. Error type: 404 >>>>> 5. Request method: GET >>>>> 6. Request query string: NONE >>>>> 7. Time: 2013-09-30 23:47:36 UTC (1380584856) >>>>> -- >>>>> >>>>> Thanks. >>>>> _______________________________________________ >>>>> Perldl mailing list >>>>> [email protected] >>>>> http://mailman.jach.hawaii.edu/mailman/listinfo/perldl >>> >>> >>> _______________________________________________ >>> Perldl mailing list >>> [email protected] >>> http://mailman.jach.hawaii.edu/mailman/listinfo/perldl > > > _______________________________________________ > Perldl mailing list > [email protected] > http://mailman.jach.hawaii.edu/mailman/listinfo/perldl > _______________________________________________ Perldl mailing list [email protected] http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
