blob: 082669900de7a4a7f03ef21b33478e99af5d6c14 [file] [log] [blame]
Guido van Rossumae1b5b22000-06-30 13:00:32 +00001Welcome to the "PC" subdirectory of the Python distribution
2***********************************************************
Guido van Rossum082d2891997-05-16 16:24:09 +00003
Guido van Rossum1bb77342000-11-13 17:24:13 +00004*** Note: the project files for MS VC++ 6.0 are now in the
Guido van Rossuma0e6be71999-04-12 14:49:01 +00005*** PCbuild directory. See the file readme.txt there for build
6*** instructions. There is some information below that might
7*** still be relevant.
Guido van Rossum082d2891997-05-16 16:24:09 +00008
9This "PC" subdirectory contains complete project files to make
Guido van Rossuma0e6be71999-04-12 14:49:01 +000010several older PC ports of Python, as well as all the PC-specific
Guido van Rossum082d2891997-05-16 16:24:09 +000011Python source files. It should be located in the root of the
12Python distribution, and there should be directories "Modules",
13"Objects", "Python", etc. in the parent directory of this "PC"
Guido van Rossum1aa7e3a1997-05-19 14:16:21 +000014subdirectory. Be sure to read the documentation in the Python
15distribution.
Guido van Rossum082d2891997-05-16 16:24:09 +000016
Guido van Rossum1aa7e3a1997-05-19 14:16:21 +000017Python requires library files such as string.py to be available in
18one or more library directories. The search path of libraries is
19set up when Python starts. To see the current Python library search
20path, start Python and enter "import sys" and "print sys.path".
21
Guido van Rossum831c2581997-08-14 22:57:33 +000022All PC ports use this scheme to try to set up a module search path:
Guido van Rossum1aa7e3a1997-05-19 14:16:21 +000023
Guido van Rossum831c2581997-08-14 22:57:33 +000024 1) The script location; the current directory without script.
25 2) The PYTHONPATH variable, if set.
26 3) For Win32 platforms (NT/95), paths specified in the Registry.
27 4) Default directories lib, lib/win, lib/test, lib/tkinter;
28 these are searched relative to the environment variable
29 PYTHONHOME, if set, or relative to the executable and its
30 ancestors, if a landmark file (Lib/string.py) is found ,
31 or the current directory (not useful).
32 5) The directory containing the executable.
33
34The best installation strategy is to put the Python executable (and
35DLL, for Win32 platforms) in some convenient directory such as
36C:/python, and copy all library files and subdirectories (using XCOPY)
37to C:/python/lib. Then you don't need to set PYTHONPATH. Otherwise,
38set the environment variable PYTHONPATH to your Python search path.
39For example,
Guido van Rossumffeb59381997-12-17 21:27:23 +000040 set PYTHONPATH=.;d:\python\lib;d:\python\lib\win;d:\python\lib\dos-8x3
Guido van Rossum1aa7e3a1997-05-19 14:16:21 +000041
Guido van Rossum082d2891997-05-16 16:24:09 +000042There are several add-in modules to build Python programs which use
43the native Windows operating environment. The ports here just make
44"QuickWin" and DOS Python versions which support a character-mode
45(console) environment. Look in www.python.org for Tkinter, PythonWin,
46WPY and wxPython.
47
48To make a Python port, start the Integrated Development Environment
49(IDE) of your compiler, and read in the native "project file"
50(or makefile) provided. This will enable you to change any source
51files or build settings so you can make custom builds.
52
Tim Peters76f373d2001-07-26 21:34:59 +000053pyconfig.h An important configuration file specific to PC's.
Guido van Rossum082d2891997-05-16 16:24:09 +000054
55config.c The list of C modules to include in the Python PC
56 version. Manually edit this file to add or
57 remove Python modules.
58
59testpy.py A Python test program. Run this to test your
Guido van Rossum831c2581997-08-14 22:57:33 +000060 Python port. It should produce copious output,
61 ending in a report on how many tests were OK, how many
62 failed, and how many were skipped. Don't worry about
63 skipped tests (these test unavailable optional features).
Guido van Rossum082d2891997-05-16 16:24:09 +000064
Guido van Rossum082d2891997-05-16 16:24:09 +000065
Guido van Rossum082d2891997-05-16 16:24:09 +000066Additional files and subdirectories for 32-bit Windows
67======================================================
68
Guido van Rossume34b7de1997-05-19 20:01:57 +000069python_nt.rc Resource compiler input for python15.dll.
Guido van Rossum082d2891997-05-16 16:24:09 +000070
Guido van Rossum831c2581997-08-14 22:57:33 +000071dl_nt.c, import_nt.c
Guido van Rossum082d2891997-05-16 16:24:09 +000072 Additional sources used for 32-bit Windows features.
73
Guido van Rossum831c2581997-08-14 22:57:33 +000074getpathp.c Default sys.path calculations (for all PC platforms).
Guido van Rossum082d2891997-05-16 16:24:09 +000075
76dllbase_nt.txt A (manually maintained) list of base addresses for
77 various DLLs, to avoid run-time relocation.
78
Guido van Rossum082d2891997-05-16 16:24:09 +000079example_nt A subdirectory showing how to build an extension as a
80 DLL.
81
Guido van Rossum082d2891997-05-16 16:24:09 +000082
Guido van Rossum0ba48ba1997-11-22 21:58:14 +000083IBM VisualAge C/C++ for OS/2
84============================
85
Guido van Rossumcee1dca1997-12-05 22:06:23 +000086See os2vacpp/readme.txt. This platform is supported by Jeff Rush.
Guido van Rossum1bb77342000-11-13 17:24:13 +000087
88
89Note for Windows 3.x and DOS users
90==================================
91
92Neither Windows 3.x nor DOS is supported any more. The last Python
93version that supported these was Python 1.5.2; the support files were
94present in Python 2.0 but weren't updated, and it is not our intention
95to support these platforms for Python 2.x.