PC/readme.txt

   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.