From: Julien Palard <julien@palard.fr>
Date: Tue, 13 Apr 2021 16:03:22 +0000 (+0200)
Subject: Doc: Try to enhance wording on circular imports. (GH-24705)
X-Git-Tag: v3.10.0b1~300
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=fd79af7ae2574aaaa829e40ed780e17ef1f9be84;p=thirdparty%2FPython%2Fcpython.git

Doc: Try to enhance wording on circular imports. (GH-24705)
---

diff --git a/Doc/faq/programming.rst b/Doc/faq/programming.rst
index 514ca04ab3c5..ff78ca7320d7 100644
--- a/Doc/faq/programming.rst
+++ b/Doc/faq/programming.rst
@@ -1898,26 +1898,26 @@ How can I have modules that mutually import each other?
 
 Suppose you have the following modules:
 
-foo.py::
+:file:`foo.py`::
 
    from bar import bar_var
    foo_var = 1
 
-bar.py::
+:file:`bar.py`::
 
    from foo import foo_var
    bar_var = 2
 
 The problem is that the interpreter will perform the following steps:
 
-* main imports foo
-* Empty globals for foo are created
-* foo is compiled and starts executing
-* foo imports bar
-* Empty globals for bar are created
-* bar is compiled and starts executing
-* bar imports foo (which is a no-op since there already is a module named foo)
-* bar.foo_var = foo.foo_var
+* main imports ``foo``
+* Empty globals for ``foo`` are created
+* ``foo`` is compiled and starts executing
+* ``foo`` imports ``bar``
+* Empty globals for ``bar`` are created
+* ``bar`` is compiled and starts executing
+* ``bar`` imports ``foo`` (which is a no-op since there already is a module named ``foo``)
+* The import mechanism tries to read ``foo_var`` from ``foo`` globals, to set ``bar.foo_var = foo.foo_var``
 
 The last step fails, because Python isn't done with interpreting ``foo`` yet and
 the global symbol dictionary for ``foo`` is still empty.