Slash Boxes
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.
More | Login | Reply
Loading... please wait.
  • by hfb (74) on 2003.11.06 5:21 (#25521) Homepage Journal
    The scripts section is deader than dead. Just be sure to document it right and, as far as I can tell, search does the right thing.
    • The scripts section is deader than dead.
      Maybe the FAQ should be updated then? It still points folks there.
      • Wow, you mean people actually read the FAQ? :) I leave it in there as I keep hoping that it'll come back to life, but it's more likely that search will come to differentiate between a script and a module distribution and index them accordingly. For now, the FAQ is correct if a bit overly optimistic.
        • Things do not work very well in the script section []. Take the first script for example:

          • the link to activitymail-1.04 [] points to a 404
          • but [] is quite able to find activitymail [], which is a complete distribution with a test suite, a META.yml, a MANIFEST and a bigger version number.

          It's nice to be able to package a script through make dist, rather than just sending a bare file to PAUSE. This gives room for tests and examples. How would search.cpan differentiate a script from a module? Via the ME

          • Yes, if you package it like a distribution as I suggested, search will index it like a module but it will only show bits in the documentation section rather than in the modules section. There are plenty of distributions which contain scripts along with the modules.

            This is the mostly right thing, but the metadata should provide more information for the indexing to make it more obvious and provide the end user with more information overall and not just for scripts v. modules. Yes, wouldn't it be nice...?