[Python-checkins] cpython (2.7): document --with-optimizations in the README for issue26359.
gregory.p.smith
python-checkins at python.org
Thu Sep 8 14:38:06 EDT 2016
https://hg.python.org/cpython/rev/8567bc2876af
changeset: 103336:8567bc2876af
branch: 2.7
parent: 103327:cbf81969aba4
user: Gregory P. Smith <greg at krypto.org> [Google Inc.]
date: Thu Sep 08 18:37:59 2016 +0000
summary:
document --with-optimizations in the README for issue26359.
files:
README | 18 +++++++++++++-----
1 files changed, 13 insertions(+), 5 deletions(-)
diff --git a/README b/README
--- a/README
+++ b/README
@@ -173,10 +173,10 @@
build your desired target. The interpreter executable is built in the
top level directory.
-If you need an optimized version of Python, you type "make profile-opt"
-in the top level directory. This will rebuild the interpreter executable
-using Profile Guided Optimization (PGO). For more details, see the
-section below.
+To get an optimized build of Python, "configure --with-optimizations" before
+you run make. This sets the default make targets up to enable Profile Guided
+Optimization (PGO) and Link Time Optimization (LTO) on most platforms.
+For more details, see the sections bellow.
Once you have built a Python interpreter, see the subsections below on
testing and installation. If you run into trouble, see the next
@@ -194,7 +194,7 @@
---------------------------
PGO takes advantage of recent versions of the GCC or Clang compilers.
-If ran, the "profile-opt" rule will do several steps.
+If ran, "make profile-opt" will do several steps.
First, the entire Python directory is cleaned of temporary files that
may have resulted in a previous compilation.
@@ -214,6 +214,14 @@
that is optimized and suitable for distribution or production installation.
+Link Time Optimization
+----------------------
+
+LTO takes advantages of recent compiler toolchains ability to optimize across
+the otherwise arbitrary .o file boundary when building final executables or
+shared libraries for additional performance gains.
+
+
Troubleshooting
---------------
--
Repository URL: https://hg.python.org/cpython
More information about the Python-checkins
mailing list