summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorVictor Stinner <vstinner@python.org>2023-08-30 13:28:58 (GMT)
committerGitHub <noreply@github.com>2023-08-30 13:28:58 (GMT)
commite012cf771b8d4f114bd8dbdabf10d1584764541d (patch)
tree24aad55218b41d1dcea3d8340baefc74432b4b8e
parentc7cef546319c51defa01236469b636b6978b99ab (diff)
downloadcpython-e012cf771b8d4f114bd8dbdabf10d1584764541d.zip
cpython-e012cf771b8d4f114bd8dbdabf10d1584764541d.tar.gz
cpython-e012cf771b8d4f114bd8dbdabf10d1584764541d.tar.bz2
Document Python build requirements (#108646)
Co-authored-by: Erlend E. Aasland <erlend@python.org> Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
-rw-r--r--Doc/using/configure.rst27
-rw-r--r--Doc/whatsnew/3.13.rst2
2 files changed, 23 insertions, 6 deletions
diff --git a/Doc/using/configure.rst b/Doc/using/configure.rst
index 6279b0e..a16a4af 100644
--- a/Doc/using/configure.rst
+++ b/Doc/using/configure.rst
@@ -5,29 +5,42 @@ Configure Python
Build Requirements
==================
-Features required to build CPython:
+Features and minimum versions required to build CPython:
* A `C11 <https://en.cppreference.com/w/c/11>`_ compiler. `Optional C11
features
<https://en.wikipedia.org/wiki/C11_(C_standard_revision)#Optional_features>`_
are not required.
+* On Windows, Microsoft Visual Studio 2017 or later is required.
+
* Support for `IEEE 754 <https://en.wikipedia.org/wiki/IEEE_754>`_ floating
point numbers and `floating point Not-a-Number (NaN)
<https://en.wikipedia.org/wiki/NaN#Floating_point>`_.
* Support for threads.
-* OpenSSL 1.1.1 or newer for the :mod:`ssl` and :mod:`hashlib` modules.
+* OpenSSL 1.1.1 is the minimum version and OpenSSL 3.0.9 is the recommended
+ minimum version for the :mod:`ssl` and :mod:`hashlib` extension modules.
-* On Windows, Microsoft Visual Studio 2017 or later is required.
+* SQLite 3.15.2 for the :mod:`sqlite3` extension module.
+
+* Tcl/Tk 8.5.12 for the :mod:`tkinter` module.
+
+* Autoconf 2.71 and aclocal 1.16.4 are required to regenerate the
+ :file:`configure` script.
+
+.. versionchanged:: 3.13:
+ Autoconf 2.71, aclocal 1.16.4 and SQLite 3.15.2 are now required.
.. versionchanged:: 3.11
C11 compiler, IEEE 754 and NaN support are now required.
On Windows, Visual Studio 2017 or later is required.
+ Tcl/Tk version 8.5.12 is now required for the :mod:`tkinter` module.
.. versionchanged:: 3.10
OpenSSL 1.1.1 is now required.
+ Require SQLite 3.7.15.
.. versionchanged:: 3.7
Thread support and OpenSSL 1.0.2 are now required.
@@ -37,7 +50,11 @@ Features required to build CPython:
inline`` functions.
.. versionchanged:: 3.5
- On Windows, Visual Studio 2015 or later is required.
+ On Windows, Visual Studio 2015 or later is now required.
+ Tcl/Tk version 8.4 is now required.
+
+.. versionchanged:: 3.1
+ Tcl/Tk version 8.3.1 is now required.
See also :pep:`7` "Style Guide for C Code" and :pep:`11` "CPython platform
support".
@@ -48,7 +65,7 @@ support".
Configure Options
=================
-List all ``./configure`` script options using::
+List all :file:`configure` script options using::
./configure --help
diff --git a/Doc/whatsnew/3.13.rst b/Doc/whatsnew/3.13.rst
index be5bf9a..298d5fb 100644
--- a/Doc/whatsnew/3.13.rst
+++ b/Doc/whatsnew/3.13.rst
@@ -822,7 +822,7 @@ Build Changes
=============
* Autoconf 2.71 and aclocal 1.16.4 is now required to regenerate
- :file:`!configure`.
+ the :file:`configure` script.
(Contributed by Christian Heimes in :gh:`89886`.)
* SQLite 3.15.2 or newer is required to build the :mod:`sqlite3` extension module.