summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-09-28 16:43:59 -0300
committerGabriel Schneider <[email protected]>2026-10-01 00:12:15 -0300
commit71c5b400ced873cddd77497b7a9fd06184954813 (patch)
tree76e0d64e9e73f55aa1eea5a357c3cc2c8345a253 /docs
parent78daa25e5c99cc0d71da36b6e0dcdd362b0cb284 (diff)
downloadpardes-71c5b400ced873cddd77497b7a9fd06184954813.tar.gz
pardes-71c5b400ced873cddd77497b7a9fd06184954813.zip
Z arms the view keys until Esc, and zm puts the cursor's column mid-view
Z is helix's sticky view mode: the z keys stay armed after each until Esc, which leaves the mode and does nothing else (no pane hop). zm is align_view_middle: an unwrapped view scrolls sideways so the cursor's column is in its middle. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs')
-rw-r--r--docs/helix-keys.md7
1 files changed, 4 insertions, 3 deletions
diff --git a/docs/helix-keys.md b/docs/helix-keys.md
index c0ffe0d7..8ee81930 100644
--- a/docs/helix-keys.md
+++ b/docs/helix-keys.md
@@ -110,6 +110,8 @@ language-backend queries, and the shell pipe.
| `Ctrl-b` | file panes: full page up. Terminal panes: **toggle raw tty/editor mode** (`opts.tty_toggle`, configurable; `Shift-Esc` also enters). In raw tty Shift-Esc goes to the child | tty toggle is pardes-specific and wins on terminals; harness `pane:"tty"` cases avoid `Ctrl-b` | helix-verified (file) / pardes-specific (tty) |
| `PageUp` / `PageDown` | full page | matches helix `page_up`/`page_down` (view scroll + cursor snap to the scrolloff edge) | helix-verified |
| `zt` / `zz` / `zb` | scroll current line to top / center / bottom | matches `align_view_top/center/bottom` (helix harness pins scrolloff to pardes' 3) | helix-verified |
+| `Z` | sticky view mode: the `z` keys stay armed after each until Esc, which only leaves the mode; other keys do nothing meanwhile | helix's sticky view node | helix-verified |
+| `zm` | scroll the unwrapped view so the cursor's column is in its middle | helix `align_view_middle`; with soft wrap on there is no horizontal scroll, and nothing happens | out of corpus (the harness's text never scrolls sideways) |
| `i` `a` | insert at selection start / after selection end | helix semantics: `i` before the selection, `a` selects and appends after it | helix-verified |
| `I` `A` | insert at first non-ws / line end | matches `insert_at_line_start` / `insert_at_line_end` | helix-verified |
| `o` `O` | open line below / above, copying the current line's indent levels; `<n>o` opens n | matches `open_below`/`open_above` | helix-verified |
@@ -362,8 +364,6 @@ text.
| `:` | command mode | side-effects/file-ops — pardes builtins live in the tag, and `:` is bound to focusing it (section A) |
| `gf` | goto file under selection | covered by pardes Enter-look |
| `Ctrl-z` | suspend | pardes IS the terminal multiplexer |
-| `Z` (sticky view mode) | persistent view mode | marginal; `z` one-shots suffice |
-| `zm` (view) | align middle horizontally | marginal even with hscroll |
| Select/extend mode section (prose) | `v` turns all motions into extenders, `n`/`N` keep selections | implemented for motions (phase 5: `pane.select` + the fixed anchor, differential-verified — see the `v` row in A); helix's search-`n`/`N` extension doesn't apply (pardes' `n`/`N` is the look-ring motion, which REPLACES the selection with the span it lands on) |
## Differential testing (phase 5)
@@ -403,7 +403,7 @@ Files (all in `test/hxcases/`):
registers of one value per range, `sel-regex-caret` and
`sel-regex-dot-newline` when `s`/`S` began searching line by line.
- `parity.jsonl` — 80 further cases, used only by the parity gate below.
-- `parity-waivers.jsonl` — 15 named exemptions for the parity gate, in three
+- `parity-waivers.jsonl` — 19 named exemptions for the parity gate, in three
classes: one deliberate pardes binding (`ctrl-b-page`, since `Ctrl-b` IS the
tty toggle), eight pty VIEWPORT divergences (a terminal's view cannot scroll
below the vt's live grid bottom, so the cursor snaps into a different
@@ -412,6 +412,7 @@ Files (all in `test/hxcases/`):
newline, an all-whitespace last row the dump trims). One more,
`dot-append-count`: `a` at a file's end grows it by a newline (helix
append_mode), which a terminal's text, not the editor's to grow, does not.
+ The sticky-view cases join the viewport class.
- `golf.jsonl` + `golf-goldens.jsonl` — every example on helix-golf
(github.com/nik-rev/helix-golf, imported at d78c18c): one case per numbered
step of each walkthrough, its keys being the command up to and including