diff options
author | Fred Drake <fdrake@acm.org> | 1998-03-08 06:12:10 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 1998-03-08 06:12:10 (GMT) |
commit | 266b4c1506d8cd40f9f4cb74127ad0d53de904ca (patch) | |
tree | e64795ce1c799bb4bce73515877e54bcac281a70 /Doc/libtraceback.tex | |
parent | c07ae9f4d253423d0f87ee6756ca7dc6f664d622 (diff) | |
download | cpython-266b4c1506d8cd40f9f4cb74127ad0d53de904ca.zip cpython-266b4c1506d8cd40f9f4cb74127ad0d53de904ca.tar.gz cpython-266b4c1506d8cd40f9f4cb74127ad0d53de904ca.tar.bz2 |
Logical markup.
Index entry.
Diffstat (limited to 'Doc/libtraceback.tex')
-rw-r--r-- | Doc/libtraceback.tex | 24 |
1 files changed, 12 insertions, 12 deletions
diff --git a/Doc/libtraceback.tex b/Doc/libtraceback.tex index 2bdd22b..dd4feb1 100644 --- a/Doc/libtraceback.tex +++ b/Doc/libtraceback.tex @@ -2,7 +2,6 @@ \label{module-traceback} \stmodindex{traceback} -\setindexsubitem{(in module traceback)} This module provides a standard interface to format and print stack traces of Python programs. It exactly mimics the behavior of the @@ -13,15 +12,16 @@ you want to print stack traces under program control, e.g. in a The module uses traceback objects --- this is the object type that is stored in the variables \code{sys.exc_traceback} and \code{sys.last_traceback}. +\obindex{traceback} The module defines the following functions: -\begin{funcdesc}{print_tb}{traceback\optional{\, limit}} +\begin{funcdesc}{print_tb}{traceback\optional{, limit}} Print up to \var{limit} stack trace entries from \var{traceback}. If \var{limit} is omitted or \code{None}, all entries are printed. \end{funcdesc} -\begin{funcdesc}{extract_tb}{traceback\optional{\, limit}} +\begin{funcdesc}{extract_tb}{traceback\optional{, limit}} Return a list of up to \var{limit} ``pre-processed'' stack trace entries extracted from \var{traceback}. It is useful for alternate formatting of stack traces. If \var{limit} is omitted or \code{None}, @@ -33,23 +33,23 @@ trailing whitespace stripped; if the source is not available it is \code{None}. \end{funcdesc} -\begin{funcdesc}{print_exception}{type\, value\, traceback\optional{\, limit}} +\begin{funcdesc}{print_exception}{type, value, traceback\optional{, limit}} Print exception information and up to \var{limit} stack trace entries -from \var{traceback}. This differs from \code{print_tb} in the +from \var{traceback}. This differs from \function{print_tb()} in the following ways: (1) if \var{traceback} is not \code{None}, it prints a -header ``\code{Traceback (innermost last):}''; (2) it prints the +header \samp{Traceback (innermost last):}; (2) it prints the exception \var{type} and \var{value} after the stack trace; (3) if -\var{type} is \code{SyntaxError} and \var{value} has the appropriate +\var{type} is \exception{SyntaxError} and \var{value} has the appropriate format, it prints the line where the syntax error occurred with a -caret indication the approximate position of the error. +caret indicating the approximate position of the error. \end{funcdesc} \begin{funcdesc}{print_exc}{\optional{limit}} -This is a shorthand for \code{print_exception(sys.exc_type,} -\code{sys.exc_value,} \code{sys.exc_traceback,} \code{limit)}. +This is a shorthand for `\code{print_exception(sys.exc_type,} +\code{sys.exc_value,} \code{sys.exc_traceback,} \var{limit}\code{)}'. \end{funcdesc} \begin{funcdesc}{print_last}{\optional{limit}} -This is a shorthand for \code{print_exception(sys.last_type,} -\code{sys.last_value,} \code{sys.last_traceback,} \code{limit)}. +This is a shorthand for `\code{print_exception(sys.last_type,} +\code{sys.last_value,} \code{sys.last_traceback,} \var{limit}\code{)}'. \end{funcdesc} |