Misleading documentation of ! prefix in pdb #104301
Description
The documentation for pdb says:
.. pdbcommand:: ! statement Execute the (one-line) *statement* in the context of the current stack frame. The exclamation point can be omitted unless the first word of the statement resembles a debugger command. To set a global variable, you can prefix the assignment command with a :keyword:`global` statement on the same line, e.g.:: (Pdb) global list_options; list_options = ['-l'] (Pdb) Which suggests that the prefix is used with a space between the ! prefix and the statement to be executed. However, the implementation consumes only the prefix, which means that the natural reading of the docs leads to an IndentationError:
$ python3 test.py --Return-- > /home/snoopjedi/repos/cpython/test.py(3)<module>()->None -> breakpoint() (Pdb) l 1 lst = [1, 2, 3] 2 it = iter(lst) 3 -> breakpoint() [EOF] (Pdb) ! next(it) *** IndentationError: unexpected indent while omitting the space gives the intended result:
(Pdb) !next(it) 1 It would also be helpful to have an example in the documentation that actually uses the prefix for first-word disambiguation as described in the text.