X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.win32;h=4d7e2c9e773077772bbf96b4e0d6fa9a30aea8bc;hb=802134916c56985ba8dc700565240474646eb9f7;hp=25f1408f56b394cff1c4e8e82d57f48f3a5014c1;hpb=dbd54a9fbfac3f28d61d88bb1989ab115b43773d;p=p5sagit%2Fp5-mst-13.2.git diff --git a/README.win32 b/README.win32 index 25f1408..4d7e2c9 100644 --- a/README.win32 +++ b/README.win32 @@ -42,16 +42,21 @@ system). Currently, this port is capable of using one of the following compilers on the Intel x86 architecture: Borland C++ version 5.02 or later - Microsoft Visual C++ version 4.2 or later + Microsoft Visual C++ version 2.0 through 7.0 (and possibly later) MinGW with gcc gcc version 2.95.2 or later The last of these is a high quality freeware compiler. Use version 3.2.x or later for the best results with this compiler. -The Microsoft Visual C++ compiler is also now being given away free in -the "Visual C++ Toolkit 2003", and also as part of the ".NET Framework -SDK". This is the same compiler that ships with "Visual Studio .NET 2003 -Professional". +The Borland C++ and Microsoft Visual C++ compilers are also now being given +away free. The Borland compiler is available as "Borland C++ Compiler Free +Command Line Tools" and is the same compiler that ships with the full +"Borland C++ Builder" product. The Microsoft compiler is available as +"Visual C++ Toolkit 2003" or "Visual C++ 2005 Express Edition" (and also as +part of the ".NET Framework SDK") and is the same compiler that ships with +"Visual C++ .NET 2003 Professional" or "Visual C++ 2005 Professional" +respectively. Currently, Perl cannot be compiled with Visual C++ 2005 (aka +Visual C++ 8.x). This port can also be built on the Intel IA64 using: @@ -131,10 +136,54 @@ and edit win32/config.vc to change "make=nmake" into "make=dmake". The latter step is only essential if you want to use dmake as your default make for building extensions using MakeMaker. +=item Microsoft Visual C++ 2005 Express Edition + +B + +This free version of Visual C++ 2005 Professional contains the same compiler +and linker that ship with the full version, but doesn't contain everything +necessary to build Perl. + +You will also need to download the "Platform SDK" (the "Core SDK" and "MDAC +SDK" components are required) for more header files and libraries. + +These packages can both be downloaded by searching in the Download Center at +http://www.microsoft.com/downloads/search.aspx?displaylang=en. (Providing exact +links to these packages has proven a pointless task because the links keep on +changing so often.) + +Try to obtain the latest version of the Platform SDK. Sometimes these packages +contain a particular Windows OS version in their name, but actually work on +other OS versions too. For example, the "Windows Server 2003 R2 Platform SDK" +also runs on Windows XP SP2 and Windows 2000. + +According to the download pages these packages are only supported on Windows +2000/XP/2003, so trying to use these tools on Windows 95/98/ME and even Windows +NT probably won't work. + +Install Visual C++ 2005 first, then the Platform SDK. Setup your environment +as follows (assuming default installation locations were chosen): + + SET PATH=%SystemRoot%\system32;%SystemRoot%;C:\Program Files\Microsoft Visual Studio 8\Common7\IDE;C:\Program Files\Microsoft Visual Studio 8\VC\BIN;C:\Program Files\Microsoft Visual Studio 8\Common7\Tools;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\bin;C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727;C:\Program Files\Microsoft Visual Studio 8\VC\VCPackages;C:\Program Files\Microsoft Platform SDK\Bin + + SET INCLUDE=C:\Program Files\Microsoft Visual Studio 8\VC\INCLUDE;C:\Program Files\Microsoft Platform SDK\include + + SET LIB=C:\Program Files\Microsoft Visual Studio 8\VC\LIB;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\lib;C:\Program Files\Microsoft Platform SDK\lib + + SET LIBPATH=C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727 + +Perl should now build using the win32/Makefile. You will need to edit that +file to set + + CCTYPE = MSVC80FREE + +and to set CCHOME, CCINCDIR and CCLIBDIR as per the environment setup above. + =item Microsoft Visual C++ Toolkit 2003 This free toolkit contains the same compiler and linker that ship with -Visual Studio .NET 2003 Professional, but doesn't contain everything +Visual C++ .NET 2003 Professional, but doesn't contain everything necessary to build Perl. You will also need to download the "Platform SDK" (the "Core SDK" and "MDAC @@ -145,29 +194,27 @@ Framework Redistributable" to be installed first. This can be downloaded and installed separately, but is included in the "Visual C++ Toolkit 2003" anyway. These packages can all be downloaded by searching in the Download Center at -http://www.microsoft.com/downloads/search.aspx?displaylang=en +http://www.microsoft.com/downloads/search.aspx?displaylang=en. (Providing exact +links to these packages has proven a pointless task because the links keep on +changing so often.) -The Platform SDK packages can also be obtained from the Platform SDK Update -site: http://www.microsoft.com/msdownload/platformsdk/sdkupdate Note that this -site requires Internet Explorer 5.0 or later to function, but the site's home -page currently gives links to two download pages for users of other browsers: +Try to obtain the latest version of the Platform SDK. Sometimes these packages +contain a particular Windows OS version in their name, but actually work on +other OS versions too. For example, the "Windows Server 2003 R2 Platform SDK" +also runs on Windows XP SP2 and Windows 2000. -For Windows XP Service Pack 2: -http://www.microsoft.com/msdownload/platformsdk/sdkupdate/XPSP2FULLInstall.htm - -For Windows Server 2003: -http://www.microsoft.com/msdownload/platformsdk/sdkupdate/psdk-full.htm - -According to the download pages the Toolkit and the .NET Framework SDK are only -supported on Windows 2000/XP/2003, so trying to use these tools on Windows -95/98/ME and even Windows NT probably won't work. +According to the download pages these packages are only supported on Windows +2000/XP/2003, so trying to use these tools on Windows 95/98/ME and even Windows +NT probably won't work. Install the Toolkit first, then the Platform SDK, then the .NET Framework SDK. Setup your environment as follows (assuming default installation locations were chosen): SET PATH=%SystemRoot%\system32;%SystemRoot%;C:\Program Files\Microsoft Visual C++ Toolkit 2003\bin;C:\Program Files\Microsoft SDK\Bin;C:\Program Files\Microsoft.NET\SDK\v1.1\Bin + SET INCLUDE=C:\Program Files\Microsoft Visual C++ Toolkit 2003\include;C:\Program Files\Microsoft SDK\include;C:\Program Files\Microsoft Visual Studio .NET 2003\Vc7\include + SET LIB=C:\Program Files\Microsoft Visual C++ Toolkit 2003\lib;C:\Program Files\Microsoft SDK\lib;C:\Program Files\Microsoft Visual Studio .NET 2003\Vc7\lib Several required files will still be missing: @@ -225,11 +272,11 @@ from win32/Makefile and setargv.obj won't be required anyway. =back Perl should now build using the win32/Makefile. You will need to edit that -file to comment-out CCTYPE = MSVC60 (since that enables delay-loading of the -Winsock DLL which the free toolkit does not support) and to set CCHOME, -CCINCDIR and CCLIBDIR as per the environment setup above. You may also want to -change both mentions of the compiler's "-Gf" switch to "-GF" since the former -is deprecated in VC7 and will be removed from future versions. +file to set + + CCTYPE = MSVC70FREE + +and to set CCHOME, CCINCDIR and CCLIBDIR as per the environment setup above. =item Microsoft Platform SDK 64-bit Compiler @@ -319,10 +366,9 @@ The default value for CCHOME in the makefiles for Visual C++ may not be correct for some versions. Make sure the default exists and is valid. -You may also need to comment out a line C in the -makefile, in case you're using an older version of the Visual C++ compiler -(e.g. 6.0 without service packs) and if the linker reports an internal -error. +You may also need to comment out the C line in the +Makefile if you're using VC++ 6.0 without the latest service pack and +the linker reports an internal error. If you have either the source or a library that contains des_fcrypt(), enable the appropriate option in the makefile. A ready-to-use version @@ -672,13 +718,12 @@ To ensure smooth transitioning of existing code that uses the ActiveState port, there is a bundle of Win32 extensions that contains all of the ActiveState extensions and several other Win32 extensions from CPAN in source form, along with many added bugfixes, and with MakeMaker -support. This bundle is available at: +support. The latest version of this bundle is available at: - http://www.cpan.org/modules/by-module/Win32/libwin32-0.191.zip + http://search.cpan.org/dist/libwin32/ See the README in that distribution for building and installation -instructions. Look for later versions that may be available at the -same location. +instructions. =item Notes on 64-bit Windows @@ -911,6 +956,6 @@ Win9x support was added in 5.6 (Benjamin Stuhl). Support for 64-bit Windows added in 5.8 (ActiveState Corp). -Last updated: 7 June 2005 +Last updated: 30 September 2005 =cut