Improve documentation for IPython.core.debugger and IPython.terminal.debugger

The documentation for IPython.core.debugger states that it is deprecated but it doesn’t provide any information about what should be used instead. A few questions:

• Was IPython.core.debugger deprecated in favour of IPython.terminal.debugger?
• If so, what should be used in jupyter notebooks (IPython.terminal.debugger.set_trace() doesn’t appear to work when used in a notebook)?

[tillahoffmann]

I now use the following in my own code to set (conditional) breakpoints.

from IPython.core.debugger import Pdb as CorePdb
import sys


def breakpoint(condition=True):
    """
    Set a breakpoint at the location the function is called if `condition == True`.
    """
    if condition:
        debugger = CorePdb()
        frame = sys._getframe()
        debugger.set_trace(frame.f_back)
        return debugger


def add(a, b):
    c = a + b
    breakpoint(a + b == 3)
    return c

add(1, 2)

[Carreau]

I would go with set_trace() for consistency with perminal and PDB itself.