From: Tian Gao <gaogaotiantian@hotmail.com>
Date: Sat, 8 Feb 2025 02:02:46 +0000 (-0500)
Subject: gh-124703: Add documentation and whatsnew entry for pdb exit change (#129818)
X-Git-Tag: v3.14.0a5~54
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d3b60fff584d65dd5487bac056e4c0ad7ebc43b4;p=thirdparty%2FPython%2Fcpython.git

gh-124703: Add documentation and whatsnew entry for pdb exit change (#129818)
---

diff --git a/Doc/library/pdb.rst b/Doc/library/pdb.rst
index f9d1213fb6d2..bdd89d127491 100644
--- a/Doc/library/pdb.rst
+++ b/Doc/library/pdb.rst
@@ -697,6 +697,17 @@ can be overridden by the local file.
 .. pdbcommand:: q(uit)
 
    Quit from the debugger.  The program being executed is aborted.
+   An end-of-file input is equivalent to :pdbcmd:`quit`.
+
+   A confirmation prompt will be shown if the debugger is invoked in
+   ``'inline'`` mode. Either ``y``, ``Y``, ``<Enter>`` or ``EOF``
+   will confirm the quit.
+
+   .. versionchanged:: 3.14
+      A confirmation prompt will be shown if the debugger is invoked in
+      ``'inline'`` mode. After the confirmation, the debugger will call
+      :func:`sys.exit` immediately, instead of raising :exc:`bdb.BdbQuit`
+      in the next trace event.
 
 .. pdbcommand:: debug code
 
diff --git a/Doc/whatsnew/3.14.rst b/Doc/whatsnew/3.14.rst
index 0f119d10819d..9ac0e6ed2a6d 100644
--- a/Doc/whatsnew/3.14.rst
+++ b/Doc/whatsnew/3.14.rst
@@ -641,6 +641,11 @@ pdb
   command when :mod:`pdb` is in ``inline`` mode.
   (Contributed by Tian Gao in :gh:`123757`.)
 
+* A confirmation prompt will be shown when the user tries to quit :mod:`pdb`
+  in ``inline`` mode. ``y``, ``Y``, ``<Enter>`` or ``EOF`` will confirm
+  the quit and call :func:`sys.exit`, instead of raising :exc:`bdb.BdbQuit`.
+  (Contributed by Tian Gao in :gh:`124704`.)
+
 
 pickle
 ------