
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 Windows NT Perl 5
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To install the binary version of Windows NT Perl 5, do the following:

(1) Run 'install' from the command line 
	(this is located in \Perl\5.001 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\5.001\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 Windows NT Perl 5 from a source release
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

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

(1) Build executables
    Using Visual C++	
	Start Microsoft Visual C and load 'Perl\5.001\src\perl.mak'
	Build both PerlGlob and Perl using the targets predefined for
        your platform
    Using SDK
        Run 'nmake' from the 'Perl\5.001\src' directory.
        This will build Perl.exe and PerlGlob.exe using 'Perl\5.001\src\makefile'

(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\5.001\src\ntt'.  It will report upon all functions tested, and 
    any not currently implemented.

(3) Run 'install', located in Perl\5.001. 
    This will copy perl.exe and perlglob.exe to the Perl\5.001 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'.                                          **
