Skip to content

doc: clarify xmode docstring with mode descriptions#15157

Open
msanti14 wants to merge 1 commit intoipython:mainfrom
msanti14:doc/clarify-xmode-docstring
Open

doc: clarify xmode docstring with mode descriptions#15157
msanti14 wants to merge 1 commit intoipython:mainfrom
msanti14:doc/clarify-xmode-docstring

Conversation

@msanti14
Copy link

Summary

Closes #13981

The %xmode magic docstring listed valid modes but did not describe
what each mode does. This PR adds a brief description for each mode
and clarifies that calling %xmode without arguments cycles through
modes rather than just toggling.

Changes

  • Added description for each mode: Plain, Context, Verbose, Minimal, Docs
  • Corrected "acts as a toggle" to "cycles through the available modes"
  • Kept existing note about --show/--hide in Verbose mode

AI Usage

Copilot was used to draft the docstring. All suggestions were reviewed,
tested, and corrected where inaccurate (specifically the Docs mode description).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Tracebacks are excessively verbose.

1 participant