Document the "jump" command in pdb.__doc__, and add a version tag for "until X".

diff --git a/Doc/library/pdb.rst b/Doc/library/pdb.rst
index 7f44c089fcb261fd4c5eb8276bdae03be57ba7b5..4e79badd3c0f3c7c995d19bf3515ffedfa45574d 100644 (file)
--- a/Doc/library/pdb.rst
+++ b/Doc/library/pdb.rst
@@ -339,6 +339,9 @@ by the local file.
    equal to that is reached.  In both cases, also stop when the current frame
    returns.
 
+   .. versionchanged:: 3.2
+      Allow giving an explicit line number.
+
 .. pdbcommand:: r(eturn)
 
    Continue execution until the current function returns.

diff --git a/Lib/pdb.py b/Lib/pdb.py
index 7c6b84854ca0538e5ec46a1166612c71c0a69c93..cedd17ed71209eb84bf90dede4e36638147d765a 100755 (executable)
--- a/Lib/pdb.py
+++ b/Lib/pdb.py
@@ -147,6 +147,16 @@ unt(il) [lineno]
         or equal to that is reached.  In both cases, also stop when
         the current frame returns.
 
+j(ump) lineno
+        Set the next line that will be executed.  Only available in
+        the bottom-most frame.  This lets you jump back and execute
+        code again, or jump forward to skip code that you don't want
+        to run.
+
+        It should be noted that not all jumps are allowed -- for
+        instance it is not possible to jump into the middle of a
+        for loop or out of a finally clause.
+
 r(eturn)
         Continue execution until the current function returns.