
You are reading: INSTALL.TXT
----------------------------

** For detailed information on what is included in this release, please      **
** refer to the file 'RELEASE.TXT'.                                          **

Installing the binary-only release of Perl for Win32
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To install the binary version of Perl for Win32, do the following:

(1) Run 'install' from the command line 
	(this is located in \Perl which must be the current directory)

	This script will do the following:

		- Add Perl related entries to the Registry.

		- Create the directory \Perl\bin.
		
		  If this directory already exists, then it will look
		  in there for the file 'perl.exe'.  If the file
                  exists, it will be run to determine its version
                  number and then renamed to 'perl.{version #}.exe'.

		- If it's not already there, it will add '\Perl\bin'
                  to your path. 

	A log of the installation session will be created in the file 
	'\Perl\install.log'.

(2) Copy any of your own scripts or library files into the '\Perl\bin' 
    directory.  

	In the previous step, this directory was added to your path.
        By copying your own scripts into this directory, you should be
        able to run them from any other directory.


Building Perl for Win32 from a source release
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Perl for Win32 has been developed using Microsoft Visual C.
A makefile has been provided to build Perl for Win32 using the SDK as well.
To build Perl for Win32 do the following:

(1) Build executables
    Using Visual C++	
		Start Microsoft Visual C and load 'Perl\exe-src\perl.mak'
		Build both PerlGlob and Perl using the targets predefined for
   	     your platform
		load Perl\dll-src\perl100.mak and build perl100.dll

    Using SDK
        Run 'nmake /f perl.mak "Perl Intel Release" "PerlGlob Intel Release"'
		from the 'Perl\exe-src' directory.
        This will build Perl.exe and PerlGlob.exe

(2) After the build, you should test the Perl binary by running a series of test 
    scripts. This is done by running 'test' in the directory 
    'Perl\ntt'.  It will report upon all functions tested, and 
    any not currently implemented.

(3) Run 'install', located in Perl\ 
    This will copy perl.exe,perlglob.exe and perl100.dll to the Perl\bin directory and 
    perform the rest of the installation process. (see above for more details)

** For detailed information on what is included in this release, please      **
** refer to the file 'RELEASE.TXT'.                                          **
