cpython/PC
Guido van Rossum fb67be2f6b Three patches from issue #1047, by Amaury Forgeot d'Arc:
1/ getargs.diff adds the 'Z' and 'Z#' format specifiers for
PyArg_ParseTuple. They mimic z and z# for unicode strings, by accepting
a Unicode or None (in which case the Py_UNICODE* pointer is set to
NULL). With doc and tests.

2/ subprocess.diff converts file PC/_subprocess.c to unicode. We use the
Unicode version of the win32 api (and Z conversion from previous patch)

3/ stdout.diff: sys.stdout must not convert the line endings, Windows
already does it.
Without this patch, when redirecting the output of python, the file
contains \r\r\n for each line. (test_subprocess did catch this)

However, I (GvR) removed the change to _fileio.c (included in the
patches) that prevents closing file descripors < 3 from being closed;
I think that needs to be solved in a different way.
2007-08-29 18:38:11 +00:00
..
VC6 cPickle was removed 2007-08-24 02:51:04 +00:00
bdist_wininst Four months of trunk changes (including a few releases...) 2006-12-13 04:49:30 +00:00
example_nt Four months of trunk changes (including a few releases...) 2006-12-13 04:49:30 +00:00
icons Partially merge trunk into p3yk. The removal of Mac/Tools is confusing svn 2006-06-08 14:42:34 +00:00
os2emx cPickle was removed 2007-08-24 02:51:04 +00:00
os2vacpp cPickle was removed 2007-08-24 02:51:04 +00:00
WinMain.c Merged revisions 55631-55794 via svnmerge from 2007-06-06 23:52:48 +00:00
_msi.c Merged revisions 56467-56482 via svnmerge from 2007-07-21 17:22:18 +00:00
_subprocess.c Three patches from issue #1047, by Amaury Forgeot d'Arc: 2007-08-29 18:38:11 +00:00
_winreg.c Patch 1030, Adapt _winreg.c to the new buffer API. 2007-08-26 23:07:13 +00:00
config.c Drop cPickle from Windows build process. 2007-07-22 14:48:07 +00:00
dl_nt.c Merged revisions 55631-55794 via svnmerge from 2007-06-06 23:52:48 +00:00
dllbase_nt.txt Merge p3yk branch with the trunk up to revision 45595. This breaks a fair 2006-04-21 10:40:58 +00:00
empty.c Add main program for icon file. 2004-09-03 13:32:57 +00:00
errmap.h Much-needed merge (using svnmerge.py this time) of trunk changes into p3yk. 2006-05-27 19:21:47 +00:00
errmap.mak Much-needed merge (using svnmerge.py this time) of trunk changes into p3yk. 2006-05-27 19:21:47 +00:00
frozen_dllmain.c Remove some debugging messages - although this code is a complete hack, we dont need to announce it to the world every time they use freeze! 2000-10-05 22:10:33 +00:00
generrmap.c Much-needed merge (using svnmerge.py this time) of trunk changes into p3yk. 2006-05-27 19:21:47 +00:00
getpathp.c Merged revisions 53952-54987 via svnmerge from 2007-04-27 19:54:29 +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 Merge ssize_t branch. 2006-02-15 17:27:45 +00:00
make_versioninfo.c Merged revisions 55325-55327 via svnmerge from 2007-05-14 22:51:27 +00:00
msvcrtmodule.c initmsvcrt(): This no longer compiled on Windows, because 2006-01-19 15:21:30 +00:00
py.ico Merge the rest of the trunk. 2006-06-08 15:35:45 +00:00
pyc.ico Merge the rest of the trunk. 2006-06-08 15:35:45 +00:00
pycon.ico Merge the rest of the trunk. 2006-06-08 15:35:45 +00:00
pyconfig.h Merged revisions 56753-56781 via svnmerge from 2007-08-06 23:33:07 +00:00
python.mk Jim A's new versions of these 1998-08-03 20:23:42 +00:00
python_exe.rc Add pretty icon to python.exe 1997-12-05 06:31:40 +00:00
python_nt.rc Merged revisions 53005-53303 via svnmerge from 2007-01-09 23:18:33 +00:00
readme.txt Remove svn:mime-type (inexplicably set to a binary type), 2006-03-01 06:28:58 +00:00
testpy.py Merge p3yk branch with the trunk up to revision 45595. This breaks a fair 2006-04-21 10:40:58 +00:00
w9xpopen.c Fix all wrong instances of "it's". 2005-07-22 21:49:32 +00:00
winsound.c Use unicode 2007-08-25 07:41:59 +00:00

readme.txt

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

*** Note: the project files for MS VC++ 7.1 are now in the
*** PCbuild directory.  See the file readme.txt there for build
*** instructions.  There is some information below that might
*** still be relevant.

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.

Visual Studio 6.0
=================
The subdirectory VC6 contains Visual Studio 6 project files. These
were originally located in the PCBuild directory, but are no longer
maintained.


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

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


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.