[Python-checkins] cpython (merge 3.5 -> default): Update PCbuild/readme.txt (merge from 3.5)

Tue Sep 8 08:13:09 CEST 2015

https://hg.python.org/cpython/rev/73258658dc76
changeset: 97774:73258658dc76
parent: 97771:5b31d21c6bb6
parent: 97773:e4a2089ad684
user: Zachary Ware <zachary.ware at gmail.com>
date: Tue Sep 08 01:12:56 2015 -0500
summary:
 Update PCbuild/readme.txt (merge from 3.5)
files:
 PCbuild/readme.txt | 46 ++++-----------------------------
 1 files changed, 6 insertions(+), 40 deletions(-)

diff --git a/PCbuild/readme.txt b/PCbuild/readme.txt
--- a/PCbuild/readme.txt
+++ b/PCbuild/readme.txt
@@ -41,15 +41,14 @@
 used to build standard x86-compatible 32-bit binaries, output into the
 win32 sub-directory. The x64 platform is used for building 64-bit AMD64
 (aka x86_64 or EM64T) binaries, output into the amd64 sub-directory.
-The Itanium (IA-64) platform is no longer supported. See the "Building
-for AMD64" section below for more information about 64-bit builds.
+The Itanium (IA-64) platform is no longer supported.
 
 Four configuration options are supported by the solution:
 Debug
 Used to build Python with extra debugging capabilities, equivalent
 to using ./configure --with-pydebug on UNIX. All binaries built
 using this configuration have "_d" added to their name:
- python35_d.dll, python_d.exe, parser_d.pyd, and so on. Both the
+ python36_d.dll, python_d.exe, parser_d.pyd, and so on. Both the
 build and rt (run test) batch files in this directory accept a -d
 option for debug builds. If you are building Python to help with
 development of CPython, you will most likely use this configuration.
@@ -76,29 +75,7 @@
 
 By default, build.bat will build Python in Release configuration for
 the 32-bit Win32 platform. It accepts several arguments to change
-this behavior:
-
- -c <configuration> Set the configuration (see above)
- -d Shortcut for "-c Debug"
- -p <platform> Set the platform to build for ("Win32" or "x64")
- -r Rebuild instead of just building
- -t <target> Set the target (Build, Rebuild, Clean or CleanAll)
- -e Use get_externals.bat to fetch external sources
- -M Don't build in parallel
- -v Increased output messages
-
-Up to 9 MSBuild switches can also be passed, though they must be passed
-after specifying any of the above switches. For example, use:
-
- build.bat -e -d /fl
-
-to do a debug build with externals fetched as needed and write detailed
-build logs to a file. If the MSBuild switch requires an equal sign
-("="), the entire switch must be quoted:
-
- build.bat -e -d "/p:ExternalsDir=P:\cpython-externals"
-
-There may also be other situations where quotes are necessary.
+this behavior, try `build.bat -h` to learn more.
 
 
 C Runtime
@@ -129,8 +106,6 @@
 .dll and .lib
 python
 .exe
-make_buildinfo, make_versioninfo
- helpers to provide necessary information to the build process
 
 These sub-projects provide extra executables that are useful for running
 CPython in different ways:
@@ -152,9 +127,6 @@
 _freeze_importlib
 _freeze_importlib.exe, used to regenerate Python\importlib.h after
 changes have been made to Lib\importlib\_bootstrap.py
-bdist_wininst
- ..\Lib\distutils\command\wininst-14.0[-amd64].exe, the base
- executable used by the distutils bdist_wininst command
 python3dll
 python3.dll, the PEP 384 Stable ABI dll
 xxlimited
@@ -274,14 +246,8 @@
 find them. This is an advanced topic and not necessarily fully
 supported.
 
-
-Building for AMD64
-------------------
-
-The build process for AMD64 / x64 is very similar to standard builds,
-you just have to set x64 as platform. In addition, the HOST_PYTHON
-environment variable must point to a Python interpreter (at least 2.4),
-to support cross-compilation from Win32.
+The get_externals.bat script is called automatically by build.bat when
+you pass the '-e' option to it.
 
 
 Profile Guided Optimization
@@ -298,7 +264,7 @@
 PGI python, and finally creates the optimized files.
 
 See
- http://msdn.microsoft.com/en-us/library/e7k32f4k(VS.100).aspx
+ http://msdn.microsoft.com/en-us/library/e7k32f4k(VS.140).aspx
 for more on this topic.
 
 
-- 
Repository URL: https://hg.python.org/cpython
