Welcome to the binary distribution of Perl for the Win32 platform. This distribution has been compiled using the Borland C++ compiler (version 5.02). It is built around the latest production release of Perl, version 5.004_02, which comes with Win32 support. Please note that this distribution is not to be confused with the pre-5.004 Perl port by the Activeware folks, or the binaries they distribute (which are mostly referred to by "build" numbers). This should be considered an interim (or beta) release, since it was built with the trial version of 5.004_02. A "proper" release built with official 5.004_02 sources will be made available soon after that version of Perl is made public. WHY WOULD YOU WANT THIS? ------------------------ + You want to use perl on WindowsNT or Windows95, but you have no C compiler (or at least not one that will build perl). + You seem to have the compiler stuff, but not the patience or knowledge to deal with compiling perl and the various extensions. And you are happy to continue using the binary distributions that you know people are going to keep putting out once every half moon. [May not be exactly every half moon, but you'll keep the faith. Remember to give away that compiler you don't use :)] + You have one of the supported compilers that will build Perl, but you want to jump-start your XSsively hardcore perl module development by taking this shortcut. [Beware that this distribution was compiled with Borland C++ 5.02, using `dmake', so lib\Config.pm is set up for that build. The setup procedure makes some changes to the installed version of that file, which are meant to make XS builds work for your particular installation of the Borland compiler. If you have a different compiler (Visual C++, for instance), I'd recommend you build your own Perl, and install it on top of the binary installation.] + You want a perl that is capable of doing sockets on Windows95, and you only have the Visual C++ compiler. [The Visual C++ libraries known to date have a problem with sockets on Windows95, which might cause you trouble. The Borland libraries, which this distribution was built with, do not have the problem.] INSTALLATION ------------ To install this package: * Extract the archive so that the directory structure of the files is preserved. * `cd' to the top level directory. * Type `install' (if in the command shell) or click on `install.bat' (from the Explorer). If that refuses to run for some reason (as it might on Windows95), you can instead type `perl\bin\perl install.bat' in the command shell. * Add the location of PERL.EXE to your `PATH'. * You will need to edit the contents of %NetConfig in `lib\site\Net\Config.pm' to set the names of the servers used by the libnet package. This bundle contains everything needed to build, test and install perl modules that don't need a C compiler and which use the standard MakeMaker extension build tools. Since MakeMaker needs a `make' utility, a Win32 binary of Dennis Vadura's `dmake' tool is supplied (see below for more on `dmake'). PLATFORMS --------- This binary distribution has been extensively tested only on WindowsNT. Based on reports from others, I believe it also works on Windows95, but I personally did not test it on that platform. Note the supplied binaries are for the x86 architecture. WHAT IT CONTAINS ---------------- It includes the binaries for the following packages: perl5.004_02_trial2 [*] dmake-4.1 Alias-2.3 Bit-Vector-4.2 Curses-1.01 [*] Data-Dumper-2.07 DateCalc-3.2 DateManip-5.10 DBD-ODBC-0.16 DBI-0.89 Devel-Peek-0.83 Devel-Symdump-2.00 DProf-19970614 [*] GD-1.14 [*] libnet-1.0505 [*] libwin32-0.08 libwww-perl-5.10 [*] MD5-1.7 MIME-Base64-2.03 MLDBM-1.23 Storable-0.5 [*] String-Approx-2.1 Tk402.002 NOTES: [*] These packages needed porting or other fixes to compile and run properly. All changes are included in the form of patches (the kind that can be applied using the GNU patch utility) in the `patches' subdirectory. The full sources of all of these packages (with the exception of dmake, see below for that) can be found on the Comprehensive Perl Archive Network (CPAN). Point your web browser at "http://www.perl.com/CPAN" to find the CPAN site nearest you. The package subdirectories under `distfiles' also contain any documentation and testsuites that came with the package. These are not installed, so you may want to save them for later reference. In case you find yourself needing to build things from source, there is a win32 port of GNU patch-2.1 at: http://www-personal.umich.edu/~gsar/patch2_1-win32.tar.gz that can be used to apply the included patches. The modules in the distribution doubtless reflect my own personal pattern of use. In some cases, I made a conscious decision not to include modules that don't contain C or XS source, since it should be possible to obtain, build and install such modules from CPAN without too much trouble (or a C compiler), using perl and `dmake'. Nevertheless, I shall add specific modules to the distribution if there is demand. DEMOS ----- After you install the distribution and add its location to your PATH, you can run the `widget' demo to check if your installed perl is working properly. To make sure your new PATH setting takes effect, you may have to reboot. Just type `widget' in the command shell, or double-click on `widget.bat' from the Explorer. TERMS OF USE ------------ Perl can be freely distributed under the `Artistic License' or the `GNU General Public Licence', described in the two files `Artistic' and `Copying' respectively. Most of the modules have statements to the effect that they can be distributed under the same terms as Perl, but you should download and check the individual module's sources to be sure. The included dmake tool is compiled from the latest public release of dmake-4.1 available from `ftp://plg.uwaterloo.ca/pub/dmake/'. The binary is completely unsupported. Full (commercial) support for dmake may be obtained from its author. See `http://dmake.wticorp.com/' for the latest. Note that public version of dmake-4.1 can only be distributed under the GNU General Public Licence. The remaining parts of this binary distribution itself can be distributed under the same terms as Perl. Beware that it is provided "as is", and comes with absolutely no warranty of any kind, either express or implied. If you use the contents of this distribution, you do so at your own risk, and you agree to free the author(s) of any consequences arising from such use, either intended or otherwise. BEING NICE TO NICE BEINGS ------------------------- Perl is the creation of Larry Wall . Continuing refinement of Perl is made possible by the unceasing efforts of many fine folk who have banded together with Larry at in endless perlesque banter. If you find perl useful in getting your job done, you may want to drop them or any of the module authors a note of appreciation. Another fine way to encourage development of perl is to become a member of The Perl Institute, a non-profit organization which helps "people help Perl help people" (or something like that). See http://www.perl.org/ for details. If you plan to put this on a CDROM or other similar media, I request that you send me a brief message. Note that some modules explicitly require that you obtain permission from the module author to do that sort of thing, so you should. Altered versions of this distribution must be clearly marked as such. Enjoy! Gurusamy Sarathy (Just Another Perl Porter) gsar@umich.edu 04-AUG-1997