Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 1 | Building Python using VC++ 6.0 or 5.0 |
Guido van Rossum | a29b360 | 2000-03-29 01:51:37 +0000 | [diff] [blame] | 2 | ------------------------------------- |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 3 | This directory is used to build Python for Win32 platforms, e.g. Windows |
| 4 | 95, 98 and NT. It requires Microsoft Visual C++ 6.x or 5.x. |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 5 | (For other Windows platforms and compilers, see ../PC/readme.txt.) |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 6 | XXX There are still (Python 2.0b1) a few compiler warnings under VC6. |
| 7 | XXX There are likely a few more under VC5. |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 8 | |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 9 | Unlike older versions, there's no longer a need to copy the project files |
| 10 | from a subdirectory of PC/ to the PCbuild directory -- they come in PCbuild. |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 11 | |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 12 | All you need to do is open the workspace "pcbuild.dsw" in MSVC++, select |
| 13 | the Debug or Release setting (using Build -> Set Active Configuration...), |
| 14 | and build the projects. |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 15 | |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 16 | The proper order to build subprojects is: |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 17 | |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 18 | 1) python20 (this builds the main Python DLL and library files, |
| 19 | python20.{dll, lib}) |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 20 | |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 21 | 2) python (this builds the main Python executable, python.exe) |
| 22 | |
| 23 | 3) the other subprojects, as desired or needed (note: you probably don't |
| 24 | want to build most of the other subprojects, unless you're building an |
| 25 | entire Python distribution from scratch, or specifically making changes |
| 26 | to the subsystems they implement; see SUBPROJECTS below) |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 27 | |
| 28 | When using the Debug setting, the output files have a _d added to |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 29 | their name: python20_d.dll, python_d.exe, parser_d.pyd, and so on. |
Guido van Rossum | e79cf32 | 1998-07-07 22:35:03 +0000 | [diff] [blame] | 30 | |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 31 | SUBPROJECTS |
| 32 | ----------- |
Tim Peters | 610a827 | 2000-07-01 02:51:23 +0000 | [diff] [blame] | 33 | These subprojects should build out of the box. Subprojects other than the |
| 34 | main ones (python20, python, pythonw) generally build a DLL (renamed to |
| 35 | .pyd) from a specific module so that users don't have to load the code |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 36 | supporting that module unless they import the module. |
Guido van Rossum | e79cf32 | 1998-07-07 22:35:03 +0000 | [diff] [blame] | 37 | |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 38 | python20 |
| 39 | .dll and .lib |
| 40 | python |
| 41 | .exe |
| 42 | pythonw |
| 43 | pythonw.exe, a variant of python.exe that doesn't pop up a DOS box |
| 44 | _socket |
| 45 | socketmodule.c |
| 46 | _sre |
| 47 | Unicode-aware regular expression engine |
| 48 | mmap |
| 49 | mmapmodule.c |
| 50 | parser |
| 51 | the parser module |
| 52 | select |
| 53 | selectmodule.c |
Guido van Rossum | 74991fa | 2000-07-01 03:46:38 +0000 | [diff] [blame] | 54 | ucnhash, unicodedata |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 55 | large tables of Unicode data |
| 56 | winreg |
| 57 | Windows registry API |
| 58 | winsound |
| 59 | play sounds (typically .wav files) under Windows |
| 60 | |
| 61 | The following subprojects will generally NOT build out of the box. They |
| 62 | wrap code Python doesn't control, and you'll need to download the base |
| 63 | packages first (study the subproject structure from within MSVC to see |
| 64 | where each expects to find the unpacked packages): |
| 65 | |
| 66 | _tkinter |
| 67 | Python wrapper for the Tk windowing system. Requires tcl831.exe from |
Tim Peters | 610a827 | 2000-07-01 02:51:23 +0000 | [diff] [blame] | 68 | http://dev.scriptics.com/software/tcltk/downloadnow83.html |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 69 | |
| 70 | zlib |
| 71 | Python wrapper for the zlib compression library. Requires |
| 72 | http://www.winimage.com/zLibDll/zlib133dll.zip |
| 73 | and |
| 74 | ftp://ftp.uu.net/graphics/png/src/zlib133.zip |
| 75 | |
| 76 | bsddb |
Tim Peters | 610a827 | 2000-07-01 02:51:23 +0000 | [diff] [blame] | 77 | Python wrapper for the BSD database 1.85. Requires db.1.85.win32.zip, |
| 78 | from the "bsd db" link at |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 79 | http://www.nightmare.com/software.html |
| 80 | |
| 81 | pyexpat |
| 82 | Python wrapper for accelerated XML parsing. Requires |
| 83 | ftp://ftp.jclark.com/pub/xml/expat.zip |
| 84 | |
| 85 | |
| 86 | NOTE ON CONFIGURATIONS |
| 87 | ---------------------- |
| 88 | Under Build -> Configuration ..., you'll find several Alpha configurations, |
| 89 | such as "Win32 Alpha Release". These do not refer to alpha versions (as in |
| 90 | alpha, beta, final), but to the DEC/COMPAQ Alpha processor. Ignore them if |
| 91 | you're not building on an Alpha box. |
| 92 | |
| 93 | |
Tim Peters | f9a4a6e | 2000-07-01 20:38:27 +0000 | [diff] [blame] | 94 | YOUR OWN EXTENSION DLLs |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 95 | ----------------------- |
| 96 | If you want to create your own extension module DLL, there's an example |
| 97 | with easy-to-follow instructions in ../PC/example/; read the file |
| 98 | readme.txt there first. |