Illustrate the form selection modes with screencasts - #4178
Merged
Conversation
The selection rules were written out in prose and tables, which is accurate but hard to picture. Two short screencasts now show them: the three ways to pick a form, evaluated one after another on the same expression, and macroexpansion widening from a bare symbol to the call around it. Both are recorded against a real REPL, so what you see is CIDER's own evaluation overlays and macroexpansion buffer rather than a mock-up.
The option's whole payload is a transient highlight, so prose describing it is doing the reader no favours. The screencast shows the same line evaluated two ways, with the keys on screen, so the difference in what each command picked is visible rather than described.
bbatsov
force-pushed
the
docs-selection-gifs
branch
from
August 30, 2026 06:29
ad03c04 to
46b15e3
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The selection rules landed as prose and tables in #4174, which is accurate but hard to picture. Two short screencasts now show them.
The first runs all three targets over the same expression: kbd:[C-x C-e] with the cursor after
(* 2 3), thencider-eval-sexp-at-pointwith the cursor on it (same result, without moving to the end), then kbd:[C-M-x] from inside the enclosing form.The second shows the macroexpansion wrinkle: the cursor sits on the bare symbol
when, and what gets expanded is the wholewhenform.Both are recorded against a real nREPL connection, so those are CIDER's own evaluation overlays and its real macroexpansion buffer, not a mock-up or a highlight faked for the camera. 32KB and 71KB, in line with the existing
cider-inspector.gif.