Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • CPAN is Unusable (Score:2, Interesting)

    The new version still offers no substantial improvements with regards to what was said in the Lightning Talk CPAN is Unusable [omor.com]. The problems were, and actually still are, that it's not clear which links lead to downloads (the top section), and which to documentation (the rest). Only people familiar with CPAN know where to click for what.
    • The new search.cpan offers an improvement in the presentation
      of .pm documentation pages; they now have navigation and
      a textbox for a new search.

      Also, the .pm file now offers a link to the true .pm,
      appropriately enough labeled as source.

      Compare the before and after [omor.com].

      --
      dc
      • Also, the .pm file now offers a link to the true .pm, appropriately enough labeled as source.

        No it doesn't. It offers the same possibilities as `perldoc -m MODULE`, meaning:

        • If the pods and source code are in different files, you'll just see the source for the .pod file, not for the .pm file see Parse::RecDescent for an example
        • You can't see the source for modules that don't include POD. For example, there are two such modules coming with Archive::Zip.
        • Have you tried it ?

          If a module has the POD and code in .pod/.pm files, the source link will shoud the .pm file, not the .pod file

          Also, you can browse ALL files in the distribution, so you can see the source of modules that dont have POD

          Please research before you post what you think are facts
          • Have you tried it ?

            Please research before you post what you think are facts

            Yes I've tried it. For example, this link to Parse::RecDescent [cpan.org] used to display just the POD. I am absolutely, 100% sure, I've tried it several times over a few days time. And now, it displays the Perl source code. Odd. But a lot better.