diff options
| author | Jason R. Coombs <jaraco@jaraco.com> | 2013-08-07 07:02:53 -0400 |
|---|---|---|
| committer | Jason R. Coombs <jaraco@jaraco.com> | 2013-08-07 07:02:53 -0400 |
| commit | 06123063b78bab12b523f5d6f09125f7282504ec (patch) | |
| tree | 528af72e6a4cc13b9a3a175e3d45c73290d9b491 /docs/setuptools.txt | |
| parent | 244412f118232255578bb99afee7cd22872a9839 (diff) | |
| download | external_python_setuptools-06123063b78bab12b523f5d6f09125f7282504ec.tar.gz external_python_setuptools-06123063b78bab12b523f5d6f09125f7282504ec.tar.bz2 external_python_setuptools-06123063b78bab12b523f5d6f09125f7282504ec.zip | |
Update transitional note to reflect that the change never took place.
Diffstat (limited to 'docs/setuptools.txt')
| -rw-r--r-- | docs/setuptools.txt | 17 |
1 files changed, 9 insertions, 8 deletions
diff --git a/docs/setuptools.txt b/docs/setuptools.txt index 235a85b5..7bc307e0 100644 --- a/docs/setuptools.txt +++ b/docs/setuptools.txt @@ -1378,20 +1378,21 @@ other copies will ever be loaded!) TRANSITIONAL NOTE ~~~~~~~~~~~~~~~~~ -Setuptools 0.6a automatically calls ``declare_namespace()`` for you at runtime, -but the 0.7a versions will *not*. This is because the automatic declaration +Setuptools automatically calls ``declare_namespace()`` for you at runtime, +but future versions may *not*. This is because the automatic declaration feature has some negative side effects, such as needing to import all namespace packages during the initialization of the ``pkg_resources`` runtime, and also the need for ``pkg_resources`` to be explicitly imported before any namespace -packages work at all. Beginning with the 0.7a releases, you'll be responsible +packages work at all. In some future releases, you'll be responsible for including your own declaration lines, and the automatic declaration feature will be dropped to get rid of the negative side effects. -During the remainder of the 0.6 development cycle, therefore, setuptools will -warn you about missing ``declare_namespace()`` calls in your ``__init__.py`` -files, and you should correct these as soon as possible before setuptools 0.7a1 -is released. Namespace packages without declaration lines will not work -correctly once a user has upgraded to setuptools 0.7a1, so it's important that +During the remainder of the current development cycle, therefore, setuptools +will warn you about missing ``declare_namespace()`` calls in your +``__init__.py`` files, and you should correct these as soon as possible +before the compatibility support is removed. +Namespace packages without declaration lines will not work +correctly once a user has upgraded to a later version, so it's important that you make this change now in order to avoid having your code break in the field. Our apologies for the inconvenience, and thank you for your patience. |
