languages/cpython
languages/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython synced 2024-09-05 16:38:56 +00:00
Code Issues Packages Projects Releases Wiki Activity

gh-90539: doc: Expand on what should not go into CFLAGS, LDFLAGS (#92754)

Browse source
This commit is contained in:
Matthias Köppe 2022-06-20 09:58:02 -04:00 committed by GitHub
parent ab0e601016
commit 61f24e7885
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
Doc/using/configure.rst
View file

@ -749,6 +749,17 @@ Compiler flags
extensions. Use it when a compiler flag should *not* be part of the
distutils :envvar:`CFLAGS` once Python is installed (:issue:`21121`).
In particular, :envvar:`CFLAGS` should not contain:
* the compiler flag `-I` (for setting the search path for include files).
The `-I` flags are processed from left to right, and any flags in
:envvar:`CFLAGS` would take precedence over user- and package-supplied `-I`
flags.
* hardening flags such as `-Werror` because distributions cannot control
whether packages installed by users conform to such heightened
standards.
.. versionadded:: 3.5
.. envvar:: EXTRA_CFLAGS
@ -861,6 +872,13 @@ Linker flags
:envvar:`CFLAGS_NODIST`. Use it when a linker flag should *not* be part of
the distutils :envvar:`LDFLAGS` once Python is installed (:issue:`35257`).
In particular, :envvar:`LDFLAGS` should not contain:
* the compiler flag `-L` (for setting the search path for libraries).
The `-L` flags are processed from left to right, and any flags in
:envvar:`LDFLAGS` would take precedence over user- and package-supplied `-L`
flags.
.. envvar:: CONFIGURE_LDFLAGS_NODIST
Value of :envvar:`LDFLAGS_NODIST` variable passed to the ``./configure``