ch02_04.htm

by Randal L. Schwartz and Tom Phoenix ISBN 0-596-00132-0 Third Edition, published July 2001. (See

<p>Number of days before refetching index files</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">cpan_home</tt></p>
</td>
<td>
<p>Local directory reserved for this package</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">gzip</tt></p>
</td>
<td>
<p>Location of external program <em class="emphasis">gzip</em></p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">inactivity_timeout</tt></p>
</td>
<td>
<p>Breaks an interactive <em class="emphasis">Makefile.PL</em> after
<tt class="literal">inactivity_timeout</tt> seconds of inactivity (set to 0
to never break)
</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">inhibit_startup_message</tt></p>
</td>
<td>
<p>If true, does not print startup message</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">keep_source</tt></p>
</td>
<td>
<p>If set, keeps source in local directory</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">keep_source_where</tt></p>
</td>
<td>
<p>Where to keep source</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">make</tt></p>
</td>
<td>
<p>Location of external <em class="emphasis">make</em> program</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">make_arg</tt></p>
</td>
<td>
<p>Arguments to always pass to <em class="emphasis">make</em></p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">make_install_arg</tt></p>
</td>
<td>
<p>Same as <tt class="literal">make_arg</tt> for <em class="emphasis">make
install</em>
</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">makepl_arg</tt></p>
</td>
<td>
<p>Arguments to always pass to <em class="emphasis">perl Makefile.PL</em></p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">pager</tt></p>
</td>
<td>
<p>Location of external <em class="emphasis">more</em> program (or other
pager)
</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">tar</tt></p>
</td>
<td>
<p>Location of external <em class="emphasis">tar</em> program</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">unzip</tt></p>
</td>
<td>
<p>Location of external <em class="emphasis">unzip</em> program</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">urllist</tt></p>
</td>
<td>
<p>Arrayref to nearby CPAN sites (or equivalent locations, such as
CD-ROM)
</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">cache_metadata</tt></p>
</td>
<td>
<p>Uses serializer to cache metadata</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">prerequisites_policy</tt></p>
</td>
<td>
<p>Sets behavior for handling module dependencies; options are
<tt class="literal">follow</tt>, <tt class="literal">automatically</tt>,
<tt class="literal">ask</tt>, and <tt class="literal">ignore</tt>
</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">scan_cache</tt></p>
</td>
<td>
<p>Controls the cache-scanning behavior; options are
<tt class="literal">atstart</tt> and <tt class="literal">never</tt>
</p>
</td>
</tr>
<tr>
<td>
<p><tt class="literal">wait_list</tt></p>
</td>
<td>
<p>An arrayref that contains the wait server(s) to try</p>
</td>
</tr>

</table><p>
</dd>

</dl>
</dd>


<dt><i><em class="replaceable"><tt>option</tt></em></i></dt>
<dd>
The CPAN module configuration option or options; used with
<tt class="literal">conf</tt>. Can be one or more scalar or list options
from the table above.
</p>
</dd>


<dt><i><em class="replaceable"><tt>value</tt></em></i></dt>
<dd>
Value to be set for a configuration option. The possibilities for
<tt class="literal">o conf</tt> are:
</p>

<dl>
<dt><b><tt class="literal">o conf</tt> <em class="replaceable">scalaropt</em></b></dt>
<dd>
Prints current value of scalar option</p>
</dd>


<dt><b><tt class="literal">o conf</tt> <em class="replaceable">scalaropt value</em></b></dt>
<dd>
Sets scalar option to <em class="replaceable"><tt>value</tt></em></p>
</dd>


<dt><b><tt class="literal">o conf</tt> <em class="replaceable">listopt</em></b></dt>
<dd>
Prints current value of list option in MakeMaker format</p>
</dd>


<dt><b><tt class="literal">o conf</tt> <em class="replaceable">listopt</em> <tt class="literal">[shift|pop]</tt></b></dt>
<dd>
Shifts or pops the array in <em class="replaceable"><tt>listopt</tt></em>variable
</p>
</dd>


<dt><b><tt class="literal">o conf</tt> <em class="replaceable">listopt</em> <tt class="literal">[unshift|push|splice]</tt> <em class="replaceable">list</em></b></dt>
<dd>
Works like the corresponding Perl functions to modify the array in
<em class="replaceable"><tt>listopt</tt></em> based on
<em class="replaceable"><tt>list</tt></em></p>
</dd>


<dt><b><tt class="literal">o conf</tt> <em class="replaceable">commit</em></b></dt>
<dd>
Wites CPAN::Config with updated options</p>
</dd>

</dl>
</dd>

</dl></div>

<a name="INDEX-117" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>q</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
q
</pre><p><a name="INDEX-117" />Quits
the CPAN module shell subroutine.
</p></div>

<a name="INDEX-118" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>r</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
r
</pre><p><a name="INDEX-118" />Recommendations
for reinstallation. With no argument, lists all distributions that
are out-of-date. With an argument, tells you whether that module or
distribution is out-of-date.
</p></div>

<a name="INDEX-119" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>readme</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
readme <em class="replaceable">arglist</em>
</pre><p><a name="INDEX-119" />Finds and displays the README file for
modules or distributions in <em class="replaceable"><tt>arglist</tt></em>.
</p></div>

<a name="INDEX-120" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>recompile</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
recompile
</pre><p><a name="INDEX-120" />Runs full
<em class="emphasis">make/test/install</em> cycle over all installed
dynamically loadable modules with <tt class="literal">force</tt> in effect.
Useful for completing a network installation on systems after the
first installation, in which the CPAN module would otherwise declare
the modules already up-to-date.
</p></div>

<a name="INDEX-121" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>reload</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
reload <em class="replaceable">arg</em>
</pre><p><a name="INDEX-121" />Reloads index files or
re-<tt class="literal">eval</tt> s CPAN.pm itself.
<em class="replaceable"><tt>arg</tt></em> may be:
</p><dl>
<dt><b><tt class="literal">cpan</tt></b></dt>
<dd>
Re-<tt class="literal">eval</tt> s CPAN.pm.</p>
</dd>


<dt><b><tt class="literal">index</tt></b></dt>
<dd>
Reloads index of files.</p>
</dd>

</dl></div>

<a name="INDEX-122" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>test</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
test
</pre><p><a name="INDEX-122" />Runs
the <em class="emphasis">make test</em> command.
</p></div>

<a name="INDEX-123" /><a name="INDEX-124" /><a name="INDEX-125" /><a name="INDEX-126" /><a name="INDEX-127" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>u</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
u
</pre><p><a name="INDEX-123" />Lists
all uninstalled distributions.<a name="INDEX-124" /><a name="INDEX-125" /><a name="INDEX-126" /><a name="INDEX-127" /> 
</p></div>
<a name="INDEX-128" />

</div>


<hr width="684" align="left" />
<div class="navbar"><table width="684" border="0"><tr><td align="left" valign="top" width="228"><a href="ch02_03.htm"><img src="../gifs/txtpreva.gif" alt="Previous" border="0" /></a></td><td align="center" valign="top" width="228"><a href="index.htm"><img src="../gifs/txthome.gif" alt="Home" border="0" /></a></td><td align="right" valign="top" width="228"><a href="ch02_05.htm"><img src="../gifs/txtnexta.gif" alt="Next" border="0" /></a></td></tr><tr><td align="left" valign="top" width="228">2.3. Installing Perl</td><td align="center" valign="top" width="228"><a href="index/index.htm"><img src="../gifs/index.gif" alt="Book Index" border="0" /></a></td><td align="right" valign="top" width="228">2.5. Documentation</td></tr></table></div>
<hr width="684" align="left" />

<img src="../gifs/navbar.gif" usemap="#library-map" border="0" alt="Library Navigation Links" />
<p><p><font size="-1"><a href="copyrght.htm">Copyright &copy; 2002</a> O'Reilly &amp; Associates. All rights reserved.</font></p>

<map name="library-map">
<area shape="rect" coords="1,0,85,94" href="../index.htm"><area shape="rect" coords="86,1,178,103" href="../lwp/index.htm"><area shape="rect" coords="180,0,265,103" href="../lperl/index.htm"><area shape="rect" coords="267,0,353,105" href="../perlnut/index.htm"><area shape="rect" coords="354,1,446,115" href="../prog/index.htm"><area shape="rect" coords="448,0,526,132" href="../tk/index.htm"><area shape="rect" coords="528,1,615,119" href="../cookbook/index.htm"><area shape="rect" coords="617,0,690,135" href="../pxml/index.htm">
</map>

</body></html>