cpython/PC
Hirokazu Yamamoto 26236880b8 Merged revisions 84763,85135 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r84763 | hirokazu.yamamoto | 2010-09-13 15:21:54 +0900 | 1 line

  Cosmetic fix to project files.
........
  r85135 | hirokazu.yamamoto | 2010-10-01 19:40:49 +0900 | 1 line

  Cosmetic fix for PCBuild/readme.txt.
........
2010-10-08 10:22:55 +00:00
..
VC6 Recorded rollback of revisions 84902 via svnmerge from 2010-09-21 16:25:21 +00:00
VS7.1 Recorded rollback of revisions 84857,84870,84875 via svnmerge from 2010-09-29 08:38:37 +00:00
VS8.0 Merged revisions 84763,85135 via svnmerge from 2010-10-08 10:22:55 +00:00
bdist_wininst Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00
example_nt Set svn:eol-style=CRLF on all Visual Studio solution files. 2009-07-13 19:14:17 +00:00
icons Rest of patch #1490384: Commit icon source, remove 2006-05-28 16:57:38 +00:00
os2emx Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00
os2vacpp Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00
WinMain.c Include <windows.h> after python.h, so that WINNT is properly set before windows.h is included. Fixes warnings in PC builds. 2007-05-26 19:31:39 +00:00
_msi.c Fixup indentation of PC/_msi.c 2010-05-09 15:15:11 +00:00
_subprocess.c Issue #3210: Revert C module changes and apply patch from Hirokazu Yamamoto instead 2010-08-08 11:17:56 +00:00
_winreg.c Move a variable declration outside of a loop to match what was 2010-06-08 21:15:06 +00:00
config.c Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00
dl_nt.c Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00
dllbase_nt.txt Allocate the 0x1D1A0000 base adress for the _ctypes extension module. 2006-04-13 08:33:58 +00:00
empty.c Add main program for icon file. 2004-09-03 13:32:57 +00:00
errmap.h Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00
errmap.mak Change WindowsError to carry the Win32 error code in winerror, 2006-05-11 13:28:43 +00:00
frozen_dllmain.c Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00
generrmap.c Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00
getpathp.c Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00
icons.mak Help compiling icons into an exe, for use with MSI advertisement. 2004-08-13 15:26:40 +00:00
icons.rc Help compiling icons into an exe, for use with MSI advertisement. 2004-08-13 15:26:40 +00:00
import_nt.c Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00
make_versioninfo.c Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00
msvcrtmodule.c Merged revisions 84506 via svnmerge from 2010-09-04 21:24:42 +00:00
py.ico Updated version (win32-icons2.zip) from #1490384. 2006-06-03 07:42:26 +00:00
pyc.ico Updated version (win32-icons2.zip) from #1490384. 2006-06-03 07:42:26 +00:00
pycon.ico Updated version (win32-icons2.zip) from #1490384. 2006-06-03 07:42:26 +00:00
pyconfig.h Issue #7117 (backport py3k float repr) continued: 2009-10-24 13:28:38 +00:00
python.mk
python_exe.rc
python_nt.rc More copyright year and version number bumps 2008-03-01 03:15:20 +00:00
readme.txt Issue #1706: Require Windows 2000+ 2008-02-09 19:55:22 +00:00
testpy.py Remove regsub, reconvert, regex, regex_syntax and everything under lib-old. 2006-03-16 06:50:13 +00:00
w9xpopen.c Try to fix a bunch of compiler warnings on Win64. 2008-03-25 04:18:18 +00:00
winsound.c Untabify C files. Will watch buildbots. 2010-05-09 14:46:46 +00:00

readme.txt

Welcome to the "PC" subdirectory of the Python distribution
***********************************************************

This "PC" subdirectory contains complete project files to make
several older PC ports of Python, as well as all the PC-specific
Python source files.  It should be located in the root of the
Python distribution, and there should be directories "Modules",
"Objects", "Python", etc. in the parent directory of this "PC"
subdirectory.  Be sure to read the documentation in the Python
distribution.

Python requires library files such as string.py to be available in
one or more library directories.  The search path of libraries is
set up when Python starts.  To see the current Python library search
path, start Python and enter "import sys" and "print sys.path".

All PC ports use this scheme to try to set up a module search path:

  1) The script location; the current directory without script.
  2) The PYTHONPATH variable, if set.
  3) For Win32 platforms (NT/95), paths specified in the Registry.
  4) Default directories lib, lib/win, lib/test, lib/tkinter;
     these are searched relative to the environment variable
     PYTHONHOME, if set, or relative to the executable and its
     ancestors, if a landmark file (Lib/string.py) is found ,
     or the current directory (not useful).
  5) The directory containing the executable.

The best installation strategy is to put the Python executable (and
DLL, for Win32 platforms) in some convenient directory such as
C:/python, and copy all library files and subdirectories (using XCOPY)
to C:/python/lib.  Then you don't need to set PYTHONPATH.  Otherwise,
set the environment variable PYTHONPATH to your Python search path.
For example,
   set PYTHONPATH=.;d:\python\lib;d:\python\lib\win;d:\python\lib\dos-8x3

There are several add-in modules to build Python programs which use
the native Windows operating environment.  The ports here just make
"QuickWin" and DOS Python versions which support a character-mode
(console) environment.  Look in www.python.org for Tkinter, PythonWin,
WPY and wxPython.

To make a Python port, start the Integrated Development Environment
(IDE) of your compiler, and read in the native "project file"
(or makefile) provided.  This will enable you to change any source
files or build settings so you can make custom builds.

pyconfig.h    An important configuration file specific to PC's.

config.c    The list of C modules to include in the Python PC
            version.  Manually edit this file to add or
            remove Python modules.

testpy.py   A Python test program.  Run this to test your
            Python port.  It should produce copious output,
	    ending in a report on how many tests were OK, how many
	    failed, and how many were skipped.  Don't worry about
	    skipped tests (these test unavailable optional features).


Additional files and subdirectories for 32-bit Windows
======================================================

python_nt.rc   Resource compiler input for python15.dll.

dl_nt.c, import_nt.c
               Additional sources used for 32-bit Windows features.

getpathp.c     Default sys.path calculations (for all PC platforms).

dllbase_nt.txt A (manually maintained) list of base addresses for
               various DLLs, to avoid run-time relocation.

example_nt     A subdirectory showing how to build an extension as a
               DLL.

Legacy support for older versions of Visual Studio
==================================================
The subdirectories VC6, VS7.1 and VS8.0 contain legacy support older
versions of Microsoft Visual Studio. See PCbuild/readme.txt.

EMX development tools for OS/2
==============================

See os2emx/readme.txt. This platform is maintained by Andrew MacIntyre.

IBM VisualAge C/C++ for OS/2
============================

See os2vacpp/readme.txt.  This platform is supported by Jeff Rush.

NOTE: Support for os2vacpp may be dropped in the near future. Please move
      to EMX.

Note for Windows 3.x and DOS users
==================================

Neither Windows 3.x nor DOS is supported any more.  The last Python
version that supported these was Python 1.5.2; the support files were
present in Python 2.0 but weren't updated, and it is not our intention
to support these platforms for Python 2.x.