traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Added cross-references to related material on exceptions. 

Closes SF bug #217195.

Make sure section numbers wrap together with the preceeding word
("section").
This commit is contained in:
Fred Drake 2002-10-18 15:20:32 +00:00
parent e7097e0b1c
commit 78eb200758
1 changed files with 13 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
Doc/ref/ref7.tex
View File

@ -83,7 +83,7 @@ The \keyword{if} statement is used for conditional execution:
\end{productionlist} \end{productionlist}
It selects exactly one of the suites by evaluating the expressions one It selects exactly one of the suites by evaluating the expressions one
by one until one is found to be true (see section \ref{Booleans} for by one until one is found to be true (see section~\ref{Booleans} for
the definition of true and false); then that suite is executed (and no the definition of true and false); then that suite is executed (and no
other part of the \keyword{if} statement is executed or evaluated). If other part of the \keyword{if} statement is executed or evaluated). If
all expressions are false, the suite of the \keyword{else} clause, if all expressions are false, the suite of the \keyword{else} clause, if
@ -251,7 +251,7 @@ exception are assigned to three variables in the
\module{sys}\refbimodindex{sys} module: \code{sys.exc_type} receives \module{sys}\refbimodindex{sys} module: \code{sys.exc_type} receives
the object identifying the exception; \code{sys.exc_value} receives the object identifying the exception; \code{sys.exc_value} receives
the exception's parameter; \code{sys.exc_traceback} receives a the exception's parameter; \code{sys.exc_traceback} receives a
traceback object\obindex{traceback} (see section \ref{traceback}) traceback object\obindex{traceback} (see section~\ref{traceback})
identifying the point in the program where the exception occurred. identifying the point in the program where the exception occurred.
These details are also available through the \function{sys.exc_info()} These details are also available through the \function{sys.exc_info()}
function, which returns a tuple \code{(\var{exc_type}, \var{exc_value}, function, which returns a tuple \code{(\var{exc_type}, \var{exc_value},
@ -299,13 +299,17 @@ restriction may be lifted in the future).
\stindex{break} \stindex{break}
\stindex{continue} \stindex{continue}
Additional information on exceptions can be found in
section~\ref{exceptions}, and information on using the \keyword{raise}
statement to generate exceptions may be found in section~\ref{raise}.
\section{Function definitions\label{function}} \section{Function definitions\label{function}}
\indexii{function}{definition} \indexii{function}{definition}
\stindex{def} \stindex{def}
A function definition defines a user-defined function object (see A function definition defines a user-defined function object (see
section \ref{types}): section~\ref{types}):
\obindex{user-defined function} \obindex{user-defined function}
\obindex{function} \obindex{function}
@ -368,8 +372,8 @@ def whats_on_the_telly(penguin=None):
return penguin return penguin
\end{verbatim} \end{verbatim}
Function call semantics are described in more detail in section Function call semantics are described in more detail in
\ref{calls}. section~\ref{calls}.
A function call always assigns values to all parameters mentioned in A function call always assigns values to all parameters mentioned in
the parameter list, either from position arguments, from keyword the parameter list, either from position arguments, from keyword
arguments, or from default values. If the form ``\code{*identifier}'' arguments, or from default values. If the form ``\code{*identifier}''
@ -381,7 +385,7 @@ new empty dictionary.
It is also possible to create anonymous functions (functions not bound It is also possible to create anonymous functions (functions not bound
to a name), for immediate use in expressions. This uses lambda forms, to a name), for immediate use in expressions. This uses lambda forms,
described in section \ref{lambda}. Note that the lambda form is described in section~\ref{lambda}. Note that the lambda form is
merely a shorthand for a simplified function definition; a function merely a shorthand for a simplified function definition; a function
defined in a ``\keyword{def}'' statement can be passed around or defined in a ``\keyword{def}'' statement can be passed around or
assigned to another name just like a function defined by a lambda assigned to another name just like a function defined by a lambda
@ -393,14 +397,14 @@ allows the execution of multiple statements.
``\code{def}'' form executed inside a function definition defines a ``\code{def}'' form executed inside a function definition defines a
local function that can be returned or passed around. Free variables local function that can be returned or passed around. Free variables
used in the nested function can access the local variables of the used in the nested function can access the local variables of the
function containing the def. See section \ref{naming} for details. function containing the def. See section~\ref{naming} for details.
\section{Class definitions\label{class}} \section{Class definitions\label{class}}
\indexii{class}{definition} \indexii{class}{definition}
\stindex{class} \stindex{class}
A class definition defines a class object (see section \ref{types}): A class definition defines a class object (see section~\ref{types}):
\obindex{class} \obindex{class}
\begin{productionlist} \begin{productionlist}
@ -416,7 +420,7 @@ A class definition defines a class object (see section \ref{types}):
A class definition is an executable statement. It first evaluates the A class definition is an executable statement. It first evaluates the
inheritance list, if present. Each item in the inheritance list inheritance list, if present. Each item in the inheritance list
should evaluate to a class object. The class's suite is then executed should evaluate to a class object. The class's suite is then executed
in a new execution frame (see section \ref{naming}), using a newly in a new execution frame (see section~\ref{naming}), using a newly
created local namespace and the original global namespace. created local namespace and the original global namespace.
(Usually, the suite contains only function definitions.) When the (Usually, the suite contains only function definitions.) When the
class's suite finishes execution, its execution frame is discarded but class's suite finishes execution, its execution frame is discarded but