mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-27 18:59:43 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 13

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

Browse source 
(cherry picked from commit 61f24e7885)

Co-authored-by: Matthias Köppe <mkoeppe@math.ucdavis.edu>
This commit is contained in:
Miss Islington (bot) 2022-06-20 07:14:47 -07:00 • committed by GitHub
parent 96254a9acd
commit e6ad59934e
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

18
Doc/using/configure.rst
View file

@ -748,6 +748,17 @@ Compiler flags
extensions. Use it when a compiler flag should *not* be part of the extensions. Use it when a compiler flag should *not* be part of the
distutils :envvar:`CFLAGS` once Python is installed (:issue:`21121`). 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 .. versionadded:: 3.5
.. envvar:: EXTRA_CFLAGS .. envvar:: EXTRA_CFLAGS
@ -860,6 +871,13 @@ Linker flags
:envvar:`CFLAGS_NODIST`. Use it when a linker flag should *not* be part of :envvar:`CFLAGS_NODIST`. Use it when a linker flag should *not* be part of
the distutils :envvar:`LDFLAGS` once Python is installed (:issue:`35257`). 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 .. envvar:: CONFIGURE_LDFLAGS_NODIST
Value of :envvar:`LDFLAGS_NODIST` variable passed to the ``./configure`` Value of :envvar:`LDFLAGS_NODIST` variable passed to the ``./configure``