ch02_03.htm

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

Perl for Win32 from the same source kit that their Unix counterparts
used. In addition, the Perl build mechanism for Win32 began to
support more than just commercial development toolkits, such as
Microsoft's Visual C++. A Perl developer who wanted
to build the Perl source kit with a free development toolkit could
build Perl with
<a name="INDEX-62" />Cygwin (<a href="http://www.cygnus.com">www.cygnus.com</a>), a Unix layer on top of
Win32, or <a name="INDEX-63" />Mingw32
(<a href="http://www.mingw.org">www.mingw.org</a>) with
<i class="command">dmake</i>, a set of Win32 runtime libraries that
provide a Unix emulation under native Win32.
</p>



<a name="ch02-6-fm2xml" /><blockquote><b>TIP:</b> 
Unless there's something specific that you gain by
building your own Perl for Win32, then you should use the Activestate
build, ActivePerl.
</p>
</blockquote>

<a name="perlnut2-CHP-2-SECT-3.2.1" /><div class="sect3">
<h3 class="sect3">2.3.2.1. ActivePerl</h3>

<p>The canonical source for the <a name="INDEX-64" />ActivePerl distribution at the time
of this writing is at <a href="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/">http://aspn.activestate.com/ASPN/Downloads/ActivePerl/</a>.
Included in the distribution are:
</p>

<dl>
<dt><i><em class="emphasis">Perl for Win32</em></i></dt>
<dd>
Binary for the core Perl distribution</p>
</dd>


<dt><i><em class="emphasis">Perl for ISAPI</em></i></dt>
<dd>
IIS plug-in for use with ISAPI-compliant web servers</p>
</dd>


<dt><i><em class="emphasis">PerlScript</em></i></dt>
<dd>
ActiveX scripting engine</p>
</dd>


<dt><i><em class="emphasis">Perl Package Manager</em></i></dt>
<dd>
Manager for Perl modules and extensions</p>
</dd>

</dl>

<p><a name="INDEX-65" />The ActivePerl binary comes as a
self-extracting executable that uses the standard Win32 InstallShield
setup wizard to guide you through the installation process. By
default, Perl is installed into the directory
<em class="emphasis">C:\Perl\version</em>, in which
<em class="emphasis">version</em> is the current version number (e.g.,
5.005). (For information on customizing your installation, see the
Win32 FAQ on the ActiveState web site.) The installation also
associates the file extension <em class="emphasis">.pl</em> with Perl and
adds the directory into which you installed Perl to your PATH
environment variable.
</p>

<p>If you want to install ActivePerl, you can do so by running the
<em class="emphasis">MSI</em> archive that's shipped by
ActiveState. If the <em class="emphasis">MSI</em> archive is not
associated with the MSI application, you need to obtain
<em class="emphasis">InstMsi.exe</em><a name="INDEX-66" />
from the downloads section at <a href="http://www.microsoft.com">www.microsoft.com</a>.
</p>

<p>If you don't (or can't) install MSI
on your system, ActiveState has made available a Perl installer that
doesn't use MSI, but be aware that this installer
doesn't have a corresponding de-installer.
</p>

</div>

<a name="perlnut2-CHP-2-SECT-3.2.2" /><div class="sect3">
<h3 class="sect3">2.3.2.2. Standard Perl distribution</h3>

<p>The standard Perl distribution is available from CPAN, where
you'll find binary and source distributions for the
current version of Perl. The <a name="INDEX-67" /><a name="INDEX-68" /><a name="INDEX-69" />source distributions come as
<em class="emphasis">.tar.gz</em> files, which you can extract using a
utility that supports <em class="emphasis">gzip</em> files,
<em class="emphasis">tar</em> files, and long filenames. Ports of both GNU
<em class="emphasis">gzip</em><a name="INDEX-70" /> and
<em class="emphasis">tar</em><a name="INDEX-71" /> <a name="INDEX-72" /> are available for the various Win32
platforms, or you can use a graphical <em class="emphasis">zip</em>
archive program such as WinZip. Make sure you preserve the directory
structure when you unpack the distribution.
</p>

<p>To install from the source, you need the Microsoft Visual C++
compiler, the Borland C++ compiler, or
<a name="INDEX-73" />Mingw32 with EGCS
gcc-2.95.X. If you're using
<a name="INDEX-74" />Cygwin32, <em class="emphasis">do not</em> try
to build Perl in the win32 subdirectory. Instead, you should run
<em class="emphasis">Configure</em> in the <em class="emphasis">src</em>
directory as you would when building under a Unix platform. You also
need a <em class="emphasis">make</em> utility. Microsoft Visual C++ comes
with <em class="emphasis">nmake</em>, or you can use
<em class="emphasis">dmake</em>.<a href="#FOOTNOTE-3">[3]</a></p><blockquote class="footnote"> <a name="FOOTNOTE-3" /><p> [3]See the
<em class="emphasis">README.win32</em> file for information on obtaining
Mingw32 and a Win32 <em class="emphasis">dmake</em> port.</p>
</blockquote>

<p>Once you have the distribution, start by reading the file
<em class="emphasis">README.win32</em>. Next, edit the file
<em class="emphasis">Makefile</em> in the <em class="emphasis">win32</em>
subdirectory of the distribution and make sure that
you're happy with the values for the install drive
and directory. Then execute the following commands from the
<em class="emphasis">win32</em> subdirectory of the distribution to build,
test, and install the distribution. This example assumes that you
have the proper environment variables (LIB, INCLUDE, etc.) set up for
your compiler and that <em class="emphasis">nmake</em> is your make
program.
</p>

<blockquote><pre class="code">C:\&gt; nmake         <em class="emphasis">Build all of Perl</em>
C:\&gt; nmake test    <em class="emphasis">Test your distribution</em>
C:\&gt; nmake install <em class="emphasis">Install to target directory, as specified in the Makefile</em></pre></blockquote>



<a name="ch02-8-fm2xml" /><blockquote><b>TIP:</b> 
If you're running Mingw32, you'll
use <i class="command">dmake</i>, since <i class="command">nmake</i> is part
of commercial development suites&#x2014;such as Microsoft Visual
C++&#x2014;and is not available separately. </p>
</blockquote>

<p>Assuming everything
is now built correctly, you just need to add the
<em class="emphasis">bin</em> subdirectory of the installation target
directory to your path or to your operating environment under
Microsoft server platforms such as Windows NT. For example, if you
installed the Perl distribution to <em class="emphasis">C:\Perl</em>,
you'll want to add the directory containing
<em class="filename">perl.exe</em> (e.g.,
<em class="emphasis">C:\Perl\bin</em>) to your path. </p>
<p>Finally, you should restart your machine so the environment
changes take effect, and you're ready to go. This is
of particular importance if you're running Perl
under Windows 95, 98, or ME. </p>

<blockquote><b>WARNING:</b> 
<a name="INDEX-75" />
<a name="INDEX-76" />Windows 95/98 users can
expect significantly different functionality from their Perl
distribution than Windows NT users. For various reasons, some of the
Win32 modules don't work on Windows 95/98. The
functionality required to implement them may be missing on Windows
95/98, or bugs in Windows 95 may prevent them from working
correctly<a name="INDEX-77" /><a name="INDEX-78" />. 
</p>
</blockquote>

</div>
</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_02.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_04.htm"><img src="../gifs/txtnexta.gif" alt="Next" border="0" /></a></td></tr><tr><td align="left" valign="top" width="228">2.2. How Is CPAN Organized?</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.4. Getting and Installing Modules</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>