From: Adam Johnson <me@adamj.eu>
Date: Fri, 10 Jan 2025 15:54:45 +0000 (+0000)
Subject: gh-128409: Document that pdb.post_mortem() accepts exceptions (#128410)
X-Git-Tag: v3.14.0a4~41
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=1b39b502d33c68f52fd775c4e6c2174baddd40bd;p=thirdparty%2FPython%2Fcpython.git

gh-128409: Document that pdb.post_mortem() accepts exceptions (#128410)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
---

diff --git a/Doc/library/pdb.rst b/Doc/library/pdb.rst
index 6c099b22b38c..f9d1213fb6d2 100644
--- a/Doc/library/pdb.rst
+++ b/Doc/library/pdb.rst
@@ -179,13 +179,15 @@ slightly different way:
    .. versionadded:: 3.14
       The *commands* argument.
 
-.. function:: post_mortem(traceback=None)
+.. function:: post_mortem(t=None)
 
-   Enter post-mortem debugging of the given *traceback* object.  If no
-   *traceback* is given, it uses the one of the exception that is currently
-   being handled (an exception must be being handled if the default is to be
-   used).
+   Enter post-mortem debugging of the given exception or
+   :ref:`traceback object <traceback-objects>`. If no value is given, it uses
+   the exception that is currently being handled, or raises ``ValueError`` if
+   there isn’t one.
 
+   .. versionchanged:: 3.13
+      Support for exception objects was added.
 
 .. function:: pm()