We read every piece of feedback, and take your input very seriously.
To see all available qualifiers, see our documentation.
2 parents ad04323 + 6d8be68 commit b461de8Copy full SHA for b461de8
1 file changed
source/specifications/recording-installed-packages.rst
@@ -175,6 +175,15 @@ attempt to uninstall or upgrade the package.
175
(This restriction does not apply to tools that rely on other sources of information,
176
such as system package managers in Linux distros.)
177
178
+.. note::
179
+
180
+ It is *strongly discouraged* for an installed package to modify itself
181
+ (e.g., store cache files under its namespace in ``site-packages``).
182
+ Changes inside ``site-packages`` should be left to specialized installer
183
+ tools such as pip. If a package is nevertheless modified in this way,
184
+ then the ``RECORD`` must be updated, otherwise uninstalling the package
185
+ will leave unlisted files in place (possibly resulting in a zombie
186
+ namespace package).
187
188
The INSTALLER file
189
==================
0 commit comments