===== Using the CPAN Module Shell =====

==== Installing Perl modules via CPAN (example): ====

**   (These commands will likely only work on a Linux system with Perl.)**

   Get CPAN shell:
  
      $ perl -MCPAN -e shell
  
      Install desired module (example):
  
         cpan> [force] install MP3::Info
  
         ("force" forces install even if regression tests fail)
  
      Other useful commands in CPAN shell:
  
         i /mp3/        - search for all modules with /mp3/ in the name
         i MP3::Info    - show information about this module
         look MP3::Info - download a module and start a subshell where you
                          can look around before installing
         readme MP3::Info - show the readme file for the module
         ?                - show command summary
  
==== View Perl documentation (example): ====
  
      # Run in command shell, not in the CPAN shell:
      # (Works if perldoc is installed and if MP3::Info has any documentation.)
      $ perldoc MP3::Info 
  
==== Install module non-interactively in command shell: ====
  
      $ perl -MCPAN -e 'install "MP3::Info"'