diff options
Diffstat (limited to 'README.win32')
| -rw-r--r-- | README.win32 | 54 |
1 files changed, 47 insertions, 7 deletions
diff --git a/README.win32 b/README.win32 index 8f1ff1bcf0..fe5d85ab07 100644 --- a/README.win32 +++ b/README.win32 @@ -49,7 +49,7 @@ compilers that can generally be used to build Win32 applications. This port currently supports MakeMaker (the set of modules that is used to build extensions to perl). Therefore, you should be able to build and install most extensions found in the CPAN sites. -See the L<Usage Hints> section for general hints about this. +See L<Usage Hints> below for general hints about this. =head2 Setting Up @@ -59,8 +59,9 @@ See the L<Usage Hints> section for general hints about this. Use the default "cmd" shell that comes with NT. In particular, do *not* use the 4DOS/NT shell. The Makefile has commands that are not -compatible with that shell. You are mostly on your own if you can -muster the temerity to attempt this with Windows95. +compatible with that shell. The Makefile also has known +incompatibilites with the default shell that comes with Windows95, +so building under Windows95 should be considered "unsupported". =item * @@ -98,10 +99,22 @@ versions of NMAKE that come with Visual C++ ver. 2.0 and above. Edit the Makefile and change the values of INST_DRV and INST_TOP if you want perl to be installed in a location other than "C:\PERL". +If you want to build a perl capable of running on the Windows95 +platform, you will have to uncomment the line that sets "RUNTIME=-MT". +(The default settings use the Microsoft-recommended -MD option for +compiling, which uses the DLL version of the C RunTime Library. There +currently exists a bug in the Microsoft CRTL that causes failure of +the socket calls only on the Windows95 platform. This bug cannot be +worked around if the DLL version of the CRTL is used, which is why you +need to enable the -MT flag.) Perl compiled with -MT can be used on +both Windows NT and Windows95. + +If you are using Visual C++ ver. 2.0, uncomment the line that +sets "CCTYPE=MSVC20". + =item * -If you are using Visual C++ ver. 4.0 and above: type "nmake". -If you are using a Visual C++ ver. 2.0: type "nmake CCTYPE=MSVC20". +Type "nmake". This should build everything. Specifically, it will create perl.exe, perl.dll, and perlglob.exe at the perl toplevel, and various other @@ -221,7 +234,7 @@ This pipes "foo" to the pager and writes "bar" in the file "blurch": perl -e "print 'foo'; print STDERR 'bar'" 2> blurch | less -Discovering the usage of the "command.com" shell on Windows 95 +Discovering the usage of the "command.com" shell on Windows95 is left as an exercise to the reader :) =item Building Extensions @@ -253,6 +266,33 @@ it looks like the extension building support is at fault, report that with full details of how the build failed using the perlbug utility. +=item Win32 Specific Extensions + +A number of extensions specific to the Win32 platform are available +from CPAN. You may find that many of these extensions are meant to +be used under the Activeware port of Perl, which used to be the only +native port for the Win32 platform. Since the Activeware port does not +have adequate support for Perl's extension building tools, these +extensions typically do not support those tools either, and therefore +cannot be built using the generic steps shown in the previous section. + +To ensure smooth transitioning of existing code that uses the +Activeware port, there is a bundle of Win32 extensions that contains +all of the Activeware extensions and most other Win32 extensions from +CPAN in source form, along with many added bugfixes, and with MakeMaker +support. This bundle is available at: + + http://www.perl.com/CPAN/authors/id/GSAR/libwin32-0.06.tar.gz + +See the README in that distribution for building and installation +instructions. Look for later versions that may be available at the +same location. + +It is expected that authors of Win32 specific extensions will begin +distributing their work in MakeMaker compatible form subsequent to +the 5.004 release of perl, at which point the need for a dedicated +bundle such as the above should diminish. + =item Miscellaneous Things A full set of HTML documentation is installed, so you should be @@ -379,6 +419,6 @@ at the time. Nick Ing-Simmons and Gurusamy Sarathy have made numerous and sundry hacks since then. -Last updated: 13 April 1997 +Last updated: 15 May 1997 =cut |