|
1 Welcome to the "PC" subdirectory of the Python distribution |
|
2 *********************************************************** |
|
3 |
|
4 This "PC" subdirectory contains complete project files to make |
|
5 several older PC ports of Python, as well as all the PC-specific |
|
6 Python source files. It should be located in the root of the |
|
7 Python distribution, and there should be directories "Modules", |
|
8 "Objects", "Python", etc. in the parent directory of this "PC" |
|
9 subdirectory. Be sure to read the documentation in the Python |
|
10 distribution. |
|
11 |
|
12 Python requires library files such as string.py to be available in |
|
13 one or more library directories. The search path of libraries is |
|
14 set up when Python starts. To see the current Python library search |
|
15 path, start Python and enter "import sys" and "print sys.path". |
|
16 |
|
17 All PC ports use this scheme to try to set up a module search path: |
|
18 |
|
19 1) The script location; the current directory without script. |
|
20 2) The PYTHONPATH variable, if set. |
|
21 3) For Win32 platforms (NT/95), paths specified in the Registry. |
|
22 4) Default directories lib, lib/win, lib/test, lib/tkinter; |
|
23 these are searched relative to the environment variable |
|
24 PYTHONHOME, if set, or relative to the executable and its |
|
25 ancestors, if a landmark file (Lib/string.py) is found , |
|
26 or the current directory (not useful). |
|
27 5) The directory containing the executable. |
|
28 |
|
29 The best installation strategy is to put the Python executable (and |
|
30 DLL, for Win32 platforms) in some convenient directory such as |
|
31 C:/python, and copy all library files and subdirectories (using XCOPY) |
|
32 to C:/python/lib. Then you don't need to set PYTHONPATH. Otherwise, |
|
33 set the environment variable PYTHONPATH to your Python search path. |
|
34 For example, |
|
35 set PYTHONPATH=.;d:\python\lib;d:\python\lib\win;d:\python\lib\dos-8x3 |
|
36 |
|
37 There are several add-in modules to build Python programs which use |
|
38 the native Windows operating environment. The ports here just make |
|
39 "QuickWin" and DOS Python versions which support a character-mode |
|
40 (console) environment. Look in www.python.org for Tkinter, PythonWin, |
|
41 WPY and wxPython. |
|
42 |
|
43 To make a Python port, start the Integrated Development Environment |
|
44 (IDE) of your compiler, and read in the native "project file" |
|
45 (or makefile) provided. This will enable you to change any source |
|
46 files or build settings so you can make custom builds. |
|
47 |
|
48 pyconfig.h An important configuration file specific to PC's. |
|
49 |
|
50 config.c The list of C modules to include in the Python PC |
|
51 version. Manually edit this file to add or |
|
52 remove Python modules. |
|
53 |
|
54 testpy.py A Python test program. Run this to test your |
|
55 Python port. It should produce copious output, |
|
56 ending in a report on how many tests were OK, how many |
|
57 failed, and how many were skipped. Don't worry about |
|
58 skipped tests (these test unavailable optional features). |
|
59 |
|
60 |
|
61 Additional files and subdirectories for 32-bit Windows |
|
62 ====================================================== |
|
63 |
|
64 python_nt.rc Resource compiler input for python15.dll. |
|
65 |
|
66 dl_nt.c, import_nt.c |
|
67 Additional sources used for 32-bit Windows features. |
|
68 |
|
69 getpathp.c Default sys.path calculations (for all PC platforms). |
|
70 |
|
71 dllbase_nt.txt A (manually maintained) list of base addresses for |
|
72 various DLLs, to avoid run-time relocation. |
|
73 |
|
74 example_nt A subdirectory showing how to build an extension as a |
|
75 DLL. |
|
76 |
|
77 Legacy support for older versions of Visual Studio |
|
78 ================================================== |
|
79 The subdirectories VC6, VS7.1 and VS8.0 contain legacy support older |
|
80 versions of Microsoft Visual Studio. See PCbuild/readme.txt. |
|
81 |
|
82 EMX development tools for OS/2 |
|
83 ============================== |
|
84 |
|
85 See os2emx/readme.txt. This platform is maintained by Andrew MacIntyre. |
|
86 |
|
87 IBM VisualAge C/C++ for OS/2 |
|
88 ============================ |
|
89 |
|
90 See os2vacpp/readme.txt. This platform is supported by Jeff Rush. |
|
91 |
|
92 NOTE: Support for os2vacpp may be dropped in the near future. Please move |
|
93 to EMX. |
|
94 |
|
95 Note for Windows 3.x and DOS users |
|
96 ================================== |
|
97 |
|
98 Neither Windows 3.x nor DOS is supported any more. The last Python |
|
99 version that supported these was Python 1.5.2; the support files were |
|
100 present in Python 2.0 but weren't updated, and it is not our intention |
|
101 to support these platforms for Python 2.x. |