[prev in list] [next in list] [prev in thread] [next in thread] 

List:       gentoo-dev
Subject:    [gentoo-dev] [PATCH 2/4] distutils-r1.eclass: Update the desc for PEP517 mode
From:       Michał Górny <mgorny () gentoo ! org>
Date:       2022-02-22 23:30:09
Message-ID: 20220222233011.101456-2-mgorny () gentoo ! org
[Download RAW message or body]

Do not call PEP517 mode "experimental" anymore, and instead describe
the potential problem with it.

Signed-off-by: Michał Górny <mgorny@gentoo.org>
---
 eclass/distutils-r1.eclass | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/eclass/distutils-r1.eclass b/eclass/distutils-r1.eclass
index f0059d2756bf..28e44cd790ef 100644
--- a/eclass/distutils-r1.eclass
+++ b/eclass/distutils-r1.eclass
@@ -82,11 +82,15 @@ esac
 # @PRE_INHERIT
 # @DEFAULT_UNSET
 # @DESCRIPTION:
-# Enable experimental PEP 517 mode for the specified build system.
-# In this mode, the complete build and install is done
-# in python_compile(), venv-style install tree is provided
-# to python_test() and python_install() just merges the temporary
-# install tree into real fs.
+# Enable the PEP 517 mode for the specified build system.  In this mode,
+# the complete build and install is done in python_compile(), venv-style
+# install tree is provided to python_test() and python_install() just
+# merges the temporary install tree into real fs.
+#
+# This mode is recommended for Python packages.  However, some packages
+# using custom hacks on top of distutils/setuptools may not install
+# correctly in this mode.  Please verify the installed file list
+# when using it.
 #
 # The variable specifies the build system used.  Currently,
 # the following values are supported:
-- 
2.35.1


[prev in list] [next in list] [prev in thread] [next in thread]