@@ -157,10 +157,16 @@ the `native namespace package example project`_.
157157Legacy namespace packages
158158-------------------------
159159
160+ .. warning ::
161+
162+ The information in this section is obsolete and is no longer functional
163+ (as of Setuptools 82.0.0). It is only retained for historical reference.
164+
165+ ``pkg_resources `` has been deprecated and was fully removed in Setuptools 82.0.0.
166+
160167These two methods, that were used to create namespace packages prior to :pep: `420 `,
161168are now considered to be obsolete and should not be used unless you need compatibility
162- with packages already using this method. Also, ``pkg_resources `` has been deprecated
163- (and is fully removed in setuptools 82.0.0).
169+ with packages already using this method.
164170
165171To migrate an existing package, all packages sharing the namespace must be migrated simultaneously.
166172
@@ -216,7 +222,7 @@ in the `pkgutil namespace example project`_.
216222pkg_resources-style namespace packages
217223^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
218224
219- :doc: `Setuptools <setuptools:index >` provides the `pkg_resources.declare_namespace `_ function and
225+ :doc: `Setuptools <setuptools:index >` previously provided the `` pkg_resources.declare_namespace `` function and
220226the ``namespace_packages `` argument to :func: `~setuptools.setup `. Together
221227these can be used to declare namespace packages. While this approach is no
222228longer recommended, it is widely present in most existing namespace packages.
@@ -285,7 +291,5 @@ to :func:`~setuptools.setup` in :file:`setup.py`. For example:
285291 A complete working example of two pkg_resources-style namespace packages can be found
286292in the `pkg_resources namespace example project `_.
287293
288- .. _pkg_resources.declare_namespace :
289- https://setuptools.readthedocs.io/en/latest/pkg_resources.html#namespace-package-support
290294.. _pkg_resources namespace example project :
291295 https://github.com/pypa/sample-namespace-packages/tree/master/pkg_resources
0 commit comments