mirror of
https://github.com/python/cpython.git
synced 2025-08-30 21:48:47 +00:00
Indexing is a mess; try to get the link targets closer to the relevant
text. There needs to be a better way.
This commit is contained in:
parent
4e72e0533d
commit
d51ce7de97
2 changed files with 11 additions and 14 deletions
|
@ -610,7 +610,8 @@ is a shorthand for \code{x.__call__(arguments)}.
|
|||
|
||||
\item[Modules]
|
||||
Modules are imported by the \keyword{import} statement (see
|
||||
section~\ref{import}, ``The \keyword{import} statement'').
|
||||
section~\ref{import}, ``The \keyword{import} statement'').%
|
||||
\stindex{import}\obindex{module}
|
||||
A module object has a namespace implemented by a dictionary object
|
||||
(this is the dictionary referenced by the func_globals attribute of
|
||||
functions defined in the module). Attribute references are translated
|
||||
|
@ -619,8 +620,6 @@ to lookups in this dictionary, e.g., \code{m.x} is equivalent to
|
|||
A module object does not contain the code object used to
|
||||
initialize the module (since it isn't needed once the initialization
|
||||
is done).
|
||||
\stindex{import}
|
||||
\obindex{module}
|
||||
|
||||
Attribute assignment updates the module's namespace dictionary,
|
||||
e.g., \samp{m.x = 1} is equivalent to \samp{m.__dict__["x"] = 1}.
|
||||
|
|
|
@ -660,18 +660,16 @@ given as \code{sys.path}.
|
|||
\indexii{filename}{extension}
|
||||
\indexiii{module}{search}{path}
|
||||
|
||||
If a built-in module is found, its built-in initialization code is
|
||||
executed and step (1) is finished. If no matching file is found,
|
||||
\exception{ImportError} is raised. If a file is found, it is parsed,
|
||||
If a built-in module is found,\indexii{module}{initialization} its
|
||||
built-in initialization code is executed and step (1) is finished. If
|
||||
no matching file is found,
|
||||
\exception{ImportError}\exindex{ImportError} is raised.
|
||||
\index{code block}If a file is found, it is parsed,
|
||||
yielding an executable code block. If a syntax error occurs,
|
||||
\exception{SyntaxError} is raised. Otherwise, an empty module of the given
|
||||
name is created and inserted in the module table, and then the code
|
||||
block is executed in the context of this module. Exceptions during
|
||||
this execution terminate step (1).
|
||||
\indexii{module}{initialization}
|
||||
\exindex{SyntaxError}
|
||||
\exindex{ImportError}
|
||||
\index{code block}
|
||||
\exception{SyntaxError}\exindex{SyntaxError} is raised. Otherwise, an
|
||||
empty module of the given name is created and inserted in the module
|
||||
table, and then the code block is executed in the context of this
|
||||
module. Exceptions during this execution terminate step (1).
|
||||
|
||||
When step (1) finishes without raising an exception, step (2) can
|
||||
begin.
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue