diff options
| author | Victor Stinner <vstinner@python.org> | 2023-09-08 13:19:20 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-09-08 13:19:20 (GMT) |
| commit | de0202e937ead659d97f0b243fda3db48720c79f (patch) | |
| tree | 5ab44ed23a8a0d172b4ab2250b9bcebcfe66bcac /Doc | |
| parent | 55d7e8fef135a0ce69b0ed19c8b06a4fb04934d1 (diff) | |
| download | cpython-de0202e937ead659d97f0b243fda3db48720c79f.zip cpython-de0202e937ead659d97f0b243fda3db48720c79f.tar.gz cpython-de0202e937ead659d97f0b243fda3db48720c79f.tar.bz2 | |
[3.12] gh-108740: Fix "make regen-all" race condition (#108741) (#109019)
gh-108740: Fix "make regen-all" race condition (#108741)
Fix a race condition in "make regen-all". The deepfreeze.c source and
files generated by Argument Clinic are now generated or updated
before generating "global objects". Previously, some identifiers may
miss depending on the order in which these files were generated.
* "make regen-global-objects": Make sure that deepfreeze.c is
generated and up to date, and always run "make clinic".
* "make clinic" no longer runs generate_global_objects.py script.
* "make regen-deepfreeze" now only updates deepfreeze.c (C file).
It doesn't build deepfreeze.o (object) anymore.
* Remove misleading messages in "make regen-global-objects" and
"make clinic". They are now outdated, these commands are now
safe to use.
* Document generates files in Doc/using/configure.rst.
Co-authored-by: Erlend E. Aasland <erlend@python.org>
(cherry picked from commit db1ee6a19ab62191c16ecb732cb4dcaede98a902)
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/using/configure.rst | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/Doc/using/configure.rst b/Doc/using/configure.rst index 791d3ad..0052000 100644 --- a/Doc/using/configure.rst +++ b/Doc/using/configure.rst @@ -43,6 +43,29 @@ See also :pep:`7` "Style Guide for C Code" and :pep:`11` "CPython platform support". +Generated files +=============== + +To reduce build dependencies, Python source code contains multiple generated +files. Commands to regenerate all generated files:: + + make regen-all + make regen-stdlib-module-names + make regen-limited-abi + make regen-configure + +The ``Makefile.pre.in`` file documents generated files, their inputs, and tools used +to regenerate them. Search for ``regen-*`` make targets. + +The ``make regen-configure`` command runs `tiran/cpython_autoconf +<https://github.com/tiran/cpython_autoconf>`_ container for reproducible build; +see container ``entry.sh`` script. The container is optional, the following +command can be run locally, the generated files depend on autoconf and aclocal +versions:: + + autoreconf -ivf -Werror + + .. _configure-options: Configure Options |