From 878d7e4ee464913438fd59582bbb795e7e0fa387 Mon Sep 17 00:00:00 2001 From: Furkan Onder Date: Thu, 10 Jun 2021 00:10:20 +0300 Subject: bpo-21760: fix __file__ description (GH-19097) --- Doc/reference/import.rst | 11 ++++++++--- .../Documentation/2020-03-21-01-19-28.bpo-21760.CqofIc.rst | 2 ++ 2 files changed, 10 insertions(+), 3 deletions(-) create mode 100644 Misc/NEWS.d/next/Documentation/2020-03-21-01-19-28.bpo-21760.CqofIc.rst diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst index 2ef5b90..81a124f 100644 --- a/Doc/reference/import.rst +++ b/Doc/reference/import.rst @@ -603,9 +603,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 0000000..119ef3d --- /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 -- cgit v0.12