summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorAnderson Bravalheri <andersonbravalheri@gmail.com>2023-02-13 20:33:01 +0000
committerAnderson Bravalheri <andersonbravalheri@gmail.com>2023-02-13 20:33:01 +0000
commit925a792d8c7f69500c0169c932df08f73f30f6fe (patch)
treea020d8e42fb57388bed847a7fcf8fdfae2e05f3b /docs
parent52c605573716db3100543be728addf1bce965802 (diff)
parentde2361c389304603f0daf70b0ee0647af0b9e981 (diff)
downloadpython-setuptools-git-925a792d8c7f69500c0169c932df08f73f30f6fe.tar.gz
Add a DeprecationWarning to pkg_resources.declare_namespace (#3434)
Diffstat (limited to 'docs')
-rw-r--r--docs/references/keywords.rst5
1 files changed, 4 insertions, 1 deletions
diff --git a/docs/references/keywords.rst b/docs/references/keywords.rst
index ade147ad..6173e3c2 100644
--- a/docs/references/keywords.rst
+++ b/docs/references/keywords.rst
@@ -390,7 +390,10 @@ extensions).
``namespace_packages``
.. warning::
- ``namespace_packages`` is deprecated in favor of native/implicit
+ The ``namespace_packages`` implementation relies on ``pkg_resources``.
+ However, ``pkg_resources`` has some undesirable behaviours, and
+ Setuptools intends to obviate its usage in the future. Therefore,
+ ``namespace_packages`` was deprecated in favor of native/implicit
namespaces (:pep:`420`). Check :doc:`the Python Packaging User Guide
<PyPUG:guides/packaging-namespace-packages>` for more information.