diff options
author | Fred Drake <fdrake@acm.org> | 1999-02-26 18:51:21 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 1999-02-26 18:51:21 (GMT) |
commit | 43b34da656ffc62914a7e545c5bffc956827adee (patch) | |
tree | b8c92e7a784d4b23b47721d4918b0715d72a3415 | |
parent | 390636382a855cb086627d6300e44313851f9017 (diff) | |
download | cpython-43b34da656ffc62914a7e545c5bffc956827adee.zip cpython-43b34da656ffc62914a7e545c5bffc956827adee.tar.gz cpython-43b34da656ffc62914a7e545c5bffc956827adee.tar.bz2 |
extract_tb(): Only describe this function once. Problem reported by
Jonathan Giddy <jon@dgs.monash.edu.au>.
-rw-r--r-- | Doc/lib/libtraceback.tex | 35 |
1 files changed, 12 insertions, 23 deletions
diff --git a/Doc/lib/libtraceback.tex b/Doc/lib/libtraceback.tex index e2a7e07..735b8de 100644 --- a/Doc/lib/libtraceback.tex +++ b/Doc/lib/libtraceback.tex @@ -28,20 +28,8 @@ If \var{file} is omitted or \code{None}, the output goes to object to receive the output. \end{funcdesc} -\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}, -all entries are extracted. A ``pre-processed'' stack trace entry is a -quadruple (\var{filename}, \var{line number}, \var{function name}, -\var{line text}) representing the information that is usually printed -for a stack trace. The \var{line text} is a string with leading and -trailing whitespace stripped; if the source is not available it is -\code{None}. -\end{funcdesc} - -\begin{funcdesc}{print_exception}{type, value, -traceback\optional{, limit\optional{, file}}} +\begin{funcdesc}{print_exception}{type, value, traceback\optional{, + limit\optional{, file}}} Print exception information and up to \var{limit} stack trace entries from \var{traceback} to \var{file}. This differs from \function{print_tb()} in the @@ -73,15 +61,16 @@ frame to start. The optional \var{limit} and \var{file} arguments have the same meaning as for \function{print_exception()}. \end{funcdesc} -\begin{funcdesc}{extract_tb}{tb\optional{, limit}} -Return a list containing the raw (unformatted) traceback information -extracted from the traceback object \var{tb}. The optional -\var{limit} argument has the same meaning as for -\function{print_exception()}. The items in the returned list are -4-tuples containing the following values: filename, line number, -function name, and source text line. The source text line is stripped -of leading and trailing whitespace; it is \code{None} when the source -text file is unavailable. +\begin{funcdesc}{extract_tb}{traceback\optional{, limit}} +Return a list of up to \var{limit} ``pre-processed'' stack trace +entries extracted from the traceback object \var{traceback}. It is +useful for alternate formatting of stack traces. If \var{limit} is +omitted or \code{None}, all entries are extracted. A +``pre-processed'' stack trace entry is a quadruple (\var{filename}, +\var{line number}, \var{function name}, \var{text}) representing +the information that is usually printed for a stack trace. The +\var{text} is a string with leading and trailing whitespace +stripped; if the source is not available it is \code{None}. \end{funcdesc} \begin{funcdesc}{extract_stack}{\optional{f\optional{, limit}}} |