cpython/Doc/using
Gregory Szorc 5360cb3d56
gh-101282: Apply BOLT optimizations to libpython for shared builds (#104709)
Apply BOLT optimizations to libpython for shared builds. Most of the C
code is in libpython so it is critical to apply BOLT there fully realize
BOLT benefits.

This change also reworks how BOLT instrumentation is applied. It
effectively removes the readelf based logic added in gh-101525 and
replaces it with a mechanism that saves a copy of the pre-bolt binary
and restores that copy when necessary. This allows us to perform BOLT
optimizations without having to manually delete the output binary to
force a new bolt run.

Also:
- add a clean-bolt target for purging BOLT files and hook that up to the
  clean target
- .gitignore BOLT related files

Before and after this refactor, `make` will no-op after a previous run.
Both versions should also share common make DAG deficiencies where
targets fail to trigger as often as they need to or can trigger
prematurely in certain scenarios. e.g. after this change you may need to
`rm profile-bolt-stamp` to force a BOLT run because there aren't
appropriate non-phony targets for BOLT's make target to depend on.

To make it easier to iterate on custom BOLT settings, the flags to pass
to instrumentation and application are now defined in configure and can
be overridden by passing BOLT_INSTRUMENT_FLAGS and BOLT_APPLY_FLAGS.
2023-05-22 13:45:20 +02:00
..
cmdline.rst GH-103484: Fix redirected permanently URLs (#104001) 2023-05-02 09:34:44 +03:00
configure.rst gh-101282: Apply BOLT optimizations to libpython for shared builds (#104709) 2023-05-22 13:45:20 +02:00
editors.rst bpo-37610: improve Using Python doc wrt Editors & IDE (GH-14850) 2019-07-18 18:23:17 -07:00
index.rst bpo-43774: Document configure options (GH-25283) 2021-04-08 22:32:21 +02:00
mac.rst Replace "OS X" with "macOS" (#104653) 2023-05-20 01:25:52 -07:00
unix.rst DOC: remove reference to OpenSolaris (#102671) 2023-04-25 10:45:18 +00:00
venv-create.inc gh-95299: Stop installing setuptools as a part of ensurepip and venv (#101039) 2023-04-17 23:43:34 -05:00
win_installer.png Optimize images by IMGbot (GH-21348) 2022-02-04 15:49:43 +09:00
windows.rst GH-103484: Fix redirected permanently URLs (#104001) 2023-05-02 09:34:44 +03:00