Message 339250 - Python tracker

Message339250

Author	malin
Recipients	brett.cannon, ezio.melotti, malin, michael.foord, rhettinger, serhiy.storchaka
Date	2019-03-31.08:30:58
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1554021059.01.0.64169415875.issue36485@roundup.psfhosted.org>
In-reply-to

Content
I suggest the documentation be written in more detail. For example, in __clearcache__'s section, state explicitly that this magic function is for module-level cache, and it will be invoked by sys.clear_caches(). Maybe also introduce the background: some caches may grow unlimitedly, sys.clear_caches() gives the user a chance to empty them.

Content

I suggest the documentation be written in more detail.

For example, in __clearcache__'s section, state explicitly that this magic function is for module-level cache, and it will be invoked by sys.clear_caches().

Maybe also introduce the background: some caches may grow unlimitedly, sys.clear_caches() gives the user a chance to empty them.

History
Date	User	Action	Args
2019-03-31 08:30:59	malin	set	recipients: + malin, brett.cannon, rhettinger, ezio.melotti, michael.foord, serhiy.storchaka
2019-03-31 08:30:59	malin	set	messageid: <1554021059.01.0.64169415875.issue36485@roundup.psfhosted.org>
2019-03-31 08:30:59	malin	link	issue36485 messages
2019-03-31 08:30:58	malin	create