From: Furkan Onder <furkantahaonder@gmail.com>
Date: Wed, 9 Jun 2021 21:10:20 +0000 (+0300)
Subject:  bpo-21760: fix __file__ description (GH-19097)
X-Git-Tag: v3.11.0a1~898
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=878d7e4ee464913438fd59582bbb795e7e0fa387;p=thirdparty%2FPython%2Fcpython.git

 bpo-21760: fix __file__ description (GH-19097)
---

diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst
index 2ef5b901b930..81a124f745ab 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 000000000000..119ef3d4c437
--- /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