home *** CD-ROM | disk | FTP | other *** search
/ Mac Easy 2010 May / Mac Life Ubuntu.iso / casper / filesystem.squashfs / usr / share / perl / 5.10.0 / CPAN / API / HOWTO.pm
Encoding:
Perl POD Document  |  2009-06-26  |  1.0 KB  |  45 lines
  1. =head1 NAME
  2.  
  3. CPAN::API::HOWTO - a recipe book for programming with CPAN.pm
  4.  
  5. =head1 RECIPES
  6.  
  7. All of these recipes assume that you have put "use CPAN" at the top of
  8. your program.
  9.  
  10. =head2 What distribution contains a particular module?
  11.  
  12.     my $distribution = CPAN::Shell->expand(
  13.         "Module", "Data::UUID"
  14.     )->distribution()->pretty_id();
  15.  
  16. This returns a string of the form "AUTHORID/TARBALL".  If you want the
  17. full path and filename to this distribution on a CPAN mirror, then it is
  18. C<.../authors/id/A/AU/AUTHORID/TARBALL>.
  19.  
  20. =head2 What modules does a particular distribution contain?
  21.  
  22.     CPAN::Index->reload();
  23.     my @modules = CPAN::Shell->expand(
  24.         "Distribution", "JHI/Graph-0.83.tar.gz"
  25.     )->containsmods();
  26.  
  27. You may also refer to a distribution in the form A/AU/AUTHORID/TARBALL.
  28.  
  29. =head1 SEE ALSO
  30.  
  31. the main CPAN.pm documentation
  32.  
  33. =head1 LICENSE
  34.  
  35. This program is free software; you can redistribute it and/or
  36. modify it under the same terms as Perl itself.
  37.  
  38. See L<http://www.perl.com/perl/misc/Artistic.html>
  39.  
  40. =head1 AUTHOR
  41.  
  42. David Cantrell
  43.  
  44. =cut
  45.