Improve the phrasing of in-tree-build deprecation

Context is explained in the following comment: <#7555 (comment)>
pypa · Jul 7, 2021 · d2f2338 · d2f2338
1 parent f37fc4c
commit d2f2338
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 5 deletions.
diff --git a/news/10128.removal.rst b/news/10128.removal.rst
@@ -0,0 +1 @@
+Improve deprecation warning regarding the copying of source trees when installing from a local directory.
diff --git a/src/pip/_internal/operations/prepare.py b/src/pip/_internal/operations/prepare.py
@@ -216,11 +216,12 @@ def unpack_url(
     # be removed.
     if link.is_existing_dir():
         deprecated(
-            "A future pip version will change local packages to be built "
-            "in-place without first copying to a temporary directory. "
-            "We recommend you use --use-feature=in-tree-build to test "
-            "your packages with this new behavior before it becomes the "
-            "default.\n",
+            "pip currently copies the source tree into a temporary directory "
+            "before building it. In the future, pip will build packages in-place "
+            "within the original source tree (\"in-tree build\"). Before the "
+            "default behavior changes, we recommend testing your packages by "
+            "adding the --use-feature=in-tree-build argument. Regarding the "
+            "current out-of-tree default build behavior,\n",
             replacement=None,
             gone_in="21.3",
             issue=7555
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Improve deprecation warning regarding the copying of source trees when installing from a local directory.