PC/readme.txt

   1 Welcome to the "PC" subdirectory of the Python distribution\r
   2 ***********************************************************\r
   3 \r
   4 *** Note: the project files for MS VC++ 5.0 and 6.0 are now in the\r
   5 *** PCbuild directory.  See the file readme.txt there for build\r
   6 *** instructions.  There is some information below that might\r
   7 *** still be relevant.\r
   8 \r
   9 This "PC" subdirectory contains complete project files to make\r
  10 several older PC ports of Python, as well as all the PC-specific\r
  11 Python source files.  It should be located in the root of the\r
  12 Python distribution, and there should be directories "Modules",\r
  13 "Objects", "Python", etc. in the parent directory of this "PC"\r
  14 subdirectory.  Be sure to read the documentation in the Python\r
  15 distribution.\r
  16 \r
  17 Python requires library files such as string.py to be available in\r
  18 one or more library directories.  The search path of libraries is\r
  19 set up when Python starts.  To see the current Python library search\r
  20 path, start Python and enter "import sys" and "print sys.path".\r
  21 \r
  22 All PC ports use this scheme to try to set up a module search path:\r
  23 \r
  24   1) The script location; the current directory without script.\r
  25   2) The PYTHONPATH variable, if set.\r
  26   3) For Win32 platforms (NT/95), paths specified in the Registry.\r
  27   4) Default directories lib, lib/win, lib/test, lib/tkinter;\r
  28      these are searched relative to the environment variable\r
  29      PYTHONHOME, if set, or relative to the executable and its\r
  30      ancestors, if a landmark file (Lib/string.py) is found ,\r
  31      or the current directory (not useful).\r
  32   5) The directory containing the executable.\r
  33 \r
  34 The best installation strategy is to put the Python executable (and\r
  35 DLL, for Win32 platforms) in some convenient directory such as\r
  36 C:/python, and copy all library files and subdirectories (using XCOPY)\r
  37 to C:/python/lib.  Then you don't need to set PYTHONPATH.  Otherwise,\r
  38 set the environment variable PYTHONPATH to your Python search path.\r
  39 For example,\r
  40    set PYTHONPATH=.;d:\python\lib;d:\python\lib\win;d:\python\lib\dos-8x3\r
  41 \r
  42 There are several add-in modules to build Python programs which use\r
  43 the native Windows operating environment.  The ports here just make\r
  44 "QuickWin" and DOS Python versions which support a character-mode\r
  45 (console) environment.  Look in www.python.org for Tkinter, PythonWin,\r
  46 WPY and wxPython.\r
  47 \r
  48 To make a Python port, start the Integrated Development Environment\r
  49 (IDE) of your compiler, and read in the native "project file"\r
  50 (or makefile) provided.  This will enable you to change any source\r
  51 files or build settings so you can make custom builds.\r
  52 \r
  53 config.h    An important configuration file specific to PC's.\r
  54 \r
  55 config.c    The list of C modules to include in the Python PC\r
  56             version.  Manually edit this file to add or\r
  57             remove Python modules.\r
  58 \r
  59 testpy.py   A Python test program.  Run this to test your\r
  60             Python port.  It should produce copious output,\r
  61             ending in a report on how many tests were OK, how many\r
  62             failed, and how many were skipped.  Don't worry about\r
  63             skipped tests (these test unavailable optional features).\r
  64 \r
  65 src         A subdirectory used only for VC++ version 1.5 Python\r
  66             source files.  See below.  The other compilers do not\r
  67             use it.  They reference the actual distribution\r
  68             directories instead.\r
  69 \r
  70 \r
  71 Additional files and subdirectories for 32-bit Windows\r
  72 ======================================================\r
  73 \r
  74 python_nt.rc   Resource compiler input for python15.dll.\r
  75 \r
  76 dl_nt.c, import_nt.c\r
  77                Additional sources used for 32-bit Windows features.\r
  78 \r
  79 getpathp.c     Default sys.path calculations (for all PC platforms).\r
  80 \r
  81 dllbase_nt.txt A (manually maintained) list of base addresses for\r
  82                various DLLs, to avoid run-time relocation.\r
  83 \r
  84 example_nt     A subdirectory showing how to build an extension as a\r
  85                DLL.\r
  86 \r
  87 \r
  88 Microsoft Visual C++ Version 1.5 (16-bit Windows)\r
  89 =================================================\r
  90 \r
  91 Since VC++1.5 does not handle long file names, it is necessary\r
  92 to run the "makesrc.exe" program in this directory to copy\r
  93 Python files from the distribution to the directory "src"\r
  94 with shortened names.  Included file names are shortened too.\r
  95 Do this before you attempt to build Python.\r
  96 \r
  97 The "makesrc.exe" program is a native NT program, and you must\r
  98 have NT, Windows 95 or Win32s to run it.  Otherwise you will need\r
  99 to copy distribution files to src yourself.\r
 100 \r
 101 The makefiles are named *.mak and are located in directories\r
 102 starting with "vc15_".  NOTE:  When dependencies are scanned\r
 103 VC++ will create dependencies for directories which are not\r
 104 used because it fails to evaluate "#define" properly.  You\r
 105 must manaully edit makefiles (*.mak) to remove references to\r
 106 "sys/" and other bad directories.\r
 107 \r
 108 vc15_lib    A static Python library.  Create this first because is\r
 109             is required for vc15_w31.\r
 110 \r
 111 vc15_w31    A Windows 3.1x Python QuickWin (console-mode)\r
 112             Python including sockets.  Requires vc15_lib.\r
 113 \r
 114 \r
 115 Watcom C++ Version 10.6\r
 116 =======================\r
 117 \r
 118 The project file for the Watcom compiler is ./python.wpj.\r
 119 It will build Watcom versions in the directories wat_*.\r
 120 \r
 121 wat_dos     A 32-bit extended DOS Python (console-mode) using the\r
 122             dos4gw DOS extender.  Sockets are not included.\r
 123 \r
 124 wat_os2     A 32-bit OS/2 Python (console-mode).\r
 125             Sockets are not included.\r
 126 \r
 127 \r
 128 IBM VisualAge C/C++ for OS/2\r
 129 ============================\r
 130 \r
 131 See os2vacpp/readme.txt.  This platform is supported by Jeff Rush.\r