summaryrefslogtreecommitdiffstats
path: root/Doc/using/configure.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/using/configure.rst')
-rw-r--r--Doc/using/configure.rst23
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