Skip to content

Fix kernel hang when calling doc() or open()#282

Merged
blink1073 merged 2 commits into
Calysto:mainfrom
blink1073:fix-184
Mar 13, 2026
Merged

Fix kernel hang when calling doc() or open()#282
blink1073 merged 2 commits into
Calysto:mainfrom
blink1073:fix-184

Conversation

@blink1073
Copy link
Copy Markdown
Contributor

@blink1073 blink1073 commented Mar 13, 2026

Summary

Closes #184

  • Adds @doc/doc.m override: redirects doc <topic> to help <topic>, displaying documentation inline instead of launching a GUI browser
  • Adds @open/open.m override: redirects open <fname> to display the file path via which(), instead of launching an editor
  • Adds regression tests with a 10s timeout that catch the hang via queue.Empty

Test plan

  • just test-kernel passes (new test_doc_does_not_hang and test_open_does_not_hang tests)
  • Manually verify doc disp and open disp return output inline in a Jupyter notebook without hanging

Override doc() and open() with inline alternatives that prevent the
kernel from hanging in a headless environment. doc() now displays help
text via help(), and open() displays the file path via which(). Adds
regression tests with a timeout to detect the hang.
@blink1073 blink1073 merged commit b05bf36 into Calysto:main Mar 13, 2026
23 checks passed
@blink1073 blink1073 deleted the fix-184 branch March 13, 2026 09:57
@blink1073 blink1073 mentioned this pull request Mar 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Calling open or doc causes kernel to hang

1 participant