Understanding SCRIPT CATEGORIES

[email protected] ("Shawn H. Corey") Tue, 21 Jul 2009 16:53:37 -0400
Newsgroups perl.scripts
Message-ID <[email protected]>
Hi,

I want to install a script into CPAN but I don't know what category to 
place it in.  Is there a web page that describes them?  I looked at 
http://cpan.org/scripts/index.html but it does not have a description of 
the categories.

The script is called "sub" and it creates skeletons of sub's by parsing 
an usage statement and applying it to a template.  An usage statement is 
not valid Perl but it makes sense.  For examples:

   $text | @text = trim( @text );

will create:

   # --------------------------------------
   #       Name: trim
   #      Usage: $text = trim( @text );
   #             @text = trim( @text );
   #    Purpose: TBD
   # Parameters: @text -- TBD
   #    Returns: $text -- TBD
   #             @text -- TBD
   #
   sub trim {
     my @text = @_;
     my $text = '';

     return wantarray ? @text : $text;
   }


and

   \%options = $object->get_options( ; @option_names );

will create:

   # --------------------------------------
   #       Name: get_options
   #      Usage: \%options = $object->get_options( ; @option_names );
   #    Purpose: TBD
   # Parameters: @option_names -- TBD
   #    Returns:     \%options -- TBD
   #
   sub get_options {
     my $self         = shift @_;
     my @option_names = @_;
     my $options      = {};

     return $options;
   }


Can someone suggest a category for it?


-- 
Just my 0.00000002 million dollars worth,
   Shawn

Programming is as much about organization and communication
as it is about coding.

Regardless of how small the crowd is, there is always one in
it who has to find out the hard way that the laws of physics
applies to them too.