mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-03 03:22:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

gh-100008: Document Python build requirements (#100009)

Browse source 
Document also configure --without-freelists option added to Python
3.11.
This commit is contained in:
Victor Stinner 2022-12-05 15:41:44 +01:00 • committed by GitHub
parent 038b151963
commit 5ea052bb0c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 47 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

46
Doc/using/configure.rst
View file

@ -2,6 +2,46 @@
Configure Python Configure Python
**************** ****************
Build Requirements
==================
Features 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.
* 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.
* On Windows, Microsoft Visual Studio 2017 or later is required.
.. versionchanged:: 3.11
C11 compiler, IEEE 754 and NaN support are now required.
.. versionchanged:: 3.10
OpenSSL 1.1.1 is now required.
.. versionchanged:: 3.7
Thread support and OpenSSL 1.0.2 are now required.
.. versionchanged:: 3.6
Selected C99 features are now required, like ``<stdint.h>`` and ``static
inline`` functions.
.. versionchanged:: 3.5
On Windows, Visual Studio 2015 or later is required.
See also :pep:`7` "Style Guide for C Code" and :pep:`11` "CPython platform
support".
.. _configure-options: .. _configure-options:
Configure Options Configure Options
@ -93,6 +133,12 @@ General Options
See :envvar:`PYTHONCOERCECLOCALE` and the :pep:`538`. See :envvar:`PYTHONCOERCECLOCALE` and the :pep:`538`.
.. cmdoption:: --without-freelists
Disable all freelists except the empty tuple singleton.
.. versionadded:: 3.11
.. cmdoption:: --with-platlibdir=DIRNAME .. cmdoption:: --with-platlibdir=DIRNAME
Python library directory name (default is ``lib``). Python library directory name (default is ``lib``).

2
Doc/whatsnew/3.11.rst
View file

@ -2131,7 +2131,7 @@ Build Changes
(Contributed by Dong-hee Na and Brett Holman in :issue:`44340`.) (Contributed by Dong-hee Na and Brett Holman in :issue:`44340`.)
* Freelists for object structs can now be disabled. A new :program:`configure` * Freelists for object structs can now be disabled. A new :program:`configure`
option :option:`!--without-freelists` can be used to disable all freelists option :option:`--without-freelists` can be used to disable all freelists
except empty tuple singleton. except empty tuple singleton.
(Contributed by Christian Heimes in :issue:`45522`.) (Contributed by Christian Heimes in :issue:`45522`.)