From 1ef178c644178304b24bd29c7563ab0529c15f8f Mon Sep 17 00:00:00 2001 From: Lars-Dominik Braun Date: Fri, 16 Feb 2024 09:44:50 +0100 Subject: [PATCH] doc: Document new options for pyproject-build-system. * doc/guix.texi (Build Systems): Add documentation for changed #:configure-flags and new #:backend-path. Change-Id: Ic8be598ea52ae04230b1e61c329ee55ccbb5dd63 --- doc/guix.texi | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index a2915de954..b37d8bae8e 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -9923,6 +9923,18 @@ The API is slightly different from @var{python-build-system}: @item @code{#:use-setuptools?} and @code{#:test-target} is removed. @item +@code{#:configure-flags} is changed. Instead of a list +this option must be a JSON object, whose interpretation +depends on the build backend. For instance the example from +@url{https://peps.python.org/pep-0517/#config-settings,PEP 517} +should be written as @code{'(@@ ("CC" "gcc") ("--global-option" +("--some-global-option")) ("--build-option" ("--build-option1" +"--build-option2")))} +@item +@code{#:backend-path} is added. It defaults to @code{#false}, but when +set to a list it will be appended to Python’s search path and overrides +the definition in @file{pyproject.toml}. +@item @code{#:build-backend} is added. It defaults to @code{#false} and will try to guess the appropriate backend based on @file{pyproject.toml}. @item