From b9de2efb14f6d0cb457afeafd9f1d2d550815d3b Mon Sep 17 00:00:00 2001 From: Tibor Takacs Date: Mon, 5 Jun 2023 10:32:52 +0100 Subject: [PATCH 1/3] Refer to PEP-660. --- docs/config.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/config.rst b/docs/config.rst index 4807d8a68..6aa917771 100644 --- a/docs/config.rst +++ b/docs/config.rst @@ -594,8 +594,8 @@ Python run :default: false :version_added: 1.6 - Install the current package in development mode with develop mode. For pip this uses ``-e`` option, so should be - avoided if you've specified a custom :ref:`install_command` that does not support ``-e``. + Install the current package in development mode using `PEP-660 `. This means that the + package will be installed in-place and editable. (Note that this has the same effect as the `pip install -e` command.) .. conf:: :keys: package From 526ba31f788ffc9d4e40cdcb8425b1a2a393405f Mon Sep 17 00:00:00 2001 From: Tibor Takacs Date: Mon, 5 Jun 2023 16:55:53 +0100 Subject: [PATCH 2/3] Add more notes. --- docs/config.rst | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/config.rst b/docs/config.rst index 6aa917771..9b4968c24 100644 --- a/docs/config.rst +++ b/docs/config.rst @@ -595,7 +595,16 @@ Python run :version_added: 1.6 Install the current package in development mode using `PEP-660 `. This means that the - package will be installed in-place and editable. (Note that this has the same effect as the `pip install -e` command.) + package will be installed in-place and editable. + + .. note:: + + `package = editable` is the preferred way to enable development/editable mode. See the details in :ref:`package`. + + .. note:: + + PEP-660 introduced a standardized way of installing a package in development mode, providing the same effect as if + `pip install -e` was used. .. conf:: :keys: package From c46d602fcf22ea2d86f4950f5d8e214e4773fea0 Mon Sep 17 00:00:00 2001 From: Tibor Takacs Date: Mon, 5 Jun 2023 17:39:32 +0100 Subject: [PATCH 3/3] Format fixes. --- docs/config.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/config.rst b/docs/config.rst index 9b4968c24..ecc77450f 100644 --- a/docs/config.rst +++ b/docs/config.rst @@ -594,17 +594,17 @@ Python run :default: false :version_added: 1.6 - Install the current package in development mode using `PEP-660 `. This means that the - package will be installed in-place and editable. + Install the current package in development mode using :pep:`660`. This means that the package will + be installed in-place and editable. .. note:: - `package = editable` is the preferred way to enable development/editable mode. See the details in :ref:`package`. + ``package = editable`` is the preferred way to enable development/editable mode. See the details in :ref:`package`. .. note:: PEP-660 introduced a standardized way of installing a package in development mode, providing the same effect as if - `pip install -e` was used. + ``pip install -e`` was used. .. conf:: :keys: package