doc: clarify xmode docstring with mode descriptions

Santiago · Carreau · commit f5334ae92fed · 2026-03-19T11:57:26.000+01:00
diff --git a/IPython/core/magics/basic.py b/IPython/core/magics/basic.py
@@ -346,9 +346,19 @@ def xmode(self, parameter_s=''):
 
         Valid modes: Plain, Context, Verbose, Minimal, and Docs.
 
-        If called without arguments, acts as a toggle.
-
-        When in verbose mode the value `--show` (and `--hide`)
+        - ``Plain``: similar to Python's default traceback.
+        - ``Context``: shows several lines of surrounding context for each
+          frame in the traceback.
+        - ``Verbose``: like Context, but also displays local variable values
+          in each frame.
+        - ``Minimal``: shows only the exception type and message, without
+          a traceback.
+        - ``Docs``: a stripped-down version of Verbose, designed for use
+        when running doctests.
+
+        If called without arguments, cycles through the available modes.
+
+        When in verbose mode the value ``--show`` (and ``--hide``)
         will respectively show (or hide) frames with ``__tracebackhide__ =
         True`` value set.
         """
