diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst index 4c36e15dc06063..8f06cee29782d7 100644 --- a/Doc/reference/import.rst +++ b/Doc/reference/import.rst @@ -596,9 +596,14 @@ the module. .. attribute:: __file__ .. attribute:: __cached__ - ``__file__`` is optional. If set, this attribute's value must be a - string. The import system may opt to leave ``__file__`` unset if it - has no semantic meaning (e.g. a module loaded from a database). + ``__file__`` is optional (if set, value must be a string). It indicates + the pathname of the file from which the module was loaded (if + loaded from a file), or the pathname of the shared libray file + for extension modules loaded dynamically from a shared library. + It might be missing for certain types of modules, such as C + modules that are statically linked into the interpreter, and the + import system may opt to leave it unset if it has no semantic + meaning (e.g. a module loaded from 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 diff --git a/Misc/NEWS.d/next/Documentation/2020-03-21-01-19-28.bpo-21760.CqofIc.rst b/Misc/NEWS.d/next/Documentation/2020-03-21-01-19-28.bpo-21760.CqofIc.rst new file mode 100644 index 00000000000000..119ef3d4c4378e --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2020-03-21-01-19-28.bpo-21760.CqofIc.rst @@ -0,0 +1,2 @@ +The description for __file__ fixed. +Patch by Furkan Onder \ No newline at end of file