<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <title> Bugzilla::Install::CPAN</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" title="style" type="text/css" href="../.././../../../../style.css" media="all" > </head> <body id="pod"> <p class="backlinktop"><b><a name="___top" href="../../index.html" accesskey="1" title="All Documents"><<</a></b></p> <h1>Bugzilla::Install::CPAN</h1> <div class='indexgroup'> <ul class='indexList indexList1'> <li class='indexItem indexItem1'><a href='#NAME'>NAME</a> <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a> <li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a> <li class='indexItem indexItem1'><a href='#SUBROUTINES'>SUBROUTINES</a> <li class='indexItem indexItem1'><a href='#Methods_in_need_of_POD'>Methods in need of POD</a> </ul> </div> <h1><a class='u' href='#___top' title='click to go to top of document' name="NAME" >NAME</a></h1> <p>Bugzilla::Install::CPAN - Routines to install Perl modules from CPAN.</p> <h1><a class='u' href='#___top' title='click to go to top of document' name="SYNOPSIS" >SYNOPSIS</a></h1> <pre class="code"> use Bugzilla::Install::CPAN; set_cpan_config(); install_module('Module::Name');</pre> <h1><a class='u' href='#___top' title='click to go to top of document' name="DESCRIPTION" >DESCRIPTION</a></h1> <p>This is primarily used by <a href="../../install-module.html" class="podlinkpod" >install-module</a> to do the "hard work" of installing CPAN modules.</p> <h1><a class='u' href='#___top' title='click to go to top of document' name="SUBROUTINES" >SUBROUTINES</a></h1> <dl> <dt><a name="set_cpan_config" ><code class="code">set_cpan_config</code></a></dt> <dd> <p>Sets up the configuration of CPAN for this session. Must be called before <a href="#install_module" class="podlinkpod" >"install_module"</a>. Takes one boolean parameter. If true, <a href="#install_module" class="podlinkpod" >"install_module"</a> will install modules globally instead of to the local <em class="code">lib/</em> directory. On most systems, you have to be root to do that.</p> <dt><a name="install_module" ><code class="code">install_module</code></a></dt> <dd> <p>Installs a module from CPAN. Takes two arguments:</p> <dl> <dt><a name="$name_-_The_name_of_the_module,_just_like_you'd_pass_to_the_install_command_in_the_CPAN_shell." ><code class="code">$name</code> - The name of the module, just like you'd pass to the <code class="code">install</code> command in the CPAN shell.</a></dt> <dd> <dt><a ><code class="code">$test</code> - If true, we run tests on this module before installing, but we still force the install if the tests fail. This is only used when we internally install a newer CPAN module.</a></dt> </dl> <p>Note that calling this function prints a <b>lot</b> of information to STDOUT and STDERR.</p> </dd> </dl> <h1><a class='u' href='#___top' title='click to go to top of document' name="Methods_in_need_of_POD" ><b>Methods in need of POD</b></a></h1> <dl> <dt><a name="check_cpan_requirements" >check_cpan_requirements</a></dt> </dl> <p class="backlinkbottom"><b><a name="___bottom" href="../../index.html" title="All Documents"><<</a></b></p> <!-- end doc --> </body></html>