cpython/PC
Victor Stinner 331a6a56e9
bpo-36763: Implement the PEP 587 (GH-13592)
* Add a whole new documentation page:
  "Python Initialization Configuration"
* PyWideStringList_Append() return type is now PyStatus,
  instead of int
* PyInterpreterState_New() now calls PyConfig_Clear() if
  PyConfig_InitPythonConfig() fails.
* Rename files:

  * Python/coreconfig.c => Python/initconfig.c
  * Include/cpython/coreconfig.h => Include/cpython/initconfig.h
  * Include/internal/: pycore_coreconfig.h => pycore_initconfig.h

* Rename structures

  * _PyCoreConfig => PyConfig
  * _PyPreConfig => PyPreConfig
  * _PyInitError => PyStatus
  * _PyWstrList => PyWideStringList

* Rename PyConfig fields:

  * use_module_search_paths => module_search_paths_set
  * module_search_path_env => pythonpath_env

* Rename PyStatus field: _func => func
* PyInterpreterState: rename core_config field to config
* Rename macros and functions:

  * _PyCoreConfig_SetArgv() => PyConfig_SetBytesArgv()
  * _PyCoreConfig_SetWideArgv() => PyConfig_SetArgv()
  * _PyCoreConfig_DecodeLocale() => PyConfig_SetBytesString()
  * _PyInitError_Failed() => PyStatus_Exception()
  * _Py_INIT_ERROR_TYPE_xxx enums => _PyStatus_TYPE_xxx
  * _Py_UnixMain() => Py_BytesMain()
  * _Py_ExitInitError() => Py_ExitStatusException()
  * _Py_PreInitializeFromArgs() => Py_PreInitializeFromBytesArgs()
  * _Py_PreInitializeFromWideArgs() => Py_PreInitializeFromArgs()
  * _Py_PreInitialize() => Py_PreInitialize()
  * _Py_RunMain() => Py_RunMain()
  * _Py_InitializeFromConfig() => Py_InitializeFromConfig()
  * _Py_INIT_XXX() => _PyStatus_XXX()
  * _Py_INIT_FAILED() => _PyStatus_EXCEPTION()

* Rename 'err' PyStatus variables to 'status'
* Convert RUN_CODE() macro to config_run_code() static inline function
* Remove functions:

  * _Py_InitializeFromArgs()
  * _Py_InitializeFromWideArgs()
  * _PyInterpreterState_GetCoreConfig()
2019-05-27 16:39:22 +02:00
..
bdist_wininst bpo-35920: Windows 10 ARM32 platform support (GH-11774) 2019-04-25 18:36:45 +00:00
clinic bpo-36127: Argument Clinic: inline parsing code for keyword parameters. (GH-12058) 2019-03-14 10:32:22 +02:00
icons bpo-34977: Add Windows App Store package (GH-11027) 2018-12-10 18:52:57 -08:00
layout bpo-36649: Remove trailing spaces for registry keys when installed via the Store (GH-12865) 2019-04-17 14:31:32 -07:00
WinMain.c
_msi.c bpo-36140: Fix an incorrect check in msidb_getsummaryinformation() (GH-12074) 2019-03-07 10:20:13 -08:00
_testconsole.c bpo-31462: Remove trailing whitespaces. (#3564) 2017-09-14 09:38:36 +03:00
classicAppCompat.can.xml bpo-34977: Add Windows App Store package (GH-11027) 2018-12-10 18:52:57 -08:00
classicAppCompat.cat bpo-34977: Add Windows App Store package (GH-11027) 2018-12-10 18:52:57 -08:00
classicAppCompat.sccd bpo-34977: Add Windows App Store package (GH-11027) 2018-12-10 18:52:57 -08:00
config.c bpo-34691: Compile _contextvars module into main Python library (GH-11741) 2019-02-02 14:36:23 -08:00
dl_nt.c Fixes sys.winver generation and removes dependency on user32.dll 2015-01-15 09:10:16 -08:00
empty.c
errmap.h
errmap.mak
frozen_dllmain.c
generrmap.c
getpathp.c bpo-36763: Implement the PEP 587 (GH-13592) 2019-05-27 16:39:22 +02:00
invalid_parameter_handler.c Issue #23524: Replace _PyVerify_fd function with calls to _set_thread_local_invalid_parameter_handler. 2015-04-12 00:26:27 -04:00
launcher.c bpo-36540: PEP 570 -- Implementation (GH-12701) 2019-04-29 13:36:57 +01:00
msvcrtmodule.c bpo-31462: Remove trailing whitespaces. (#3564) 2017-09-14 09:38:36 +03:00
pyconfig.h bpo-36942 Windows build changes for Windows ARM64 (GH-13366) 2019-05-17 10:08:55 -07:00
pylauncher.rc bpo-34977: Add Windows App Store package (GH-11027) 2018-12-10 18:52:57 -08:00
pyshellext.cpp bpo-34770: Fix a possible null pointer dereference in pyshellext.cpp (GH-9497) 2018-09-24 21:25:23 -07:00
pyshellext.def Issue #27469: Adds a shell extension to the launcher so that drag and drop works correctly. 2016-07-16 16:17:33 -07:00
pyshellext.idl Issue #27469: Adds a shell extension to the launcher so that drag and drop works correctly. 2016-07-16 16:17:33 -07:00
pyshellext.rc Issue #27469: Adds a shell extension to the launcher so that drag and drop works correctly. 2016-07-16 16:17:33 -07:00
pyshellext_d.def Issue #27469: Adds a shell extension to the launcher so that drag and drop works correctly. 2016-07-16 16:17:33 -07:00
python.manifest bpo-30731: python.manifest fix (#2328) 2017-07-13 21:34:42 +02:00
python3.def bpo-35224: PEP 572 Implementation (#10497) 2019-01-24 16:49:56 -07:00
python3dll.c
python_exe.rc Issue #27756: Adds new icons for Python files and processes on Windows. Designs by Cherry Wang. 2016-09-05 14:05:17 -07:00
python_nt.rc 2016 will be another year of writing copyrighted code 2016-01-01 10:23:45 -06:00
python_uwp.cpp bpo-34977: Remove unused preprocessor definition (GH-11092) 2018-12-10 20:56:09 -08:00
python_ver_rc.h Closes #26624: Adds validation of ucrtbase[d].dll version with warning for old versions. 2016-04-12 20:11:25 -07:00
pythonw_exe.rc Issue #27756: Adds new icons for Python files and processes on Windows. Designs by Cherry Wang. 2016-09-05 14:05:17 -07:00
readme.txt Issue #25022: Merge with 3.4 2015-09-10 15:02:14 -05:00
sqlite3.rc Adds version info to all signed binaries on Windows. 2016-04-06 12:35:24 -07:00
store_info.txt bpo-34977: Add Windows App Store package (GH-11027) 2018-12-10 18:52:57 -08:00
testpy.py Cleanup regrtest "main()" function 2016-03-24 17:53:20 +01:00
validate_ucrtbase.py Issue #27705: Update message in validate_ucrtbase.py 2016-09-09 18:21:15 -07:00
winreg.c bpo-36672: Fix a compiler warning in winreg.SetValue() (GH-12882) 2019-04-22 10:08:05 -07:00
winsound.c Fix miscellaneous typos (#4275) 2017-11-05 15:37:50 +02: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
               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.


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.