summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
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.