From b15cd1d8fee1fe9c253ffaf6a112532fe9a8f092 Mon Sep 17 00:00:00 2001 From: Marcus Hoffmann Date: Wed, 8 Jan 2025 11:51:54 +0100 Subject: [PATCH] docs/manual/adding-packages-python.adoc: clarify how _BUILD_OPTS work PYTHON_FOO_BUILD_OPTS are passed to the build module call of the package build, this allows passing options to the python build *backend* by using the --config-setting= option. setup.py is no longer involved since even the setuptools backend now used the pep517 build method. The note about the options being passed to support/scripts/pyinstaller.py seems to be no longer accurate. Signed-off-by: Marcus Hoffmann [Arnout: also mention -C (suggested by James)] Signed-off-by: Arnout Vandecappelle --- docs/manual/adding-packages-python.adoc | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/manual/adding-packages-python.adoc b/docs/manual/adding-packages-python.adoc index b42c06e54c..d6bae299a0 100644 --- a/docs/manual/adding-packages-python.adoc +++ b/docs/manual/adding-packages-python.adoc @@ -128,10 +128,9 @@ therefore only use a few of them, or none. and +HOST_PKG_PYTHON_PEP517_ENV+ (for flit/pep517 host packages). * +PYTHON_FOO_BUILD_OPTS+, to specify additional options to pass to - the Python +setup.py+ script during the build step, this generally - only makes sense to use for setuptools based packages as flit/pep517 - based packages do not pass these options to a +setup.py+ script but - instead pass them to +support/scripts/pyinstaller.py+. + the Python +python -m build+ call. To pass additional options to the + build backend use the +--config-setting=+ (+-C+) flag of the +build+ + module. * +PYTHON_FOO_INSTALL_TARGET_OPTS+, +PYTHON_FOO_INSTALL_STAGING_OPTS+, +HOST_PYTHON_FOO_INSTALL_OPTS+ to specify additional options to pass