pardes.git/docs/typ/cheatsheet.typ, branch main

Docs for 0.24: Ctrl-i's fallbacks (SPC j i, SPC j o, the side buttons), a terminal's text edited as a copy, a tag's typed path surviving Esc, Get's order of refusals, the init file's errors when saved, --wait and --detach in words; the CHANGELOG's 0.24 section, the directory window moved there from 0.23

2026-10-02T04:48:59Z

Co-Authored-By: Claude Opus 5.5

Back and Forward keep to the focused file: Ctrl-o, Ctrl-i, the mouse's side buttons (now the tty's 8 and 9 too), the builtins and 9P go to the nearest place that way in this pane, else in this file in another pane, else of any file; JumpScope all takes every place in order as before

2026-10-01T21:02:10Z

A look at a directory opens a pane listing it, as acme's directory window: named dir/, its entries in acme's columns (bytewise, dotfiles kept, a directory's marked /), a look at an entry from there, Get or a look again reads it again, never dirty, Save refused; DirLook terminal keeps ls in a terminal

2026-10-01T20:47:47Z

Co-Authored-By: Claude Opus 5.5

The guide answers a first session: n walks a build's errors from its command pane, a finished one is already normal, why make wants the project root, opening beside, a builtin's argument by mouse, 12G, and SPC ? is Help everywhere; the tutor's tagline and button names match the site, and the cheatsheet's tree gains data, look and exec

2026-10-01T18:42:33Z

Co-Authored-By: Claude Opus 5.5

The guide, the cheatsheet and the tutor point to helix's keymap for every key, and say where pardes differs

2026-10-01T16:28:07Z

Co-Authored-By: Claude Opus 5.5

The remaining builtins in the reference, setup and the cheatsheet's 9P tree are written as #word, the window-only ones included, so each links to its glossary entry

2026-10-01T16:21:02Z

Co-Authored-By: Claude Opus 5.5

Builtins are chips that link to a glossary generated from the registry, and the virtual filesystem is drawn as a tree

2026-10-01T16:16:47Z

#word draws a builtin as a chip on the tag's ground over a rule (Look and Exec in acme's look green and exec red), a

 in HTML,
and links it to its entry in a new Builtins chapter wherever that
chapter is in the same output (the book, the site). The chapter is
drawn from docs/typ/builtins-tty.json and builtins-gui.json, which
`zig build builtins-json -Dplatform=tty|gui` writes from the registry
and the Help rows (src/builtins_json.zig, tools/gen_builtins_json.zig;
summaryOf in ninep/ctl.zig is now pub); style.typ merges them, marking
the window-only words. The doc steps refresh their build's file first,
and each build's unit-test fails when its file is stale. Everyday words
first (`everyday` in style.typ), then groups by leader prefix as Help
has them, then settings, the words with no path, debugging and
internals, and last an A-Z index of every word. `zig build book` joins
the doc steps.

#fstree draws a directory tree with its connectors, a description
column and links to the sections that document each file; reference.typ
draws the served tree with it, each pane, pty and column file on its
own line, and a test in config.zig checks it against ninep/tree.zig's
files both ways. The cheatsheet has a two-level version. On the site
the tree reads as `tree` text in w3m and wraps descriptions under the
names on a phone.

The site's tutor draws its B1, B2, B3 and 1-2 chords as mouse glyphs;
the landing credits Plan 9 and acme, as does the book's title page;
install.typ no longer lists the mirrors (the footer does).

Co-Authored-By: Claude Opus 5.5



Builtins are written by name: each chapter and the tutor define Look and Exec once and then say Look and Exec; the cheatsheet draws every mouse button as its icon; one-button clicks (Alt is B2, Super is B3) are in the guide and cheatsheet; building says how to send patches to the list
2026-10-01T15:58:23Z
Co-Authored-By: Claude Opus 5.5 


Prose that names a mouse button in words drops the glyph beside it, so a screen reader or text browser reads each click once
2026-10-01T15:44:43Z
Co-Authored-By: Claude Opus 5.5 


The docs call pardes's scripting interface a virtual filesystem, served over 9P, and the guide opens on look and execute as the core idea
2026-10-01T15:42:16Z
Co-Authored-By: Claude Opus 5.5