From 0ad344a8322a7c69b099e25c203d675a5ea3b60d Mon Sep 17 00:00:00 2001 From: Benjamin Peterson Date: Tue, 15 Jan 2013 16:49:22 -0500 Subject: remove warning about tb circular reference (closes #7340) --- Doc/library/sys.rst | 15 --------------- 1 file changed, 15 deletions(-) diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index 93273c4..6264437 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -215,21 +215,6 @@ always available. a traceback object (see the Reference Manual) which encapsulates the call stack at the point where the exception originally occurred. - .. warning:: - - Assigning the *traceback* return value to a local variable in a function - that is handling an exception will cause a circular reference. Since most - functions don't need access to the traceback, the best solution is to use - something like ``exctype, value = sys.exc_info()[:2]`` to extract only the - exception type and value. If you do need the traceback, make sure to - delete it after use (best done with a :keyword:`try` - ... :keyword:`finally` statement) or to call :func:`exc_info` in a - function that does not itself handle an exception. - - Such cycles are normally automatically reclaimed when garbage collection - is enabled and they become unreachable, but it remains more efficient to - avoid creating cycles. - .. data:: exec_prefix -- cgit v0.12