<?xml version="1.0" encoding="windows-1252"?>
<node id="128153" title="Re: A Guide to Installing Modules" created="2001-11-28 18:46:24" updated="2005-08-15 06:36:42">
<type id="11">
note</type>
<author id="86327">
Hanamaki</author>
<data>
<field name="doctext">
++ for &lt;b&gt;tachyon's&lt;/b&gt; nice introduction to 
&lt;i&gt;module installation&lt;/i&gt;. Since I have already done about 600-700 tests
for the &lt;A HREF="http://testers.cpan.org/"&gt;CPAN-testers&lt;/A&gt;
I would like to supply some comments (footnotes) from my experience.
&lt;br&gt;&lt;br&gt;
&lt;b&gt;Some Footnotes&lt;/b&gt;&lt;br&gt;&lt;br&gt;
1. In our days, fortunately most authors use
&lt;code&gt;h2xs&lt;/code&gt; and &lt;code&gt;make dist&lt;/code&gt;.
Therefore, these tarballs expand to &lt;code&gt;Some-Module-0.01&lt;/code&gt;,
and if you &lt;code&gt;cd&lt;/code&gt; into the directory you don't have
to search for the place to do your &lt;code&gt;perl Makefile.PL&lt;/code&gt;.
&lt;br&gt;Tarball distributions which expand just to &lt;code&gt;Some&lt;/code&gt;
are really a pain, especially if you download a few modules from
the &lt;code&gt;Some::&lt;/code&gt; Namespace.&lt;br&gt;
Unfortunately there are also some tarball distributions which
don't get expanded in their own directories, but in the current
directory -- &lt;i&gt;Have fun with the cleanup afterwards&lt;/i&gt;.

&lt;br&gt;&lt;br&gt;
2. Unfortunately, many CPAN authors are still not used to --
or don't know about -- setting &lt;code&gt;PREREQ_PM&lt;/code&gt; in
&lt;i&gt;Makefile.PL&lt;/i&gt;. So be prepared to get the &lt;i&gt;"Can't locate foo/bar.pm in @INC"&lt;/i&gt;
error while running &lt;code&gt;make test&lt;/code&gt;.
&lt;br&gt;&lt;br&gt;
3. While you should find important information in the &lt;i&gt;Readme&lt;/i&gt;
File, don't be surprised if you just find a &lt;i&gt;Readme&lt;/i&gt; template,
where the author never cared  to replace "blabla".
&lt;br&gt;&lt;br&gt;
4. If &lt;code&gt;make test&lt;/code&gt; just does one test (&lt;code&gt;1..1&lt;/code&gt;)
it is in most cases just a load test. This means, your module
will get loaded without problems, but it does not tell you
wether the supplied functions work as expected. While &lt;code&gt;make test&lt;/code&gt; is
a important step for &lt;i&gt;confidence building&lt;/i&gt; you should test
the Module with your own scripts, and report errors to the
author if appropriate. Be prepared, that many tests 
supplied by the author do not test all functions.&lt;br&gt;&lt;br&gt;
Hanamaki
&lt;!-- footpad: Minor typo fixes. Hardly worth mentioning, but this thread should be as clean as possible. --&gt;
&lt;P&gt;&lt;small&gt;Edited by [footpad], ~Wed Nov 28 20:04:16 2001 (GMT)&lt;/small&gt;&lt;/P&gt;</field>
<field name="root_node">
128077</field>
<field name="parent_node">
128077</field>
</data>
</node>
