From: Brett Cannon <brett@python.org>
Date: Sat, 25 May 2013 15:32:50 +0000 (-0400)
Subject: Mention __cached__ in the import ref.
X-Git-Tag: v3.4.0a1~580^2~23
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=4b4e38e7d4bd62f2b1cae187ff51428846b720b5;p=python

Mention __cached__ in the import ref.
---

diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst
index 5874606d2e..eb497a10b2 100644
--- a/Doc/reference/import.rst
+++ b/Doc/reference/import.rst
@@ -353,7 +353,11 @@ Loaders must satisfy the following requirements:
  * The loader may set the ``__file__`` attribute of the module.  If set, this
    attribute's value must be a string.  The loader may opt to leave
    ``__file__`` unset if it has no semantic meaning (e.g. a module loaded from
-   a database).
+   a database). If ``__file__`` is set, it may also be appropriate to set the
+   ``__cached__`` attribute which is the path to any compiled version of the
+   code (e.g. byte-compiled file). The file does not need to exist to set this
+   attribute; the path can simply point to whether the compiled file would
+   exist (see :pep:`3147`).
 
  * The loader may set the ``__name__`` attribute of the module.  While not
    required, setting this attribute is highly recommended so that the