summaryrefslogtreecommitdiff
path: root/docs/typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-30 17:35:06 -0300
committerGabriel Schneider <[email protected]>2026-10-30 17:35:06 -0300
commit6d8da8721141284cf33bb901168b26135893eb86 (patch)
tree791d63401d4e85fbca1d597a8ce0326e70efd545 /docs/typ
parentefd43a3a2cf03bb741366331158b368abf9ac583 (diff)
parentbf6810a8f9d6cc82050e7d9c0cfb06358301b574 (diff)
downloadpardes-6d8da8721141284cf33bb901168b26135893eb86.tar.gz
pardes-6d8da8721141284cf33bb901168b26135893eb86.zip
Merge latest upstream into the macOS branch for Zig 0.17
Retain the macOS branch history and local Acme selection color while adopting upstream's current core and platform changes. Pin Zig and ZLS to 0.17.0, and fetch the existing zstbi compatibility commit through upstream after its original fork was removed.
Diffstat (limited to 'docs/typ')
-rw-r--r--docs/typ/README126
-rw-r--r--docs/typ/book.typ56
-rw-r--r--docs/typ/building.typ315
-rw-r--r--docs/typ/builtins-gui.json163
-rw-r--r--docs/typ/builtins-tty.json144
-rw-r--r--docs/typ/builtins.typ12
-rw-r--r--docs/typ/cheatsheet-a4.pdf2091
-rw-r--r--docs/typ/cheatsheet-a4.typ40
-rw-r--r--docs/typ/cheatsheet.typ159
-rw-r--r--docs/typ/guide.typ383
-rw-r--r--docs/typ/install.typ25
-rw-r--r--docs/typ/reference.typ1146
-rw-r--r--docs/typ/scripting.typ162
-rw-r--r--docs/typ/setup.typ136
-rw-r--r--docs/typ/style.typ614
-rw-r--r--docs/typ/themes.typ127
16 files changed, 5699 insertions, 0 deletions
diff --git a/docs/typ/README b/docs/typ/README
new file mode 100644
index 00000000..9d3913c0
--- /dev/null
+++ b/docs/typ/README
@@ -0,0 +1,126 @@
+docs/typ: the Typst documentation corpus
+
+ style.typ every semantic function, the palette and the topic
+ ids; the only place they are defined. Each function
+ looks at target(): it draws itself for paged output
+ and emits HTML elements under --features html.
+ cheatsheet.typ content: facts as markup and the calls below, no
+ layout. Later topics (guide, scripting, reference,
+ building) go beside it as their own content files.
+ cheatsheet-a4.typ output wrapper: the one-page A4 cheatsheet.
+ book.typ output wrapper: an A4 book, title page, contents,
+ every chapter, then the tutor (src/tutor.txt).
+ ../site/site.typ output wrapper: the website, a page per chapter plus
+ the landing page and the tutor, in one Typst bundle
+ run (see docs/site/README).
+ Wrappers hold layout only, never facts.
+
+Chapters: `chapters` in style.typ lists them in reading order (guide, setup,
+cheatsheet, scripting, reference, themes, building), each with its content file,
+or none while it is not written (the outputs show a placeholder). To add
+a topic, write docs/typ/<id>.typ and set its `file`. Wrappers include it
+with heading offset 1, so its = headings sit under the chapter title,
+which is labelled ch-<id>. Labels on headings must be unique across all
+the topics, since the book and the HTML hold them all.
+
+Build (from the repo root):
+
+ typst compile --ignore-system-fonts docs/typ/cheatsheet-a4.typ
+ zig build cheatsheet -Dplatform=tty --prefix DIR # DIR/share/doc/pardes/cheatsheet.pdf
+ typst compile --root . --ignore-system-fonts docs/typ/book.typ
+ typst compile --root . --format bundle --features bundle,html docs/site/site.typ OUT
+ zig build site -Dplatform=tty --prefix DIR # DIR/share/doc/pardes/site/
+(--root . because book and HTML read the tutor from src/tutor.txt.)
+
+The contract for content files
+------------------------------
+Start a content file with
+ #import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs, fstree, annotated, mode-box
+(a content file does not import page setup; the same file goes into the
+book, the HTML and, for the cheatsheet, the A4 page)
+and use plain markup (= headings, - lists, `raw`, *strong*) plus these.
+Never set page, fonts, colours or spacing in a content file; ask for a
+new function instead.
+
+ word(w) a builtin or tag word, drawn as a chip on the tag's
+ ground; a builtin links to its entry in the Builtins
+ chapter wherever that chapter is in the same output.
+ #word("Save") #word("Tty+bash")
+ key(k) one press, or a sequence of presses separated by
+ spaces, drawn as one pill (Ctrl + w, g › g).
+ Modifiers: Ctrl-, Alt-, Shift-.
+ #key("Ctrl-w") #key("g g") #key("SPC f c")
+ keys(..ks) alternatives listed together, each its own key.
+ #keys("h", "j", "k", "l") #keys("g d", "g r")
+ btn(b, shift:) a mouse button, B1 B2 (the wheel) or B3, drawn as a
+ mouse with that part filled; shift: true adds a ⇧.
+ #btn("B3") #btn("B1", shift: true)
+ chord(..bs) a chord: the first button held, each next clicked.
+ #chord("B2", "B1") #chord("B1", "B2", "B3")
+ tag(words, path:)
+ a whole default tagline; words must be a default tag.
+ #tag("Save Tty Collapse Del", path: "/home/me/notes.txt")
+ addr(a) a look address. #addr("file:12:5")
+ file(p) a 9P path. #file("pane/N/addr")
+ cmd(c) a shell line, as a block. #cmd("echo Save > $m/pane/$n/ctl")
+ doc(id, section:)
+ a pointer to a chapter, or a section of it by the label
+ on its heading. Ids: guide setup cheatsheet scripting
+ reference themes building (and the older tags fs
+ config keys detached, mapped in `topics`). A link in
+ the book and the HTML; on the A4 sheet, its name.
+ #doc("building", section: "listeners")
+ fstree(spec) a directory tree drawn as `tree` draws one, from a raw
+ block: two spaces of indent per level, the name (a
+ directory ends in /), two or more spaces, a one-line
+ description, an optional @label of the section that
+ documents it (a link where that section is in the
+ same output). reference.typ's tree is checked against
+ the files the session serves.
+ #fstree(```
+ index a line per pane @rules
+ pane/
+ new open: a new pane @panes
+ ```)
+ annotated(src, size, alt:, ..pins)
+ a screenshot with numbered pins, their labels as text
+ beside it. src from the repository root, size in
+ pixels, each pin ([label], x, y) in its pixels.
+ #annotated("/docs/site/media/themes/orchard.png", (640, 513),
+ alt: "a pardes window", ([the box], 8, 58))
+ mode-box(mark, unsaved:)
+ a pane's box as it looks: " " normal, "^" insert,
+ "$" raw; unsaved: true fills it.
+ #mode-box("^") #mode-box(" ", unsaved: true)
+ theme-gallery() every theme as a picture, on the site's Themes page;
+ nothing on paper.
+ pairs(split:, ..cells)
+ a two-column table, a thing and its meaning, rows on
+ alternating tints; split: 2 sets it as two tables side
+ by side on paper. Cells alternate left, right.
+ #pairs(key("u"), [undo], keys("i", "a"), [insert])
+
+Builtins
+--------
+builtins-tty.json and builtins-gui.json are every builtin of the terminal
+and the window build (name, leader, Help's other shortcuts, arg, scope,
+setting, choices, doc), written by `zig build builtins-json -Dplatform=tty`
+and `-Dplatform=gui` from the registry and the Help rows
+(src/builtins_json.zig). style.typ merges them, marking each word "both",
+"tty" or "gui". The doc steps refresh their build's file first, and each
+build's unit-test fails when its file is stale. #word takes a name from
+either file. builtins.typ draws it as the
+glossary; `everyday`, `internals` and `builtin-groups` in style.typ say
+in what order.
+
+The drift test
+--------------
+The unit test "docs/typ names only words, keys and default tags that
+exist" (src/config.zig) reads every .typ here and fails when a word(),
+key(), keys() or tag() names a builtin, key binding or default tag that
+pardes no longer has. Pass these functions string literals, so the test
+can read them.
+
+Only embedded fonts (Libertinus Serif, DejaVu Sans Mono), so output is the
+same on every machine. docs/typ/cheatsheet-a4.pdf is committed, as the
+other docs PDFs are; re-render it when the content changes.
diff --git a/docs/typ/book.typ b/docs/typ/book.typ
new file mode 100644
index 00000000..b2245372
--- /dev/null
+++ b/docs/typ/book.typ
@@ -0,0 +1,56 @@
+// The book: every topic in reading order, then the tutor. Facts live in the
+// content files named by `chapters` in style.typ; this is layout only.
+// typst compile --root . --ignore-system-fonts docs/typ/book.typ
+// (--root . because the tutor is read from src/tutor.txt.)
+#import "style.typ": palette, mono, chapters, tutor-path, doc-links, tagline
+
+#set document(title: "pardes")
+#doc-links.update(true)
+#set page(paper: "a4", fill: palette.paper, margin: (x: 22mm, y: 24mm))
+#set text(font: "Libertinus Serif", size: 10pt, fill: palette.ink, lang: "en")
+#set par(justify: true, leading: 0.62em, spacing: 1em)
+#set list(spacing: 0.8em)
+#show heading.where(level: 2): set block(above: 2em, below: 0.9em)
+#show heading.where(level: 3): set block(above: 1.5em, below: 0.7em)
+#show raw: set text(font: mono, size: 0.9em)
+#show raw.where(block: true): it => block(
+ width: 100%, fill: palette.tag-bg.transparentize(50%), radius: 2pt,
+ inset: (x: 6pt, y: 5pt), above: 0.9em, below: 0.9em, it)
+#show heading: set text(fill: palette.tag-name)
+#show heading.where(level: 1): it => {
+ pagebreak(weak: true)
+ v(18mm)
+ text(size: 22pt, weight: "bold", it.body)
+ v(8mm)
+}
+
+// title page
+#page(numbering: none, {
+ v(1fr)
+ text(size: 34pt, weight: "bold", fill: palette.tag-name)[pardes]
+ v(4mm)
+ text(size: 13pt, style: "italic", fill: palette.tag-fg, tagline)
+ v(10mm)
+ text(size: 11pt, fill: palette.ink)[Built on ideas from #link("https://9p.io/plan9/")[Plan 9] from Bell
+ Labs: #link("https://9p.io/sys/doc/acme/acme.html")[acme]'s text as the interface, and the 9P
+ protocol.]
+ v(2fr)
+})
+
+#page(numbering: none, outline(depth: 2))
+
+#set page(numbering: "1")
+#counter(page).update(1)
+
+#for ch in chapters {
+ [#heading(level: 1, ch.title) #label("ch-" + ch.id)]
+ if ch.file == none {
+ text(style: "italic", fill: palette.tag-fg)[This chapter is not written yet.]
+ } else {
+ set heading(offset: 1)
+ include ch.file
+ }
+}
+
+= The tutor
+#text(size: 8pt, raw(read(tutor-path), block: true))
diff --git a/docs/typ/building.typ b/docs/typ/building.typ
new file mode 100644
index 00000000..d551c251
--- /dev/null
+++ b/docs/typ/building.typ
@@ -0,0 +1,315 @@
+// Building pardes, for contributors: platforms, options, tests, the
+// release gates and sending patches, then how the pieces fit: the core
+// and its shells, the threads, detached sessions, the 9P engine, the
+// listeners and mounts.
+#import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs
+
+For contributors: how pardes is built, tested and released, and how its
+pieces fit. To install it, see #doc("setup", section: "install").
+
+= Platforms
+
+Zig *0.17.0* (`build.zig.zon` pins `minimum_zig_version`). Dependencies are
+fetched and pinned by the manifest; the terminal build needs no system
+package. The SDL shell builds SDL3 and FreeType from source. PDF support
+builds MuPDF and is on by default (`-Dmupdf=false` drops it). 9P over QUIC
+(`-Dquic=true`) uses system OpenSSL 3.6+ and pkg-config.
+
+#pairs(
+ [`zig build`], [the terminal shell and the SDL window together, *installed into `~/.local/bin`* (`pardes`, `pardes-gui`, and `pardes-v9fs`, the #word("Tty9p") helper)],
+ [`zig build -Dplatform=tty`], [the terminal shell alone],
+ [`zig build -Dplatform=gui`], [the SDL3 window alone],
+ [`zig build web -Dplatform=web -Dtarget=wasm32-freestanding -Ddump=<dump.zon>`], [a freestanding wasm core plus vanilla JavaScript (`docs/web.md`)],
+ [`zig build -Dplatform=macos`], [an AppKit and CoreText app over a static `libpardes.a` (`docs/macos.md`)],
+ [`zig build -Dplatform=esp32p4`], [a freestanding riscv32 editor object for the ESP32-P4, with a 384 KiB heap],
+)
+
+A bare `zig build` installs into the prefix (`zig-out`, or `--prefix
+<dir>`) and copies the binaries into `~/.local/bin`; `-Dhome-install=false`
+leaves that copy out. Zig 0.17 keeps the prefix from the build script, so
+`--prefix` alone no longer stops it. With `-Dplatform` nothing is copied,
+so always pass `-Dplatform` while developing. Test, benchmark and run steps build what they need
+without installing. `pardes --version` prints `pardes <version>` (from
+`build.zig.zon`), plus the commit for release builds and the `~/.local`
+install; `pardes --help` lists every flag.
+
+The ESP32-P4 firmware is linked in the sibling `../05-zig-p4` toolchain,
+which needs ESP-IDF register headers: after building the editor object
+here, `zig build -Dpardes` there links `src/esp32p4/app.zig`. The separate
+GPIO 9P image is `zig build -Dapp=../02-pardes-code/src/esp32p4_9p.zig`
+there; its namespace is in `src/esp32p4_gpio.zig`.
+
+== Build options
+
+`zig build --help` lists the options for the selected platform.
+
+#pairs(
+ [`-Dplatform`], [`tty`, `gui`, `web`, `macos`, `esp32p4`; absent: the tty and SDL shells together, installed into `~/.local`],
+ [`-Dstatic`], [bool, `false`],
+ [`-Dquic`], [bool, `false`: 9P over QUIC with system OpenSSL 3.6+],
+ [`-Dmupdf`], [bool; on natively, off for web and esp32p4],
+ [`-Djpx`], [bool, `true`: JPEG 2000, and with it scanned PDFs],
+ [`-Dtree-sitter`], [`disabled`, `zig`, `minimal`, `full`; `full` natively, `zig` for web, `disabled` for esp32p4],
+ [`-Dembed-sources`], [bool, `false`: serve the sources under #file("/src")],
+ [`-Dhome-install`], [bool: a bare `zig build` also copies the binaries into `~/.local/bin`; default true],
+ [`-Dstamp-commit`], [bool: the git commit in `--version` and crash records; on for release builds and the `~/.local` install],
+ [`-Dtheme-animation`], [bool; on except for esp32p4],
+ [`-Dworkspace-tag`], [bool: draw the workspace tag row; on except for macOS, whose menu bar carries it],
+ [`-Dprebuilt-shaders`], [bool: embed the committed SPIR-V; on for a bare `zig build`, off with `-Dplatform`; `zig build shaders` refreshes it with glslc],
+ [`-Dtracy`], [path to a Tracy checkout; off],
+ [`-Dmacos-identity`], [codesigning identity for `pardes.app`; `-` (ad hoc)],
+ [`-Ddump`], [a `dump.zon` to embed in the web shell],
+ [`-Dtest-filter`], [run only tests whose name contains it; a filter that matches nothing fails],
+ [`-Dtest-rebuild`], [bool: fresh Zig test compilation],
+ [`-Dhelix-harness`], [reference executable for live differential tests; `HX_HARNESS`, else `hx-harness` on `PATH`],
+ [`-Desp32p4-cols`, `-Desp32p4-rows`], [the ESP32-P4's grid, 56 by 14],
+)
+
+= Tests
+
+```
+zig build unit-test module and shell unit tests (the perf gate runs with it)
+zig build test-build compile the unit-test programs without running them
+zig build core-test core tests without native shell tests
+zig build pane-test pane, output, PDF and namespace integration tests
+zig build kitty-test kitty graphics conformance of terminal panes, at the core
+zig build kitty-harness kitty graphics through a pane end to end (a fake kitty
+ terminal outside on the tty, the GPU capture on the gui;
+ kitten icat and chafa too when installed)
+zig build syntax-test tree-sitter tests without building the editor
+zig build syntax deterministic per-byte highlighting snapshots
+zig build fs-test real sessions and mounts over 9P (with a short 9P monkey)
+zig build monkey-9p random 9P operations checking the documented rules
+zig build agent-session-test interactive session driver checks over 9P
+zig build 9p-test freestanding protocol tests
+zig build 9p-io-test native 9P transports and client
+zig build quic-test -Dquic=true optional QUIC transport tests
+zig build v9fs-test a real kernel mount (needs sudo -v; fails, not skips, without it)
+zig build snap scripted input traces against frozen golden grids
+zig build monkey random snapshot scripts hunting panics (not a gate)
+zig build hxdiff differential suite against helix's own behaviour
+zig build hxparity file-pane vs pty-pane editing parity
+zig build hxgolf every helix-golf example, step by step, against helix
+zig build perf-gate a gesture on the 50k-line file over 3x its baseline fails
+zig build mupdf-check compile, link, render and search docs/design.pdf
+zig build web-snap browser highlighting and touch interactions
+zig build web-e2e Chrome-driven DOM end-to-end suite
+zig build cheatsheet render the cheatsheet PDF (needs typst)
+```
+
+- `-Dtest-filter=<text>` applies to every unit-test binary. A failed test's
+ printed trace can be stale: run it alone with the filter.
+- `snap -- --record=DIR` writes snapshots without touching goldens,
+ `snap -- --update` replaces goldens (re-record one script by name, after
+ reading its diff, never all), `snap -- --no-retry` makes the first
+ failure decisive. Snapshot scripts can use `snap9p` to capture core cells
+ through 9P.
+- `zig build monkey -Dplatform=tty -- <seeds> [steps] [--from=N] [--out=DIR] [--keep]` writes one random script per seed and keeps any
+ that panics; a seed always makes the same script. Each crash found gets a
+ fix and a regression script in `test/snapshots/`.
+- The tutor's practice blocks (`# keys:`, `# before`, `# after` in
+ `src/tutor.txt`) are typed by hand; nothing runs them. What pins that
+ behaviour is `hxdiff`, which replays `test/hxcases` against goldens
+ recorded from a real helix, and `hxparity`, which runs each case in a
+ file pane and in a shell and demands they agree.
+- `zig build hxdiff -- --strict cases.jsonl reference.jsonl [waivers.jsonl]` runs custom differential cases. `docs/helix-keys.md`
+ tracks helix parity key by key and names the reference helix build;
+ `docs/selections.md` is the selection model under normal mode.
+- Benchmarks (`perf`, `pdf-bench`, `pdf-scroll-bench`,
+ `pdf-sections-bench`, `lspbench`, `fs-bench`) take `-- --json`; measure
+ with `-Doptimize=ReleaseFast`. `perf -- --base old.json` refuses reports
+ whose build metadata differs.
+- `zig build history -- run 'ancestors(@, 2)' DIR -- zig build unit-test`
+ records a command's output and runtimes across revisions; `history -- compare a.json b.json 1.20` fails past that runtime ratio.
+- `python3 -B test/agent_session.py <pardes> --ready 'text' --min-rows N -- command args` drives an interactive command in a private shell and checks
+ it through 9P.
+
+== Release gates
+
+A release passes all of these first: `unit-test` with `-Dplatform=tty` and
+with `-Dplatform=gui`, `core-test`, `fs-test`, `snap`, the GUI goldens
+(`python3 -B test/gui_golden.py <a Debug pardes-gui>`, a hidden window),
+`web`, and the ReleaseSafe tty and ReleaseFast gui builds. The committed
+`docs/typ/cheatsheet-a4.pdf` is rendered again when the docs change.
+
+= Sending patches <patches>
+
+Mail patches to the list `~gbrls/[email protected]`; it is the preferred way to contribute:
+
+#cmd("git config format.subjectPrefix \"PATCH pardes\"\ngit send-email --to=~gbrls/[email protected] HEAD^")
+
+#link("https://git-send-email.io")[git-send-email.io] sets `git send-email` up. The mirrors (#doc("setup", section: "install")) are for cloning, as a GitHub one will be; pull requests are not the preferred route.
+
+= The core and its shells
+
+One core, five shells (tty, gui, web, macos, esp32p4). The core owns
+editing, layout, rendering and the virtual filesystem it serves over 9P; a shell turns native
+input into `pardes.Event`, presents `pardes.Surface`, and performs host
+effects such as spawning processes.
+
+- The core is a state machine: input arrives as an `Event` through
+ `update`; output leaves as a `Surface` from `render(arena)` and as a ring
+ of `Effect` values. Effects are fixed-size values with no lifetime ties
+ into the core; unbounded content is read off the core when an effect is
+ drained (`save_text` carries a path and the pane's serial, so a reused
+ slot writes nothing). `emit` refuses when the ring is full and never
+ evicts.
+- Pty bytes leave as 64-byte `.write` effects; overflow parks in a per-pane
+ buffer that `nextEffect` drains in order. `postEvent` is a 64-entry value
+ queue for events that borrow no slices.
+- `pump` runs: wait for input (the host owns the sleep), flush paused 9P
+ write batches, drain queued events, drain effects, settle the turn, then
+ render and present only when a frame is needed and someone is looking.
+- `host_io.Host` is a context pointer and a vtable of optional callbacks; a
+ null method is not an error, and `Host{}` is a complete in-process pardes
+ that the tests use. Comptime decides what a build has (`pardes.platform`,
+ `hosted`, `can_attach`, `terminal_panes`, `pdf_enabled`); the vtable
+ decides who serves it.
+- The root module is chosen by platform: `main.zig` (tty, gui),
+ `web.zig`, `macos.zig`, `esp32p4.zig`. The web and macOS shells are
+ libraries whose host owns `main()`.
+- `memory.limits` is the one home for capacities that differ on the ESP32-P4
+ (panes 16, columns 6, selections 64, the tag's 512 bytes). Each core
+ allocator is a thread-safe stack-fallback allocator, under a
+ DebugAllocator in Debug builds.
+
+Code map: `src/panes.zig` and the pane kinds it names (`src/File.zig`,
+`src/Terminal.zig`, ...), `src/layout.zig`, `src/fs.zig` (host access,
+mounts and resolution) and `src/pardes.zig` (input), with one file per
+thing beside them (`edit.zig`, `normal.zig`, `look.zig`, `exec.zig`,
+`mouse.zig`, ...). `src/ninep/` is the control tree, `src/detached/` the
+wire, the detached core and the frontend client, `src/lsp/` the
+language-server client; `test/` holds harnesses, goldens and helix cases,
+`build/` the snapshot suite's build step.
+
+== Threads
+
+The core is single-threaded under a turn mutex, `pardes.turn`. The editor
+thread holds the turn and lets go of it while it waits for input and while
+it is out in a host syscall mid-step; a 9P connection task takes the turn
+in those gaps to answer a request. While a step is out, a request that
+would change a pane parks (`Status.again`) and is retried when the editor
+rests. 9P requests are not events: they enter through `Pardes.serveFs`, and
+only one that changes a pane costs a frame. Language-server and
+selection-pipe workers post completions through a bounded mailbox; a
+`host_io.Lsp.Job` owns copies of the source, path and arguments, never
+reading the live core, and a request id, the pane's serial and (for an
+edit) the file's revision reject a stale reply. A process that never calls
+`turn.start` (the tests, the ESP32-P4, the browser) has no second thread.
+
+== Detached sessions
+
+One poll loop in `src/detached/server.zig` owns core mutation, frontend
+connections, pty I/O and file watches. The frontend socket is
+`pardes-detached-<name>.sock` beside the session's 9P socket; a second
+session cannot take a live name. Up to 32 frontends attach; frames go to
+every one, while clipboard reads, browser opens and #word("Detach") go to
+the frontend that asked (else the first attached). Frames are full grids
+or changes against what each frontend last received, never queued: a
+frontend with unsent bytes skips that frame, and one that stops draining
+past 1 MiB of control backlog is closed, its peers untouched. Frontends
+never spawn shells, write session files or watch files. #word("Attach")
+connects first and swaps second: only after the handshake does a shell
+give up its own core. #word("Restore") builds the replacement core before touching
+the current one.
+
+`src/detached/wire.zig` is the versioned protocol (version 10): fixed-width
+little-endian fields, a 5-byte header (tag, then a u32 length), payloads up
+to 16 MiB and grids up to 512 by 128. A comptime hash of `pardes.Chrome`
+forces a version bump when that struct changes.
+
+= 9P
+
+The wire format, the client and server connections, the file-server engine
+and the Unix, TCP and QUIC transports are the `cloud9` package
+(`git.sr.ht/~gbrls/cloud9`), pinned in `build.zig.zon` and fetched into
+`zig-pkg/`. Re-pin with
+`zig fetch --save=cloud9 git+https://git.sr.ht/~gbrls/cloud9#<commit>`, or
+use `.cloud9 = .{ .path = "../cloud9" }` while editing both. cloud9's own
+`zig build test`, `transport-test`, `quic-test -Dquic=true`, `fuzz` and
+`differential` cover the shared code.
+
+- The engine (`fs.Server`) owns fids, permissions, directory reads,
+ flushes and what a hangup releases; it allocates nothing and makes no OS
+ calls. The control tree in `src/ninep/` is its backend: `tree.zig`
+ (nodes, dispatch), `pane.zig`, `ctl.zig`, `cols.zig`, `addr.zig`,
+ `pty.zig`, `events.zig` (event and log), `screen.zig`, `sources.zig`.
+ `src/9p.zig` names the editor's and the ESP32-P4's engine settings: msize
+ 65536, 256 fids, 128 held reads a connection, names up to 255 bytes; the
+ ESP32-P4 has 32 fids.
+- A read, write, open, clunk, remove or truncating wstat can park; a walk,
+ attach, stat, create or rename cannot. Every Rread is clamped to the
+ count and the msize; Tflush answers the original request first.
+- Unix and TCP listeners run on cloud9's `serve.Runner`: an accept task per
+ listener, a reader and a writer task per connection, 16 connections. QUIC
+ (`src/9p_quic.zig`) still runs on the editor's poll loop in
+ `src/9p_io.zig`.
+- A body write takes only whole UTF-8 sequences and answers a short count
+ for the rest. Consecutive writes from one open at the end of the text are
+ held and applied as one edit, flushed by any other request, the open's
+ release, 64 MiB, or a 20 ms pause in the editor's step.
+
+== Writes through a mount <writes-through-a-mount>
+
+A mount cuts a big write into pieces of at most one message (msize 65536,
+less the header), anywhere, and each command line runs once its newline
+comes; nothing is read into a write's size. A last line with no newline
+(`printf Save > exec`) runs when the file is closed, as does an #word("Edit")
+block never ended, and its failure is then only in the log, as its `err`
+record: the close reports no error, and the write that sent it had
+already succeeded. So a script that needs a line's result ends it with a
+newline. A line over 1 MiB is refused once, and the rest of it, through
+its newline, is dropped.
+
+== Listeners <listeners>
+
+`--9p-tcp='tcp!127.0.0.1!5640'` adds TCP; `--9p-quic='quic!127.0.0.1!5641'`
+adds QUIC (built with `-Dquic=true`; ALPN `pardes-9p`, an ephemeral TLS
+identity, no peer verification). Addresses are numeric IPv4 or IPv6; port
+0 picks one; #file("/listeners") reads them back. Every connection has full
+session access, #file("/os") included, and TCP is unencrypted: use
+loopback. Unix and TCP share 16 connection slots; a 17th client's Tversion
+gets `too many connections` (and the log
+`err - 9p: too many connections (N turned away)`). QUIC has 16 of its own.
+plan9port and v9fs need a userspace bridge for QUIC.
+
+`$XDG_RUNTIME_DIR/9p` is the machine's `/srv`: servers post themselves
+there by name, and `9ns --mntgen` mounts the whole registry. A pardes whose
+socket is in the runtime directory posts
+`$XDG_RUNTIME_DIR/9p/pardes/<name>`, a symlink to its socket, and unposts
+it on a clean stop if it is still its own; one whose socket fell back to
+`~/.local/state/pardes` posts nothing. Posting first sweeps the group: a
+symlink whose socket refuses a connect is removed with its socket. pardes
+binds its own socket rather than going through `cloud9.post`, which takes
+only flat names. A reader of the registry must `stat` through the symlink.
+
+== Kernel mounts and Tty9p
+
+For Linux v9fs use `version=9p2000,cache=none,access=any`, `trans=unix`
+(or `trans=tcp` with `port=`), `uname`, `dfltuid` and `dfltgid` for the
+local user, and an empty `aname`. Linux follows `O_TRUNC` with a `Twstat`
+of zero length and an `mtime` hint; pardes takes the truncation and drops
+the hint.
+
+#word("Tty9p") starts the normal shell and queues a quoted helper command,
+which bash and fish run at their first prompt as a foreground job, so
+sudo has the terminal. The unprivileged launcher makes a private temporary
+mountpoint and runs `sudo -E`; the elevated `pardes-v9fs` helper makes a
+private mount namespace, mounts the session's socket with
+`trans=unix,version=9p2000,cache=none,access=any,nosuid,nodev,noexec`,
+drops every root id and capability, and runs the shell as the user (with
+the caller's `PATH` again). The namespace and the mount go with its last
+process. Nothing setuid and no passwordless sudo rule is installed; the
+helper takes explicit paths and a command and is no restricted broker, so
+never grant it passwordless sudo. The host finds the helper beside its own
+executable, or at `PARDES_V9FS_HELPER`. Code: `src/linux/v9fs.zig`;
+`zig build v9fs-terminal-test` and `v9fs-driver-test` need no privileges.
+
+= Other notes
+
+`docs/` keeps the platform and design notes beside this book:
+`web.md` and `macos.md` (the browser and macOS shells), `effects.md` and
+`render-pipeline.md` (visual effects), `helix-keys.md` and `selections.md` (helix parity),
+`lsp-evaluation.md`, `ui-review.md`, `divergences.md` (bookmarks off
+`main`) and `open-questions.md`. `next-steps.txt` is a wishlist and
+`transactions.txt` records one open structural gap against helix.
diff --git a/docs/typ/builtins-gui.json b/docs/typ/builtins-gui.json
new file mode 100644
index 00000000..db1031a0
--- /dev/null
+++ b/docs/typ/builtins-gui.json
@@ -0,0 +1,163 @@
+[
+ {"name": "Ascii", "leader": "SPC t a", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "add the printable ASCII bitmaps to the matcher's glyph set"},
+ {"name": "Attach", "leader": "SPC s a", "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Attach this terminal to a detached pardes session by name."},
+ {"name": "Back", "leader": "SPC j o", "also": ["C-o"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Ctrl-o: one step back into the history."},
+ {"name": "Bloom", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off, 0-3", "doc": "The brightest ink glows a little: a level, 0 (off) through 3."},
+ {"name": "BootShell", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "keep, replace", "doc": "A document dropped where a lone untouched shell stands: keep the shell, or replace it."},
+ {"name": "Callees", "leader": "SPC l C", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the functions the function under the cursor calls."},
+ {"name": "Callers", "leader": "SPC l c", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the callers of the function under the cursor."},
+ {"name": "Callstack", "leader": "SPC l b", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Show outermost callers first, with signatures and call sites (gc)."},
+ {"name": "CallstackCorners", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "rounded, square", "doc": "Callstack tree corners: rounded (the default) or square; bare, it switches styles. Applies to the next Callstack query."},
+ {"name": "CallstackDepth", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Caller levels collected by Callstack, 1 through 64; default 8. Bare, it says the current limit."},
+ {"name": "CallstackLayout", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "inline, stacked", "doc": "Callstack snippets below their locations (stacked, the default) or beside them (inline); bare, it switches layouts. Applies to the next Callstack query."},
+ {"name": "Changelog", "leader": "SPC h c", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "This build's version and what changed to reach it, printed into an output buffer the same way Config prints the live settings."},
+ {"name": "ChipShadow", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "In a terminal, a notice chip casts a cell's shadow right and down, on or off."},
+ {"name": "ClipPaste", "leader": "SPC p", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Paste the system clipboard after the selection."},
+ {"name": "ClipPasteBefore", "leader": "SPC P", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Paste the system clipboard before the selection."},
+ {"name": "ClipReplace", "leader": "SPC R", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Replace the selection with the system clipboard."},
+ {"name": "ClipYank", "leader": "SPC y", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Copy the selection to the system clipboard."},
+ {"name": "ClipYankMain", "leader": "SPC Y", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "helix `<space>Y`: the PRIMARY selection alone, where `SPC y` joins every cursor's."},
+ {"name": "CodeAction", "leader": "SPC l a", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the language server's code actions for the cursor."},
+ {"name": "Collapse", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Fold a pane to its tag, or restore its share of the column."},
+ {"name": "Colors", "leader": "SPC t c", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Syntax colours in text panes, on or off."},
+ {"name": "Config", "leader": "SPC f c", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the startup file, `init`, in a pane: its pane when it is open, else the file, else a pane of that name for Save to make it and its directory."},
+ {"name": "Crt", "leader": "SPC t r", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off, 0-3", "doc": "The bundled CRT post pass over the window, on or off."},
+ {"name": "CursorBlink", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "The cursor blinks, solid while typing, on or off."},
+ {"name": "Debug", "leader": "SPC t d", "also": ["topbar"], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A small box of frame statistics at the top right, on or off."},
+ {"name": "Def", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Go to the definition of the symbol under the cursor; with an argument (a 2-1 chord's selection), of that symbol, where it is nearest."},
+ {"name": "Del", "leader": "SPC d", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Close the pane."},
+ {"name": "DelAbove", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Close the pane, giving its rows to the pane above it."},
+ {"name": "DelBelow", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Close the pane, giving its rows to the pane below it."},
+ {"name": "Delcol", "leader": "SPC c d", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Close this column and its panes, refusing once over unsaved text."},
+ {"name": "Detach", "leader": "SPC s D", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Detach this pardes from its terminal, leaving the session running."},
+ {"name": "Diagnostics", "leader": "SPC l d", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the file's diagnostics from the language server."},
+ {"name": "Diff", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Stack a diff's hunks as a diff viewer shows them, each under its place and the declarations around it, in a +Diff; on a +Diff, show the diff itself as text."},
+ {"name": "DiffLook", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "hunks, text", "doc": "A .diff or .patch looked at: hunks, a +Diff stacking its hunks, or text, the file itself; Diff goes from one to the other."},
+ {"name": "DirLook", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "pane, terminal", "doc": "A directory looked at: pane, a pane listing it as acme's directory window, or terminal, ls in a terminal there."},
+ {"name": "Down", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Move the keyboard to the pane below, off a tag onto the pane under it."},
+ {"name": "Dump", "leader": "SPC s d", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Write the session's panes and layout to a dump file, for Restore."},
+ {"name": "DumpConfig", "leader": null, "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the settings in effect, each a word to click, and the startup file's path."},
+ {"name": "DumpDir", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "The directory Dump writes to and a relative Restore reads from; bare, the default."},
+ {"name": "DumpThemes", "leader": null, "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Write the bundled themes into the config directory's themes, to edit."},
+ {"name": "Edit", "leader": null, "also": [], "arg": true, "scope": "both", "setting": false, "choices": null, "doc": "acme's Edit: sam's command language over the open text panes, from a tag, a pane ctl or exec, starting in the pane's body."},
+ {"name": "EffectCode", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Open the source of a panel transition or post shader, by name."},
+ {"name": "Exec", "leader": null, "also": ["tab", "middle-click"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Execute its argument as a middle click on it would, a builtin or a shell command."},
+ {"name": "Exit", "leader": "SPC q", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Quit the editor, refusing once while a pane holds unsaved text: an Exit with nothing edited since discards it."},
+ {"name": "Filter", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Recolour a terminal's or a +Pager's program colours to the theme, or show them as sent, flipping between them."},
+ {"name": "Find", "leader": "SPC f f", "also": ["topbar"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "List the files below this pane's directory whose names hold its argument, in a +Search."},
+ {"name": "FocusTint", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "The focused pane's and column's tags are tinted, on or off."},
+ {"name": "Font", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "The body font, by name or path, and its size."},
+ {"name": "Fonts", "leader": "SPC t f", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "List the fonts in a pane, each a word to click."},
+ {"name": "Forward", "leader": "SPC j i", "also": ["C-i"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Ctrl-i: one step forward again, up to wherever Back started."},
+ {"name": "Get", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Get: the pane's file read again, its unsaved edits refused once as Del refuses them."},
+ {"name": "Grain", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off, 0-3", "doc": "The page takes a fine, still grain, like paper: a level, 0 (off) through 3."},
+ {"name": "Grep", "leader": "SPC f g", "also": ["topbar"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Find's sibling: Find matches file NAMES under this pane's directory, Grep matches the LINES of those files, on the disk engine's worker."},
+ {"name": "GripWidth", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "The grip and scrollbar width, as a percent of the theme's rail."},
+ {"name": "Help", "leader": "SPC ?", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the help: every key and every builtin."},
+ {"name": "Hover", "leader": "SPC l k", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Ask the language server about the symbol under the cursor."},
+ {"name": "HoverGlow", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A soft underline of light under the word a look-hover would open, on or off."},
+ {"name": "InactiveDim", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Fade the unfocused panes' text by a percentage, 0 through 100, 0 off."},
+ {"name": "Incl", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "acme's Incl, for the session: `Incl dir ...` adds directories a look at a name found nowhere else is tried in (`stdio.h`, `<foo.h>`), bare lists them, `Incl -` empties the list."},
+ {"name": "Joincol", "leader": "SPC c j", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Fold the active pane's column into the one on its right, keeping its panes."},
+ {"name": "JumpScope", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "file, all", "doc": "What Back and Forward keep to: file, the focused pane's file until it runs out that way, or all, every place in order."},
+ {"name": "JumpTrail", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "In a terminal, a jump of the cursor leaves a short trail that fades, on or off."},
+ {"name": "Jumplist", "leader": "SPC j l", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "List the places jumped from, each a place to go."},
+ {"name": "Kill", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "acme's Kill: stop the commands pardes started -- the lines it typed into a terminal, from an exec, a middle click or a pty/run, while their shell says they run (C mark to D)."},
+ {"name": "Last", "leader": "SPC j j", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Go back to the last place jumped from in another pane."},
+ {"name": "Left", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Move the keyboard to the pane, or column tag, to the left."},
+ {"name": "Lift", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off, shadow, rim, auto", "doc": "How the focused pane stands off the page: off, shadow, rim or auto."},
+ {"name": "Ligatures", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A font's programming ligatures draw across their cells, on or off."},
+ {"name": "LocationsConfig", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Set how location rows are drawn, or show how they are when bare."},
+ {"name": "Look", "leader": null, "also": ["enter", "right-click"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Look at its argument: open the file or address it names, else find the word, as a right click does."},
+ {"name": "LookNext", "leader": "SPC j n", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Select the next Look location across panes; Enter opens it."},
+ {"name": "LookPrev", "leader": "SPC j p", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Select the previous Look location across panes; Enter opens it."},
+ {"name": "LookWord", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "search, list", "doc": "A plain word looked at: search selects its next place in the pane, list lists every place in a +Search."},
+ {"name": "Lspinfo", "leader": "SPC l i", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Show which language servers serve this file and their state."},
+ {"name": "Lspwhy", "leader": "SPC l w", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Explain how the last language server request was answered, step by step."},
+ {"name": "MessageAnimation", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A message falls into its row and dissolves out of it, on or off."},
+ {"name": "MessageDissolve", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "How long, in milliseconds, a message takes to dissolve."},
+ {"name": "MessageFall", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "How long, in milliseconds, a message takes to fall into its row."},
+ {"name": "MessageLinger", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "How long, in milliseconds, a message stays after what dismisses it."},
+ {"name": "Messages", "leader": "SPC h m", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the messages shown so far."},
+ {"name": "Mini", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Open a minimap of the file in braille dots."},
+ {"name": "Mode", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Cycle the pane's input modes: terminals add raw tty mode to normal/insert."},
+ {"name": "More", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "A query pane's Grep stopped at its 2000 lines goes on for 2000 more."},
+ {"name": "Motion", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "off, crisp, smooth, bouncy, playful", "doc": "How animations move: off, crisp, smooth, bouncy or playful."},
+ {"name": "Mount", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Mount another pardes's 9P tree under /n/<name>, given its dial address."},
+ {"name": "Msg", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Show its argument on this pane's message row."},
+ {"name": "New", "leader": "SPC f n", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Open an empty scratch pane, <dir>/+New, in this pane's directory."},
+ {"name": "Newcol", "leader": "SPC c n", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "An empty column right of the keyboard's, its tag taking the keyboard."},
+ {"name": "NextColor", "leader": "SPC t n", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Switch to the next bundled theme."},
+ {"name": "Occlusion", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Pane bodies darken faintly toward their edges, on or off."},
+ {"name": "Pager", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "pardes, off", "doc": "What a terminal's commands page through: pardes, a +Pager pane (pardes -), or off, the environment's own; for terminals started after it."},
+ {"name": "PagerColor", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A +Pager keeps its program's colours, on or off; for the next text paged."},
+ {"name": "Palette", "leader": "SPC t l", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "the C64 palette or the terminal's own 16"},
+ {"name": "PanelAscii", "leader": "SPC a a", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close through a scatter of ASCII, on or off."},
+ {"name": "PanelCurtain", "leader": "SPC a c", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close like a curtain, on or off."},
+ {"name": "PanelDissolve", "leader": "SPC a d", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes dissolve in and out as they open and close, on or off."},
+ {"name": "PanelEdges", "leader": "SPC a e", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close from their edges, on or off."},
+ {"name": "PanelFall", "leader": "SPC a f", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes fall into place as they open, on or off."},
+ {"name": "PanelScramble", "leader": "SPC a r", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close through scrambled text, on or off."},
+ {"name": "PanelSlide", "leader": "SPC a s", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes slide in and out as they open and close, on or off."},
+ {"name": "PanelType", "leader": "SPC a t", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes type themselves in as they open, on or off."},
+ {"name": "PanelVertical", "leader": "SPC a v", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close with a vertical wipe, on or off."},
+ {"name": "PanelWave", "leader": "SPC a w", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close in a wave, on or off."},
+ {"name": "PanelZoom", "leader": "SPC a z", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes zoom in and out as they open and close, on or off."},
+ {"name": "Panes", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Pick an open pane by its name in a query pane under this one (SPC b b)."},
+ {"name": "Parallax", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A theme's page pattern moves with the text at a quarter of its speed, on or off."},
+ {"name": "PdfFit", "leader": "SPC t z", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Fit the PDF page to the pane by width or by height, flipping between them (or to the one named, `width|height`)."},
+ {"name": "PdfSections", "leader": "SPC t s", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the PDF's sections in a pane, each a place to go."},
+ {"name": "PdfTint", "leader": "SPC t i", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Tint the PDF page to the theme, or show it as printed, stepping through them (or to the one named, `disabled|filtered|full`)."},
+ {"name": "Pet", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "An optional SDL workspace-tag companion; never consumes input or text cells."},
+ {"name": "Petscii", "leader": "SPC t p", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "glyph art over the host's pixels: an image pane's picture, or the kitty graphics a terminal's program placed (yazi's previews)"},
+ {"name": "Placement", "leader": "SPC c p", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "acme, pardes", "doc": "Where a new pane goes: acme, as makenewwindow does, or pardes, the older rules."},
+ {"name": "ProgramEsc", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "In a raw terminal, Esc goes to the program and Shift-Esc backs out, on; off (the default) swaps them."},
+ {"name": "Putall", "leader": null, "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "acme's Putall: every pane holding unsaved edits to a file is saved, each as its own Save; one that is refused (changed on disk since, a write that fails) says so and the rest are saved all the same."},
+ {"name": "Recent", "leader": "SPC f r", "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "List the files opened lately, closed ones too, each a place to open again."},
+ {"name": "Redo", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Redo the last undone edit."},
+ {"name": "Refs", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "List the references to the symbol under the cursor; with an argument (a 2-1 chord's selection), to that symbol, where it is nearest."},
+ {"name": "Rename", "leader": "SPC l r", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Rename the symbol under the cursor everywhere, to its argument."},
+ {"name": "Repl", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Binds this terminal as a language's REPL, so an exec on that language's files is typed into it instead of run."},
+ {"name": "Restore", "leader": "SPC s r", "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Replace every pane with those of a dump file, the last one Dump wrote when bare."},
+ {"name": "Right", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Move the keyboard to the pane, or column tag, to the right."},
+ {"name": "Save", "leader": "SPC f s", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Write the pane's text to its file, or to the file its argument names."},
+ {"name": "Search", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Search in a query pane under this pane, line 1 the argument (`Panes`, `Symbols lay`, `All needle`, `/re`, any of its words); bare, `/`."},
+ {"name": "SearchPane", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "reuse, new", "doc": "A search from a pane that has a query pane: reuse it, or open a new one and leave the last where it is."},
+ {"name": "SearchPlace", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "attached, column", "doc": "Where a query pane goes: attached, under the pane that asked, out of its rows alone, or column, in the finder column."},
+ {"name": "SearchRows", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "The rows a query pane is born with under its line 1, 1 through 100; default 8. It never resizes itself."},
+ {"name": "SelectRefs", "leader": "SPC l h", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Select every reference to the symbol under the cursor."},
+ {"name": "SelectionGlow", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A soft halo of the selection's colour round it in the body, on or off."},
+ {"name": "Shader", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "A Shadertoy file into the post chain, or out of it, compiled again when saved; off empties the chain."},
+ {"name": "ShaderAnimation", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "off, on, always", "doc": "When the post chain animates on its own: off, on (while focused) or always."},
+ {"name": "Shell", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "The shell new terminals run; bare, $SHELL if it is executable, else /bin/sh."},
+ {"name": "Subtypes", "leader": "SPC l T", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the subtypes of the type under the cursor."},
+ {"name": "Supertypes", "leader": "SPC l t", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the supertypes of the type under the cursor."},
+ {"name": "Symbols", "leader": "SPC l s", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the file's symbols from the language server."},
+ {"name": "SyntaxBold", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Keywords and the like are drawn bold, on or off."},
+ {"name": "Tab", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "A tab's width in cells, 1 through 16, in every pane; bare, it says the width."},
+ {"name": "Tagbottom", "leader": "SPC t b", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Each pane's tag goes at its foot rather than its head, on or off."},
+ {"name": "TaglineSize", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Scale the tag font, a percentage."},
+ {"name": "TermImages", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "real, petscii", "doc": "How a new terminal draws its program's kitty graphics: real, as pixels where it can, or petscii, as glyph art."},
+ {"name": "Theme", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Switch to the named theme."},
+ {"name": "ThemeFile", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Load a theme from a file."},
+ {"name": "Themes", "leader": "SPC t t", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "List the themes in a pane, each a word to click."},
+ {"name": "ThumbFlash", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "In a terminal, a pane's scroll thumb brightens as it scrolls and fades back, on or off."},
+ {"name": "Togglettymode", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Switch this terminal between raw program input and normal editor mode."},
+ {"name": "TreeContext", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Show the declarations enclosing the top row at the pane's head, on or off."},
+ {"name": "TreeContextTagStyle", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A pane's TreeContext rows draw in the tag's style, on or off."},
+ {"name": "Tty", "leader": "SPC n t", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "A shell in the calling pane's directory, raw from the first frame."},
+ {"name": "Tty9p", "leader": "SPC n 9", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "A Linux terminal with the current session mounted through kernel v9fs."},
+ {"name": "Tutor", "leader": "SPC h t", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the tutor, a document to work through."},
+ {"name": "Unattach", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Unattach a pane from the pane it answers for: it stays where it is, a pane of its own, and the next search from that pane opens another under it."},
+ {"name": "Undo", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Undo and Redo: step the pane's body back or forward through its edits, from a tag, a pane ctl or exec."},
+ {"name": "Unmount", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Unmount the 9P tree mounted under /n/<name>."},
+ {"name": "Up", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Move the keyboard to the pane above, and from a column's top pane to its tag."},
+ {"name": "Verbose", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A builtin says its own name on the message row as it runs, on or off."},
+ {"name": "Vignette", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off, 0-3", "doc": "The window's corners fall into shade: a level, 0 (off) through 3."},
+ {"name": "Window", "leader": "SPC w", "also": ["C-w"], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Window mode: h/j/k/l move an outline between the panes; Enter or Esc focuses the outlined pane, `:` its tag, the letter shown on a pane that one; d is Del on it (then k or j between two), c Collapse."},
+ {"name": "WindowOpacity", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "The window's opacity, a percentage."},
+ {"name": "Wrap", "leader": "SPC t w", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Long lines wrap onto the next row, on or off."},
+ {"name": "WsDiagnostics", "leader": "SPC l D", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the workspace's diagnostics from the language server."},
+ {"name": "WsSymbols", "leader": "SPC l S", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Search the workspace's symbols for its argument."},
+ {"name": "Zerox", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Zerox: a second pane on this pane's file, the same text, undo and unsaved state, with a scroll and a cursor of its own (File.zerox)."}
+]
diff --git a/docs/typ/builtins-tty.json b/docs/typ/builtins-tty.json
new file mode 100644
index 00000000..6bdca598
--- /dev/null
+++ b/docs/typ/builtins-tty.json
@@ -0,0 +1,144 @@
+[
+ {"name": "Ascii", "leader": "SPC t a", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "add the printable ASCII bitmaps to the matcher's glyph set"},
+ {"name": "Attach", "leader": "SPC s a", "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Attach this terminal to a detached pardes session by name."},
+ {"name": "Back", "leader": "SPC j o", "also": ["C-o"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Ctrl-o: one step back into the history."},
+ {"name": "BootShell", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "keep, replace", "doc": "A document dropped where a lone untouched shell stands: keep the shell, or replace it."},
+ {"name": "Callees", "leader": "SPC l C", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the functions the function under the cursor calls."},
+ {"name": "Callers", "leader": "SPC l c", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the callers of the function under the cursor."},
+ {"name": "Callstack", "leader": "SPC l b", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Show outermost callers first, with signatures and call sites (gc)."},
+ {"name": "CallstackCorners", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "rounded, square", "doc": "Callstack tree corners: rounded (the default) or square; bare, it switches styles. Applies to the next Callstack query."},
+ {"name": "CallstackDepth", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Caller levels collected by Callstack, 1 through 64; default 8. Bare, it says the current limit."},
+ {"name": "CallstackLayout", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "inline, stacked", "doc": "Callstack snippets below their locations (stacked, the default) or beside them (inline); bare, it switches layouts. Applies to the next Callstack query."},
+ {"name": "Changelog", "leader": "SPC h c", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "This build's version and what changed to reach it, printed into an output buffer the same way Config prints the live settings."},
+ {"name": "ChipShadow", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "In a terminal, a notice chip casts a cell's shadow right and down, on or off."},
+ {"name": "ClipPaste", "leader": "SPC p", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Paste the system clipboard after the selection."},
+ {"name": "ClipPasteBefore", "leader": "SPC P", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Paste the system clipboard before the selection."},
+ {"name": "ClipReplace", "leader": "SPC R", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Replace the selection with the system clipboard."},
+ {"name": "ClipYank", "leader": "SPC y", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Copy the selection to the system clipboard."},
+ {"name": "ClipYankMain", "leader": "SPC Y", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "helix `<space>Y`: the PRIMARY selection alone, where `SPC y` joins every cursor's."},
+ {"name": "CodeAction", "leader": "SPC l a", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the language server's code actions for the cursor."},
+ {"name": "Collapse", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Fold a pane to its tag, or restore its share of the column."},
+ {"name": "Colors", "leader": "SPC t c", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Syntax colours in text panes, on or off."},
+ {"name": "Config", "leader": "SPC f c", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the startup file, `init`, in a pane: its pane when it is open, else the file, else a pane of that name for Save to make it and its directory."},
+ {"name": "Debug", "leader": "SPC t d", "also": ["topbar"], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A small box of frame statistics at the top right, on or off."},
+ {"name": "Def", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Go to the definition of the symbol under the cursor; with an argument (a 2-1 chord's selection), of that symbol, where it is nearest."},
+ {"name": "Del", "leader": "SPC d", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Close the pane."},
+ {"name": "DelAbove", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Close the pane, giving its rows to the pane above it."},
+ {"name": "DelBelow", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Close the pane, giving its rows to the pane below it."},
+ {"name": "Delcol", "leader": "SPC c d", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Close this column and its panes, refusing once over unsaved text."},
+ {"name": "Detach", "leader": "SPC s D", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Detach this pardes from its terminal, leaving the session running."},
+ {"name": "Diagnostics", "leader": "SPC l d", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the file's diagnostics from the language server."},
+ {"name": "Diff", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Stack a diff's hunks as a diff viewer shows them, each under its place and the declarations around it, in a +Diff; on a +Diff, show the diff itself as text."},
+ {"name": "DiffLook", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "hunks, text", "doc": "A .diff or .patch looked at: hunks, a +Diff stacking its hunks, or text, the file itself; Diff goes from one to the other."},
+ {"name": "DirLook", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "pane, terminal", "doc": "A directory looked at: pane, a pane listing it as acme's directory window, or terminal, ls in a terminal there."},
+ {"name": "Down", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Move the keyboard to the pane below, off a tag onto the pane under it."},
+ {"name": "Dump", "leader": "SPC s d", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Write the session's panes and layout to a dump file, for Restore."},
+ {"name": "DumpConfig", "leader": null, "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the settings in effect, each a word to click, and the startup file's path."},
+ {"name": "DumpDir", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "The directory Dump writes to and a relative Restore reads from; bare, the default."},
+ {"name": "DumpThemes", "leader": null, "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Write the bundled themes into the config directory's themes, to edit."},
+ {"name": "Edit", "leader": null, "also": [], "arg": true, "scope": "both", "setting": false, "choices": null, "doc": "acme's Edit: sam's command language over the open text panes, from a tag, a pane ctl or exec, starting in the pane's body."},
+ {"name": "EffectCode", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Open the source of a panel transition or post shader, by name."},
+ {"name": "Exec", "leader": null, "also": ["tab", "middle-click"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Execute its argument as a middle click on it would, a builtin or a shell command."},
+ {"name": "Exit", "leader": "SPC q", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Quit the editor, refusing once while a pane holds unsaved text: an Exit with nothing edited since discards it."},
+ {"name": "Filter", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Recolour a terminal's or a +Pager's program colours to the theme, or show them as sent, flipping between them."},
+ {"name": "Find", "leader": "SPC f f", "also": ["topbar"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "List the files below this pane's directory whose names hold its argument, in a +Search."},
+ {"name": "FocusTint", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "The focused pane's and column's tags are tinted, on or off."},
+ {"name": "Forward", "leader": "SPC j i", "also": ["C-i"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Ctrl-i: one step forward again, up to wherever Back started."},
+ {"name": "Get", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Get: the pane's file read again, its unsaved edits refused once as Del refuses them."},
+ {"name": "Grep", "leader": "SPC f g", "also": ["topbar"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Find's sibling: Find matches file NAMES under this pane's directory, Grep matches the LINES of those files, on the disk engine's worker."},
+ {"name": "Help", "leader": "SPC ?", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the help: every key and every builtin."},
+ {"name": "Hover", "leader": "SPC l k", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Ask the language server about the symbol under the cursor."},
+ {"name": "InactiveDim", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Fade the unfocused panes' text by a percentage, 0 through 100, 0 off."},
+ {"name": "Incl", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "acme's Incl, for the session: `Incl dir ...` adds directories a look at a name found nowhere else is tried in (`stdio.h`, `<foo.h>`), bare lists them, `Incl -` empties the list."},
+ {"name": "Joincol", "leader": "SPC c j", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Fold the active pane's column into the one on its right, keeping its panes."},
+ {"name": "JumpScope", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "file, all", "doc": "What Back and Forward keep to: file, the focused pane's file until it runs out that way, or all, every place in order."},
+ {"name": "JumpTrail", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "In a terminal, a jump of the cursor leaves a short trail that fades, on or off."},
+ {"name": "Jumplist", "leader": "SPC j l", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "List the places jumped from, each a place to go."},
+ {"name": "Kill", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "acme's Kill: stop the commands pardes started -- the lines it typed into a terminal, from an exec, a middle click or a pty/run, while their shell says they run (C mark to D)."},
+ {"name": "Last", "leader": "SPC j j", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Go back to the last place jumped from in another pane."},
+ {"name": "Left", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Move the keyboard to the pane, or column tag, to the left."},
+ {"name": "LocationsConfig", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Set how location rows are drawn, or show how they are when bare."},
+ {"name": "Look", "leader": null, "also": ["enter", "right-click"], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Look at its argument: open the file or address it names, else find the word, as a right click does."},
+ {"name": "LookNext", "leader": "SPC j n", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Select the next Look location across panes; Enter opens it."},
+ {"name": "LookPrev", "leader": "SPC j p", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Select the previous Look location across panes; Enter opens it."},
+ {"name": "LookWord", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "search, list", "doc": "A plain word looked at: search selects its next place in the pane, list lists every place in a +Search."},
+ {"name": "Lspinfo", "leader": "SPC l i", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Show which language servers serve this file and their state."},
+ {"name": "Lspwhy", "leader": "SPC l w", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Explain how the last language server request was answered, step by step."},
+ {"name": "MessageAnimation", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A message falls into its row and dissolves out of it, on or off."},
+ {"name": "MessageDissolve", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "How long, in milliseconds, a message takes to dissolve."},
+ {"name": "MessageFall", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "How long, in milliseconds, a message takes to fall into its row."},
+ {"name": "MessageLinger", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "How long, in milliseconds, a message stays after what dismisses it."},
+ {"name": "Messages", "leader": "SPC h m", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the messages shown so far."},
+ {"name": "Mini", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Open a minimap of the file in braille dots."},
+ {"name": "Mode", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Cycle the pane's input modes: terminals add raw tty mode to normal/insert."},
+ {"name": "More", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "A query pane's Grep stopped at its 2000 lines goes on for 2000 more."},
+ {"name": "Motion", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "off, crisp, smooth, bouncy, playful", "doc": "How animations move: off, crisp, smooth, bouncy or playful."},
+ {"name": "Mount", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Mount another pardes's 9P tree under /n/<name>, given its dial address."},
+ {"name": "Msg", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Show its argument on this pane's message row."},
+ {"name": "New", "leader": "SPC f n", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Open an empty scratch pane, <dir>/+New, in this pane's directory."},
+ {"name": "Newcol", "leader": "SPC c n", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "An empty column right of the keyboard's, its tag taking the keyboard."},
+ {"name": "NextColor", "leader": "SPC t n", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Switch to the next bundled theme."},
+ {"name": "Pager", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "pardes, off", "doc": "What a terminal's commands page through: pardes, a +Pager pane (pardes -), or off, the environment's own; for terminals started after it."},
+ {"name": "PagerColor", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A +Pager keeps its program's colours, on or off; for the next text paged."},
+ {"name": "Palette", "leader": "SPC t l", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "the C64 palette or the terminal's own 16"},
+ {"name": "PanelAscii", "leader": "SPC a a", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close through a scatter of ASCII, on or off."},
+ {"name": "PanelCurtain", "leader": "SPC a c", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close like a curtain, on or off."},
+ {"name": "PanelDissolve", "leader": "SPC a d", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes dissolve in and out as they open and close, on or off."},
+ {"name": "PanelEdges", "leader": "SPC a e", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close from their edges, on or off."},
+ {"name": "PanelFall", "leader": "SPC a f", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes fall into place as they open, on or off."},
+ {"name": "PanelScramble", "leader": "SPC a r", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close through scrambled text, on or off."},
+ {"name": "PanelSlide", "leader": "SPC a s", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes slide in and out as they open and close, on or off."},
+ {"name": "PanelType", "leader": "SPC a t", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes type themselves in as they open, on or off."},
+ {"name": "PanelVertical", "leader": "SPC a v", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close with a vertical wipe, on or off."},
+ {"name": "PanelWave", "leader": "SPC a w", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes open and close in a wave, on or off."},
+ {"name": "PanelZoom", "leader": "SPC a z", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Panes zoom in and out as they open and close, on or off."},
+ {"name": "Panes", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Pick an open pane by its name in a query pane under this one (SPC b b)."},
+ {"name": "PdfFit", "leader": "SPC t z", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Fit the PDF page to the pane by width or by height, flipping between them (or to the one named, `width|height`)."},
+ {"name": "PdfSections", "leader": "SPC t s", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the PDF's sections in a pane, each a place to go."},
+ {"name": "PdfTint", "leader": "SPC t i", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Tint the PDF page to the theme, or show it as printed, stepping through them (or to the one named, `disabled|filtered|full`)."},
+ {"name": "Petscii", "leader": "SPC t p", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "glyph art over the host's pixels: an image pane's picture, or the kitty graphics a terminal's program placed (yazi's previews)"},
+ {"name": "Placement", "leader": "SPC c p", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "acme, pardes", "doc": "Where a new pane goes: acme, as makenewwindow does, or pardes, the older rules."},
+ {"name": "ProgramEsc", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "In a raw terminal, Esc goes to the program and Shift-Esc backs out, on; off (the default) swaps them."},
+ {"name": "Putall", "leader": null, "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "acme's Putall: every pane holding unsaved edits to a file is saved, each as its own Save; one that is refused (changed on disk since, a write that fails) says so and the rest are saved all the same."},
+ {"name": "Recent", "leader": "SPC f r", "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "List the files opened lately, closed ones too, each a place to open again."},
+ {"name": "Redo", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Redo the last undone edit."},
+ {"name": "Refs", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "List the references to the symbol under the cursor; with an argument (a 2-1 chord's selection), to that symbol, where it is nearest."},
+ {"name": "Rename", "leader": "SPC l r", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Rename the symbol under the cursor everywhere, to its argument."},
+ {"name": "Repl", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Binds this terminal as a language's REPL, so an exec on that language's files is typed into it instead of run."},
+ {"name": "Restore", "leader": "SPC s r", "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Replace every pane with those of a dump file, the last one Dump wrote when bare."},
+ {"name": "Right", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Move the keyboard to the pane, or column tag, to the right."},
+ {"name": "Save", "leader": "SPC f s", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Write the pane's text to its file, or to the file its argument names."},
+ {"name": "Search", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Search in a query pane under this pane, line 1 the argument (`Panes`, `Symbols lay`, `All needle`, `/re`, any of its words); bare, `/`."},
+ {"name": "SearchPane", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "reuse, new", "doc": "A search from a pane that has a query pane: reuse it, or open a new one and leave the last where it is."},
+ {"name": "SearchPlace", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "attached, column", "doc": "Where a query pane goes: attached, under the pane that asked, out of its rows alone, or column, in the finder column."},
+ {"name": "SearchRows", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "The rows a query pane is born with under its line 1, 1 through 100; default 8. It never resizes itself."},
+ {"name": "SelectRefs", "leader": "SPC l h", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Select every reference to the symbol under the cursor."},
+ {"name": "Shell", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "The shell new terminals run; bare, $SHELL if it is executable, else /bin/sh."},
+ {"name": "Subtypes", "leader": "SPC l T", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the subtypes of the type under the cursor."},
+ {"name": "Supertypes", "leader": "SPC l t", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the supertypes of the type under the cursor."},
+ {"name": "Symbols", "leader": "SPC l s", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the file's symbols from the language server."},
+ {"name": "SyntaxBold", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Keywords and the like are drawn bold, on or off."},
+ {"name": "Tab", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "A tab's width in cells, 1 through 16, in every pane; bare, it says the width."},
+ {"name": "Tagbottom", "leader": "SPC t b", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Each pane's tag goes at its foot rather than its head, on or off."},
+ {"name": "TermImages", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "real, petscii", "doc": "How a new terminal draws its program's kitty graphics: real, as pixels where it can, or petscii, as glyph art."},
+ {"name": "Theme", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": null, "doc": "Switch to the named theme."},
+ {"name": "ThemeFile", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Load a theme from a file."},
+ {"name": "Themes", "leader": "SPC t t", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "List the themes in a pane, each a word to click."},
+ {"name": "ThumbFlash", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "In a terminal, a pane's scroll thumb brightens as it scrolls and fades back, on or off."},
+ {"name": "Togglettymode", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Switch this terminal between raw program input and normal editor mode."},
+ {"name": "TreeContext", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Show the declarations enclosing the top row at the pane's head, on or off."},
+ {"name": "TreeContextTagStyle", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A pane's TreeContext rows draw in the tag's style, on or off."},
+ {"name": "Tty", "leader": "SPC n t", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "A shell in the calling pane's directory, raw from the first frame."},
+ {"name": "Tty9p", "leader": "SPC n 9", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "A Linux terminal with the current session mounted through kernel v9fs."},
+ {"name": "Tutor", "leader": "SPC h t", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the tutor, a document to work through."},
+ {"name": "Unattach", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Unattach a pane from the pane it answers for: it stays where it is, a pane of its own, and the next search from that pane opens another under it."},
+ {"name": "Undo", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Undo and Redo: step the pane's body back or forward through its edits, from a tag, a pane ctl or exec."},
+ {"name": "Unmount", "leader": null, "also": [], "arg": true, "scope": "root", "setting": false, "choices": null, "doc": "Unmount the 9P tree mounted under /n/<name>."},
+ {"name": "Up", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Move the keyboard to the pane above, and from a column's top pane to its tag."},
+ {"name": "Verbose", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A builtin says its own name on the message row as it runs, on or off."},
+ {"name": "Window", "leader": "SPC w", "also": ["C-w"], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Window mode: h/j/k/l move an outline between the panes; Enter or Esc focuses the outlined pane, `:` its tag, the letter shown on a pane that one; d is Del on it (then k or j between two), c Collapse."},
+ {"name": "Wrap", "leader": "SPC t w", "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "Long lines wrap onto the next row, on or off."},
+ {"name": "WsDiagnostics", "leader": "SPC l D", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the workspace's diagnostics from the language server."},
+ {"name": "WsSymbols", "leader": "SPC l S", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Search the workspace's symbols for its argument."},
+ {"name": "Zerox", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Zerox: a second pane on this pane's file, the same text, undo and unsaved state, with a scroll and a cursor of its own (File.zerox)."}
+]
diff --git a/docs/typ/builtins.typ b/docs/typ/builtins.typ
new file mode 100644
index 00000000..8375d5de
--- /dev/null
+++ b/docs/typ/builtins.typ
@@ -0,0 +1,12 @@
+// Every builtin: the words you click in a tag (Exec runs them) or type as
+// commands. The entries come from docs/typ/builtins-tty.json and
+// builtins-gui.json, which
+// `zig build builtins-json` writes from the registry and the Help rows,
+// so this chapter and Help cannot drift.
+#import "style.typ": builtin-glossary, word
+
+These are the words you click in a tag (#word("Exec") runs them) or type
+as a command, a line at a time. The everyday ones come first; the rest by
+what they are for.
+
+#builtin-glossary()
diff --git a/docs/typ/cheatsheet-a4.pdf b/docs/typ/cheatsheet-a4.pdf
new file mode 100644
index 00000000..ca589759
--- /dev/null
+++ b/docs/typ/cheatsheet-a4.pdf
@@ -0,0 +1,2091 @@
+%PDF-1.7
+%����
+
+1 0 obj
+<</Type/Pages/Count 1/Kids[417 0 R]>>
+endobj
+2 0 obj
+<</Parent 3 0 R/Title(Chords: hold the first, click the next)/Dest 381 0 R>>
+endobj
+3 0 obj
+<</Parent 16 0 R/Next 4 0 R/First 2 0 R/Last 2 0 R/Count -1/Title(The mouse)/Dest 382 0 R>>
+endobj
+4 0 obj
+<</Parent 16 0 R/Next 5 0 R/Prev 3 0 R/Title(Tags)/Dest 383 0 R>>
+endobj
+5 0 obj
+<</Parent 16 0 R/Next 6 0 R/Prev 4 0 R/Title( addresses)/Dest 384 0 R>>
+endobj
+6 0 obj
+<</Parent 16 0 R/Next 7 0 R/Prev 5 0 R/Title(Keys: normal mode)/Dest 385 0 R>>
+endobj
+7 0 obj
+<</Parent 16 0 R/Next 8 0 R/Prev 6 0 R/Title(Keys: panes)/Dest 386 0 R>>
+endobj
+8 0 obj
+<</Parent 16 0 R/Next 9 0 R/Prev 7 0 R/Title(The leader: in normal mode)/Dest 387 0 R>>
+endobj
+9 0 obj
+<</Parent 16 0 R/Next 10 0 R/Prev 8 0 R/Title(Terminals and commands)/Dest 388 0 R>>
+endobj
+10 0 obj
+<</Parent 16 0 R/Next 11 0 R/Prev 9 0 R/Title(Reviewing diffs)/Dest 389 0 R>>
+endobj
+11 0 obj
+<</Parent 16 0 R/Next 12 0 R/Prev 10 0 R/Title(Finding things)/Dest 390 0 R>>
+endobj
+12 0 obj
+<</Parent 16 0 R/Next 13 0 R/Prev 11 0 R/Title(Sessions)/Dest 391 0 R>>
+endobj
+13 0 obj
+<</Parent 16 0 R/Next 14 0 R/Prev 12 0 R/Title(Config)/Dest 392 0 R>>
+endobj
+14 0 obj
+<</Parent 16 0 R/Next 15 0 R/Prev 13 0 R/Title(Themes)/Dest 393 0 R>>
+endobj
+15 0 obj
+<</Parent 16 0 R/Prev 14 0 R/Title(The virtual filesystem (9P))/Dest 394 0 R>>
+endobj
+16 0 obj
+<</Type/Outlines/First 3 0 R/Last 15 0 R/Count 13>>
+endobj
+17 0 obj
+<</Type/StructTreeRoot/RoleMap<</Datetime/Span/Terms/Part/Title/P/Strong/Span/Em/Span>>/K[378 0 R]/ParentTree<</Nums[0 104 0 R 1 18 0 R]>>/ParentTreeNextKey 2>>
+endobj
+18 0 obj
+[19 0 R 19 0 R 20 0 R 22 0 R 22 0 R 25 0 R 25 0 R 25 0 R 28 0 R 28 0 R 28 0 R 28 0 R 28 0 R 28 0 R 30 0 R 31 0 R 31 0 R 31 0 R 31 0 R 31 0 R 31 0 R 31 0 R 31 0 R 33 0 R 34 0 R 34 0 R 34 0 R 34 0 R 37 0 R 38 0 R 39 0 R 39 0 R 41 0 R 42 0 R 44 0 R 44 0 R 45 0 R 45 0 R 45 0 R 47 0 R 48 0 R 48 0 R 48 0 R 48 0 R 48 0 R 48 0 R 48 0 R 50 0 R 51 0 R 51 0 R 51 0 R 54 0 R 54 0 R 54 0 R 54 0 R 54 0 R 54 0 R 54 0 R 54 0 R 54 0 R 54 0 R 54 0 R 55 0 R 56 0 R 56 0 R 56 0 R 56 0 R 56 0 R 56 0 R 56 0 R 56 0 R 56 0 R 56 0 R 56 0 R 56 0 R 56 0 R 57 0 R 59 0 R 59 0 R 59 0 R 59 0 R 59 0 R 58 0 R 59 0 R 61 0 R 62 0 R 62 0 R 62 0 R 62 0 R 62 0 R 62 0 R 62 0 R 62 0 R 62 0 R 62 0 R 65 0 R 65 0 R 66 0 R 66 0 R 66 0 R 66 0 R 67 0 R 68 0 R 70 0 R 71 0 R 73 0 R 75 0 R 75 0 R 74 0 R 75 0 R 77 0 R 80 0 R 80 0 R 78 0 R 80 0 R 79 0 R 80 0 R 82 0 R 84 0 R 84 0 R 84 0 R 84 0 R 84 0 R 83 0 R 86 0 R 87 0 R 87 0 R 89 0 R 91 0 R 90 0 R 91 0 R 91 0 R 99 0 R 94 0 R 99 0 R 95 0 R 99 0 R 96 0 R 99 0 R 97 0 R 99 0 R 98 0 R 99 0 R 99 0 R 99 0 R 100 0 R 105 0 R 101 0 R 105 0 R 105 0 R 102 0 R 105 0 R 103 0 R 105 0 R 105 0 R 104 0 R 105 0 R 106 0 R 106 0 R 106 0 R 106 0 R 106 0 R 106 0 R 106 0 R 106 0 R 107 0 R 109 0 R 109 0 R 109 0 R 109 0 R 109 0 R 109 0 R 110 0 R 112 0 R 112 0 R 112 0 R 112 0 R 112 0 R 112 0 R 112 0 R 113 0 R 113 0 R 115 0 R 115 0 R 115 0 R 116 0 R 118 0 R 119 0 R 121 0 R 121 0 R 121 0 R 122 0 R 124 0 R 124 0 R 124 0 R 125 0 R 127 0 R 127 0 R 128 0 R 130 0 R 130 0 R 130 0 R 130 0 R 130 0 R 130 0 R 131 0 R 131 0 R 131 0 R 133 0 R 133 0 R 134 0 R 134 0 R 136 0 R 136 0 R 137 0 R 137 0 R 139 0 R 139 0 R 139 0 R 140 0 R 142 0 R 142 0 R 142 0 R 142 0 R 142 0 R 142 0 R 143 0 R 143 0 R 145 0 R 146 0 R 146 0 R 148 0 R 148 0 R 148 0 R 148 0 R 148 0 R 148 0 R 149 0 R 149 0 R 151 0 R 151 0 R 151 0 R 151 0 R 151 0 R 151 0 R 152 0 R 154 0 R 154 0 R 155 0 R 155 0 R 155 0 R 155 0 R 155 0 R 155 0 R 155 0 R 157 0 R 158 0 R 161 0 R 162 0 R 163 0 R 163 0 R 163 0 R 165 0 R 165 0 R 165 0 R 165 0 R 165 0 R 165 0 R 165 0 R 165 0 R 165 0 R 165 0 R 165 0 R 165 0 R 164 0 R 165 0 R 167 0 R 168 0 R 168 0 R 170 0 R 170 0 R 170 0 R 171 0 R 171 0 R 171 0 R 171 0 R 171 0 R 171 0 R 173 0 R 173 0 R 173 0 R 173 0 R 173 0 R 173 0 R 174 0 R 174 0 R 174 0 R 174 0 R 174 0 R 174 0 R 174 0 R 174 0 R 174 0 R 174 0 R 174 0 R 174 0 R 174 0 R 174 0 R 176 0 R 176 0 R 176 0 R 177 0 R 179 0 R 179 0 R 179 0 R 180 0 R 180 0 R 183 0 R 183 0 R 183 0 R 184 0 R 184 0 R 184 0 R 185 0 R 185 0 R 185 0 R 185 0 R 187 0 R 187 0 R 187 0 R 187 0 R 187 0 R 188 0 R 190 0 R 190 0 R 190 0 R 190 0 R 190 0 R 191 0 R 193 0 R 193 0 R 193 0 R 193 0 R 193 0 R 194 0 R 196 0 R 196 0 R 196 0 R 196 0 R 196 0 R 197 0 R 199 0 R 199 0 R 199 0 R 199 0 R 199 0 R 200 0 R 202 0 R 202 0 R 202 0 R 202 0 R 202 0 R 203 0 R 205 0 R 205 0 R 205 0 R 206 0 R 208 0 R 208 0 R 208 0 R 208 0 R 208 0 R 209 0 R 211 0 R 211 0 R 211 0 R 211 0 R 211 0 R 212 0 R 214 0 R 214 0 R 214 0 R 215 0 R 217 0 R 217 0 R 217 0 R 217 0 R 217 0 R 218 0 R 220 0 R 220 0 R 220 0 R 220 0 R 220 0 R 221 0 R 223 0 R 223 0 R 223 0 R 224 0 R 228 0 R 228 0 R 228 0 R 229 0 R 231 0 R 231 0 R 231 0 R 231 0 R 231 0 R 232 0 R 234 0 R 234 0 R 234 0 R 234 0 R 234 0 R 235 0 R 237 0 R 237 0 R 237 0 R 237 0 R 237 0 R 238 0 R 240 0 R 240 0 R 240 0 R 240 0 R 240 0 R 241 0 R 243 0 R 243 0 R 243 0 R 243 0 R 243 0 R 244 0 R 246 0 R 246 0 R 246 0 R 246 0 R 246 0 R 247 0 R 249 0 R 249 0 R 249 0 R 249 0 R 249 0 R 250 0 R 252 0 R 252 0 R 252 0 R 252 0 R 252 0 R 253 0 R 255 0 R 255 0 R 255 0 R 255 0 R 255 0 R 256 0 R 258 0 R 258 0 R 258 0 R 258 0 R 258 0 R 259 0 R 261 0 R 261 0 R 261 0 R 261 0 R 261 0 R 262 0 R 264 0 R 264 0 R 264 0 R 265 0 R 270 0 R 271 0 R 273 0 R 273 0 R 273 0 R 273 0 R 272 0 R 273 0 R 273 0 R 273 0 R 273 0 R 273 0 R 273 0 R 273 0 R 273 0 R 275 0 R 277 0 R 276 0 R 276 0 R 277 0 R 278 0 R 278 0 R 278 0 R 280 0 R 284 0 R 284 0 R 281 0 R 284 0 R 284 0 R 284 0 R 284 0 R 284 0 R 282 0 R 284 0 R 283 0 R 284 0 R 287 0 R 288 0 R 292 0 R 292 0 R 289 0 R 292 0 R 292 0 R 290 0 R 292 0 R 291 0 R 292 0 R 292 0 R 292 0 R 293 0 R 294 0 R 298 0 R 298 0 R 295 0 R 298 0 R 298 0 R 298 0 R 296 0 R 298 0 R 297 0 R 298 0 R 298 0 R 298 0 R 298 0 R 298 0 R 298 0 R 298 0 R 298 0 R 301 0 R 302 0 R 305 0 R 303 0 R 305 0 R 305 0 R 305 0 R 304 0 R 305 0 R 305 0 R 305 0 R 305 0 R 305 0 R 306 0 R 309 0 R 309 0 R 309 0 R 309 0 R 309 0 R 309 0 R 309 0 R 309 0 R 307 0 R 309 0 R 309 0 R 309 0 R 309 0 R 308 0 R 309 0 R 309 0 R 309 0 R 309 0 R 309 0 R 309 0 R 309 0 R 309 0 R 309 0 R 310 0 R 313 0 R 313 0 R 313 0 R 313 0 R 311 0 R 313 0 R 313 0 R 313 0 R 313 0 R 313 0 R 312 0 R 313 0 R 313 0 R 314 0 R 318 0 R 315 0 R 318 0 R 316 0 R 318 0 R 318 0 R 317 0 R 318 0 R 318 0 R 319 0 R 319 0 R 319 0 R 320 0 R 323 0 R 323 0 R 325 0 R 327 0 R 327 0 R 329 0 R 329 0 R 331 0 R 331 0 R 333 0 R 333 0 R 335 0 R 335 0 R 337 0 R 339 0 R 339 0 R 342 0 R 342 0 R 344 0 R 346 0 R 346 0 R 349 0 R 349 0 R 351 0 R 353 0 R 353 0 R 355 0 R 355 0 R 355 0 R 355 0 R 355 0 R 357 0 R 357 0 R 359 0 R 361 0 R 361 0 R 363 0 R 365 0 R 365 0 R 367 0 R 367 0 R 367 0 R 369 0 R 369 0 R 371 0 R 371 0 R 371 0 R 374 0 R 374 0 R 374 0 R 374 0 R 374 0 R 374 0 R 374 0 R 375 0 R 377 0 R 376 0 R 376 0 R 377 0 R 377 0 R]
+endobj
+19 0 obj
+<</Type/StructElem/S/Span/P 378 0 R/A[<</O/Layout/Placement/Block>>]/K[0 1]/Pg 417 0 R>>
+endobj
+20 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(The mouse)/K[2]/Pg 417 0 R>>
+endobj
+21 0 obj
+<</Type/StructElem/S/TD/P 23 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[]>>
+endobj
+22 0 obj
+<</Type/StructElem/S/TD/P 23 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[3 4]/Pg 417 0 R>>
+endobj
+23 0 obj
+<</Type/StructElem/S/TR/P 36 0 R/K[21 0 R 22 0 R]>>
+endobj
+24 0 obj
+<</Type/StructElem/S/TD/P 26 0 R/A[<</O/Table/Headers[]>>]/K[]>>
+endobj
+25 0 obj
+<</Type/StructElem/S/TD/P 26 0 R/A[<</O/Table/Headers[]>>]/K[5 6 7]/Pg 417 0 R>>
+endobj
+26 0 obj
+<</Type/StructElem/S/TR/P 36 0 R/K[24 0 R 25 0 R]>>
+endobj
+27 0 obj
+<</Type/StructElem/S/TD/P 29 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[]>>
+endobj
+28 0 obj
+<</Type/StructElem/S/TD/P 29 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[8 9 10 11 12 13]/Pg 417 0 R>>
+endobj
+29 0 obj
+<</Type/StructElem/S/TR/P 36 0 R/K[27 0 R 28 0 R]>>
+endobj
+30 0 obj
+<</Type/StructElem/S/TD/P 32 0 R/A[<</O/Table/Headers[]>>]/K[14]/Pg 417 0 R>>
+endobj
+31 0 obj
+<</Type/StructElem/S/TD/P 32 0 R/A[<</O/Table/Headers[]>>]/K[15 16 17 18 19 20 21 22]/Pg 417 0 R>>
+endobj
+32 0 obj
+<</Type/StructElem/S/TR/P 36 0 R/K[30 0 R 31 0 R]>>
+endobj
+33 0 obj
+<</Type/StructElem/S/TD/P 35 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[23]/Pg 417 0 R>>
+endobj
+34 0 obj
+<</Type/StructElem/S/TD/P 35 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[24 25 26 27]/Pg 417 0 R>>
+endobj
+35 0 obj
+<</Type/StructElem/S/TR/P 36 0 R/K[33 0 R 34 0 R]>>
+endobj
+36 0 obj
+<</Type/StructElem/S/Table/P 378 0 R/K[23 0 R 26 0 R 29 0 R 32 0 R 35 0 R]>>
+endobj
+37 0 obj
+<</Type/StructElem/S/H3/P 378 0 R/T(Chords: hold the first, click the next)/K[28]/Pg 417 0 R>>
+endobj
+38 0 obj
+<</Type/StructElem/S/TD/P 40 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[29]/Pg 417 0 R>>
+endobj
+39 0 obj
+<</Type/StructElem/S/TD/P 40 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[30 31]/Pg 417 0 R>>
+endobj
+40 0 obj
+<</Type/StructElem/S/TR/P 53 0 R/K[38 0 R 39 0 R]>>
+endobj
+41 0 obj
+<</Type/StructElem/S/TD/P 43 0 R/A[<</O/Table/Headers[]>>]/K[32]/Pg 417 0 R>>
+endobj
+42 0 obj
+<</Type/StructElem/S/TD/P 43 0 R/A[<</O/Table/Headers[]>>]/K[33]/Pg 417 0 R>>
+endobj
+43 0 obj
+<</Type/StructElem/S/TR/P 53 0 R/K[41 0 R 42 0 R]>>
+endobj
+44 0 obj
+<</Type/StructElem/S/TD/P 46 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[34 35]/Pg 417 0 R>>
+endobj
+45 0 obj
+<</Type/StructElem/S/TD/P 46 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[36 37 38]/Pg 417 0 R>>
+endobj
+46 0 obj
+<</Type/StructElem/S/TR/P 53 0 R/K[44 0 R 45 0 R]>>
+endobj
+47 0 obj
+<</Type/StructElem/S/TD/P 49 0 R/A[<</O/Table/Headers[]>>]/K[39]/Pg 417 0 R>>
+endobj
+48 0 obj
+<</Type/StructElem/S/TD/P 49 0 R/A[<</O/Table/Headers[]>>]/K[40 41 42 43 44 45 46]/Pg 417 0 R>>
+endobj
+49 0 obj
+<</Type/StructElem/S/TR/P 53 0 R/K[47 0 R 48 0 R]>>
+endobj
+50 0 obj
+<</Type/StructElem/S/TD/P 52 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[47]/Pg 417 0 R>>
+endobj
+51 0 obj
+<</Type/StructElem/S/TD/P 52 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[48 49 50]/Pg 417 0 R>>
+endobj
+52 0 obj
+<</Type/StructElem/S/TR/P 53 0 R/K[50 0 R 51 0 R]>>
+endobj
+53 0 obj
+<</Type/StructElem/S/Table/P 378 0 R/K[40 0 R 43 0 R 46 0 R 49 0 R 52 0 R]>>
+endobj
+54 0 obj
+<</Type/StructElem/S/P/P 378 0 R/K[51 52 53 54 55 56 57 58 59 60 61]/Pg 417 0 R>>
+endobj
+55 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(Tags)/K[62]/Pg 417 0 R>>
+endobj
+56 0 obj
+<</Type/StructElem/S/Span/P 378 0 R/A[<</O/Layout/Placement/Block>>]/K[63 64 65 66 67 68 69 70 71 72 73 74 75]/Pg 417 0 R>>
+endobj
+57 0 obj
+<</Type/StructElem/S/Lbl/P 60 0 R/K[76]/Pg 417 0 R>>
+endobj
+58 0 obj
+<</Type/StructElem/S/Code/P 59 0 R/K[82]/Pg 417 0 R>>
+endobj
+59 0 obj
+<</Type/StructElem/S/LBody/P 60 0 R/K[77 78 79 80 81 58 0 R 83]/Pg 417 0 R>>
+endobj
+60 0 obj
+<</Type/StructElem/S/LI/P 64 0 R/K[57 0 R 59 0 R]>>
+endobj
+61 0 obj
+<</Type/StructElem/S/Lbl/P 63 0 R/K[84]/Pg 417 0 R>>
+endobj
+62 0 obj
+<</Type/StructElem/S/LBody/P 63 0 R/K[85 86 87 88 89 90 91 92 93 94]/Pg 417 0 R>>
+endobj
+63 0 obj
+<</Type/StructElem/S/LI/P 64 0 R/K[61 0 R 62 0 R]>>
+endobj
+64 0 obj
+<</Type/StructElem/S/L/P 378 0 R/A[<</O/List/ListNumbering/Circle>>]/K[60 0 R 63 0 R]>>
+endobj
+65 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T( addresses)/K[95 96]/Pg 417 0 R>>
+endobj
+66 0 obj
+<</Type/StructElem/S/P/P 378 0 R/K[97 98 99 100]/Pg 417 0 R>>
+endobj
+67 0 obj
+<</Type/StructElem/S/TD/P 69 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[101]/Pg 417 0 R>>
+endobj
+68 0 obj
+<</Type/StructElem/S/TD/P 69 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[102]/Pg 417 0 R>>
+endobj
+69 0 obj
+<</Type/StructElem/S/TR/P 93 0 R/K[67 0 R 68 0 R]>>
+endobj
+70 0 obj
+<</Type/StructElem/S/TD/P 72 0 R/A[<</O/Table/Headers[]>>]/K[103]/Pg 417 0 R>>
+endobj
+71 0 obj
+<</Type/StructElem/S/TD/P 72 0 R/A[<</O/Table/Headers[]>>]/K[104]/Pg 417 0 R>>
+endobj
+72 0 obj
+<</Type/StructElem/S/TR/P 93 0 R/K[70 0 R 71 0 R]>>
+endobj
+73 0 obj
+<</Type/StructElem/S/TD/P 76 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[105]/Pg 417 0 R>>
+endobj
+74 0 obj
+<</Type/StructElem/S/Code/P 75 0 R/K[108]/Pg 417 0 R>>
+endobj
+75 0 obj
+<</Type/StructElem/S/TD/P 76 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[106 107 74 0 R 109]/Pg 417 0 R>>
+endobj
+76 0 obj
+<</Type/StructElem/S/TR/P 93 0 R/K[73 0 R 75 0 R]>>
+endobj
+77 0 obj
+<</Type/StructElem/S/TD/P 81 0 R/A[<</O/Table/Headers[]>>]/K[110]/Pg 417 0 R>>
+endobj
+78 0 obj
+<</Type/StructElem/S/Code/P 80 0 R/K[113]/Pg 417 0 R>>
+endobj
+79 0 obj
+<</Type/StructElem/S/Code/P 80 0 R/K[115]/Pg 417 0 R>>
+endobj
+80 0 obj
+<</Type/StructElem/S/TD/P 81 0 R/A[<</O/Table/Headers[]>>]/K[111 112 78 0 R 114 79 0 R 116]/Pg 417 0 R>>
+endobj
+81 0 obj
+<</Type/StructElem/S/TR/P 93 0 R/K[77 0 R 80 0 R]>>
+endobj
+82 0 obj
+<</Type/StructElem/S/TD/P 85 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[117]/Pg 417 0 R>>
+endobj
+83 0 obj
+<</Type/StructElem/S/Code/P 84 0 R/K[123]/Pg 417 0 R>>
+endobj
+84 0 obj
+<</Type/StructElem/S/TD/P 85 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[118 119 120 121 122 83 0 R]/Pg 417 0 R>>
+endobj
+85 0 obj
+<</Type/StructElem/S/TR/P 93 0 R/K[82 0 R 84 0 R]>>
+endobj
+86 0 obj
+<</Type/StructElem/S/TD/P 88 0 R/A[<</O/Table/Headers[]>>]/K[124]/Pg 417 0 R>>
+endobj
+87 0 obj
+<</Type/StructElem/S/TD/P 88 0 R/A[<</O/Table/Headers[]>>]/K[125 126]/Pg 417 0 R>>
+endobj
+88 0 obj
+<</Type/StructElem/S/TR/P 93 0 R/K[86 0 R 87 0 R]>>
+endobj
+89 0 obj
+<</Type/StructElem/S/TD/P 92 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[127]/Pg 417 0 R>>
+endobj
+90 0 obj
+<</Type/StructElem/S/Code/P 91 0 R/K[129]/Pg 417 0 R>>
+endobj
+91 0 obj
+<</Type/StructElem/S/TD/P 92 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[128 90 0 R 130 131]/Pg 417 0 R>>
+endobj
+92 0 obj
+<</Type/StructElem/S/TR/P 93 0 R/K[89 0 R 91 0 R]>>
+endobj
+93 0 obj
+<</Type/StructElem/S/Table/P 378 0 R/K[69 0 R 72 0 R 76 0 R 81 0 R 85 0 R 88 0 R 92 0 R]>>
+endobj
+94 0 obj
+<</Type/StructElem/S/Code/P 99 0 R/K[133]/Pg 417 0 R>>
+endobj
+95 0 obj
+<</Type/StructElem/S/Code/P 99 0 R/K[135]/Pg 417 0 R>>
+endobj
+96 0 obj
+<</Type/StructElem/S/Code/P 99 0 R/K[137]/Pg 417 0 R>>
+endobj
+97 0 obj
+<</Type/StructElem/S/Code/P 99 0 R/K[139]/Pg 417 0 R>>
+endobj
+98 0 obj
+<</Type/StructElem/S/Code/P 99 0 R/K[141]/Pg 417 0 R>>
+endobj
+99 0 obj
+<</Type/StructElem/S/P/P 378 0 R/K[132 94 0 R 134 95 0 R 136 96 0 R 138 97 0 R 140 98 0 R 142 143 144]/Pg 417 0 R>>
+endobj
+100 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(Keys: normal mode)/K[145]/Pg 417 0 R>>
+endobj
+101 0 obj
+<</Type/StructElem/S/Strong/P 105 0 R/K[147]/Pg 417 0 R>>
+endobj
+102 0 obj
+<</Type/StructElem/S/Code/P 105 0 R/K[150]/Pg 417 0 R>>
+endobj
+103 0 obj
+<</Type/StructElem/S/Code/P 105 0 R/K[152]/Pg 417 0 R>>
+endobj
+104 0 obj
+<</Type/StructElem/S/Link/P 105 0 R/K[155<</Type/OBJR/Pg 417 0 R/Obj 379 0 R>>]/Pg 417 0 R>>
+endobj
+105 0 obj
+<</Type/StructElem/S/P/P 378 0 R/K[146 101 0 R 148 149 102 0 R 151 103 0 R 153 154 104 0 R 156]/Pg 417 0 R>>
+endobj
+106 0 obj
+<</Type/StructElem/S/TD/P 108 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[157 158 159 160 161 162 163 164]/Pg 417 0 R>>
+endobj
+107 0 obj
+<</Type/StructElem/S/TD/P 108 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[165]/Pg 417 0 R>>
+endobj
+108 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[106 0 R 107 0 R]>>
+endobj
+109 0 obj
+<</Type/StructElem/S/TD/P 111 0 R/A[<</O/Table/Headers[]>>]/K[166 167 168 169 170 171]/Pg 417 0 R>>
+endobj
+110 0 obj
+<</Type/StructElem/S/TD/P 111 0 R/A[<</O/Table/Headers[]>>]/K[172]/Pg 417 0 R>>
+endobj
+111 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[109 0 R 110 0 R]>>
+endobj
+112 0 obj
+<</Type/StructElem/S/TD/P 114 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[173 174 175 176 177 178 179]/Pg 417 0 R>>
+endobj
+113 0 obj
+<</Type/StructElem/S/TD/P 114 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[180 181]/Pg 417 0 R>>
+endobj
+114 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[112 0 R 113 0 R]>>
+endobj
+115 0 obj
+<</Type/StructElem/S/TD/P 117 0 R/A[<</O/Table/Headers[]>>]/K[182 183 184]/Pg 417 0 R>>
+endobj
+116 0 obj
+<</Type/StructElem/S/TD/P 117 0 R/A[<</O/Table/Headers[]>>]/K[185]/Pg 417 0 R>>
+endobj
+117 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[115 0 R 116 0 R]>>
+endobj
+118 0 obj
+<</Type/StructElem/S/TD/P 120 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[186]/Pg 417 0 R>>
+endobj
+119 0 obj
+<</Type/StructElem/S/TD/P 120 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[187]/Pg 417 0 R>>
+endobj
+120 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[118 0 R 119 0 R]>>
+endobj
+121 0 obj
+<</Type/StructElem/S/TD/P 123 0 R/A[<</O/Table/Headers[]>>]/K[188 189 190]/Pg 417 0 R>>
+endobj
+122 0 obj
+<</Type/StructElem/S/TD/P 123 0 R/A[<</O/Table/Headers[]>>]/K[191]/Pg 417 0 R>>
+endobj
+123 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[121 0 R 122 0 R]>>
+endobj
+124 0 obj
+<</Type/StructElem/S/TD/P 126 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[192 193 194]/Pg 417 0 R>>
+endobj
+125 0 obj
+<</Type/StructElem/S/TD/P 126 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[195]/Pg 417 0 R>>
+endobj
+126 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[124 0 R 125 0 R]>>
+endobj
+127 0 obj
+<</Type/StructElem/S/TD/P 129 0 R/A[<</O/Table/Headers[]>>]/K[196 197]/Pg 417 0 R>>
+endobj
+128 0 obj
+<</Type/StructElem/S/TD/P 129 0 R/A[<</O/Table/Headers[]>>]/K[198]/Pg 417 0 R>>
+endobj
+129 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[127 0 R 128 0 R]>>
+endobj
+130 0 obj
+<</Type/StructElem/S/TD/P 132 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[199 200 201 202 203 204]/Pg 417 0 R>>
+endobj
+131 0 obj
+<</Type/StructElem/S/TD/P 132 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[205 206 207]/Pg 417 0 R>>
+endobj
+132 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[130 0 R 131 0 R]>>
+endobj
+133 0 obj
+<</Type/StructElem/S/TD/P 135 0 R/A[<</O/Table/Headers[]>>]/K[208 209]/Pg 417 0 R>>
+endobj
+134 0 obj
+<</Type/StructElem/S/TD/P 135 0 R/A[<</O/Table/Headers[]>>]/K[210 211]/Pg 417 0 R>>
+endobj
+135 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[133 0 R 134 0 R]>>
+endobj
+136 0 obj
+<</Type/StructElem/S/TD/P 138 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[212 213]/Pg 417 0 R>>
+endobj
+137 0 obj
+<</Type/StructElem/S/TD/P 138 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[214 215]/Pg 417 0 R>>
+endobj
+138 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[136 0 R 137 0 R]>>
+endobj
+139 0 obj
+<</Type/StructElem/S/TD/P 141 0 R/A[<</O/Table/Headers[]>>]/K[216 217 218]/Pg 417 0 R>>
+endobj
+140 0 obj
+<</Type/StructElem/S/TD/P 141 0 R/A[<</O/Table/Headers[]>>]/K[219]/Pg 417 0 R>>
+endobj
+141 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[139 0 R 140 0 R]>>
+endobj
+142 0 obj
+<</Type/StructElem/S/TD/P 144 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[220 221 222 223 224 225]/Pg 417 0 R>>
+endobj
+143 0 obj
+<</Type/StructElem/S/TD/P 144 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[226 227]/Pg 417 0 R>>
+endobj
+144 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[142 0 R 143 0 R]>>
+endobj
+145 0 obj
+<</Type/StructElem/S/TD/P 147 0 R/A[<</O/Table/Headers[]>>]/K[228]/Pg 417 0 R>>
+endobj
+146 0 obj
+<</Type/StructElem/S/TD/P 147 0 R/A[<</O/Table/Headers[]>>]/K[229 230]/Pg 417 0 R>>
+endobj
+147 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[145 0 R 146 0 R]>>
+endobj
+148 0 obj
+<</Type/StructElem/S/TD/P 150 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[231 232 233 234 235 236]/Pg 417 0 R>>
+endobj
+149 0 obj
+<</Type/StructElem/S/TD/P 150 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[237 238]/Pg 417 0 R>>
+endobj
+150 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[148 0 R 149 0 R]>>
+endobj
+151 0 obj
+<</Type/StructElem/S/TD/P 153 0 R/A[<</O/Table/Headers[]>>]/K[239 240 241 242 243 244]/Pg 417 0 R>>
+endobj
+152 0 obj
+<</Type/StructElem/S/TD/P 153 0 R/A[<</O/Table/Headers[]>>]/K[245]/Pg 417 0 R>>
+endobj
+153 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[151 0 R 152 0 R]>>
+endobj
+154 0 obj
+<</Type/StructElem/S/TD/P 156 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[246 247]/Pg 417 0 R>>
+endobj
+155 0 obj
+<</Type/StructElem/S/TD/P 156 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[248 249 250 251 252 253 254]/Pg 417 0 R>>
+endobj
+156 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[154 0 R 155 0 R]>>
+endobj
+157 0 obj
+<</Type/StructElem/S/TD/P 159 0 R/A[<</O/Table/Headers[]>>]/K[255]/Pg 417 0 R>>
+endobj
+158 0 obj
+<</Type/StructElem/S/TD/P 159 0 R/A[<</O/Table/Headers[]>>]/K[256]/Pg 417 0 R>>
+endobj
+159 0 obj
+<</Type/StructElem/S/TR/P 160 0 R/K[157 0 R 158 0 R]>>
+endobj
+160 0 obj
+<</Type/StructElem/S/Table/P 378 0 R/K[108 0 R 111 0 R 114 0 R 117 0 R 120 0 R 123 0 R 126 0 R 129 0 R 132 0 R 135 0 R 138 0 R 141 0 R 144 0 R 147 0 R 150 0 R 153 0 R 156 0 R 159 0 R]>>
+endobj
+161 0 obj
+<</Type/StructElem/S/P/P 378 0 R/K[257]/Pg 417 0 R>>
+endobj
+162 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(Keys: panes)/K[258]/Pg 417 0 R>>
+endobj
+163 0 obj
+<</Type/StructElem/S/TD/P 166 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[259 260 261]/Pg 417 0 R>>
+endobj
+164 0 obj
+<</Type/StructElem/S/Code/P 165 0 R/K[274]/Pg 417 0 R>>
+endobj
+165 0 obj
+<</Type/StructElem/S/TD/P 166 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[262 263 264 265 266 267 268 269 270 271 272 273 164 0 R 275]/Pg 417 0 R>>
+endobj
+166 0 obj
+<</Type/StructElem/S/TR/P 182 0 R/K[163 0 R 165 0 R]>>
+endobj
+167 0 obj
+<</Type/StructElem/S/TD/P 169 0 R/A[<</O/Table/Headers[]>>]/K[276]/Pg 417 0 R>>
+endobj
+168 0 obj
+<</Type/StructElem/S/TD/P 169 0 R/A[<</O/Table/Headers[]>>]/K[277 278]/Pg 417 0 R>>
+endobj
+169 0 obj
+<</Type/StructElem/S/TR/P 182 0 R/K[167 0 R 168 0 R]>>
+endobj
+170 0 obj
+<</Type/StructElem/S/TD/P 172 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[279 280 281]/Pg 417 0 R>>
+endobj
+171 0 obj
+<</Type/StructElem/S/TD/P 172 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[282 283 284 285 286 287]/Pg 417 0 R>>
+endobj
+172 0 obj
+<</Type/StructElem/S/TR/P 182 0 R/K[170 0 R 171 0 R]>>
+endobj
+173 0 obj
+<</Type/StructElem/S/TD/P 175 0 R/A[<</O/Table/Headers[]>>]/K[288 289 290 291 292 293]/Pg 417 0 R>>
+endobj
+174 0 obj
+<</Type/StructElem/S/TD/P 175 0 R/A[<</O/Table/Headers[]>>]/K[294 295 296 297 298 299 300 301 302 303 304 305 306 307]/Pg 417 0 R>>
+endobj
+175 0 obj
+<</Type/StructElem/S/TR/P 182 0 R/K[173 0 R 174 0 R]>>
+endobj
+176 0 obj
+<</Type/StructElem/S/TD/P 178 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[308 309 310]/Pg 417 0 R>>
+endobj
+177 0 obj
+<</Type/StructElem/S/TD/P 178 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[311]/Pg 417 0 R>>
+endobj
+178 0 obj
+<</Type/StructElem/S/TR/P 182 0 R/K[176 0 R 177 0 R]>>
+endobj
+179 0 obj
+<</Type/StructElem/S/TD/P 181 0 R/A[<</O/Table/Headers[]>>]/K[312 313 314]/Pg 417 0 R>>
+endobj
+180 0 obj
+<</Type/StructElem/S/TD/P 181 0 R/A[<</O/Table/Headers[]>>]/K[315 316]/Pg 417 0 R>>
+endobj
+181 0 obj
+<</Type/StructElem/S/TR/P 182 0 R/K[179 0 R 180 0 R]>>
+endobj
+182 0 obj
+<</Type/StructElem/S/Table/P 378 0 R/K[166 0 R 169 0 R 172 0 R 175 0 R 178 0 R 181 0 R]>>
+endobj
+183 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(The leader: in normal mode)/K[317 318 319]/Pg 417 0 R>>
+endobj
+184 0 obj
+<</Type/StructElem/S/TD/P 186 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[320 321 322]/Pg 417 0 R>>
+endobj
+185 0 obj
+<</Type/StructElem/S/TD/P 186 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[323 324 325 326]/Pg 417 0 R>>
+endobj
+186 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[184 0 R 185 0 R]>>
+endobj
+187 0 obj
+<</Type/StructElem/S/TD/P 189 0 R/A[<</O/Table/Headers[]>>]/K[327 328 329 330 331]/Pg 417 0 R>>
+endobj
+188 0 obj
+<</Type/StructElem/S/TD/P 189 0 R/A[<</O/Table/Headers[]>>]/K[332]/Pg 417 0 R>>
+endobj
+189 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[187 0 R 188 0 R]>>
+endobj
+190 0 obj
+<</Type/StructElem/S/TD/P 192 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[333 334 335 336 337]/Pg 417 0 R>>
+endobj
+191 0 obj
+<</Type/StructElem/S/TD/P 192 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[338]/Pg 417 0 R>>
+endobj
+192 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[190 0 R 191 0 R]>>
+endobj
+193 0 obj
+<</Type/StructElem/S/TD/P 195 0 R/A[<</O/Table/Headers[]>>]/K[339 340 341 342 343]/Pg 417 0 R>>
+endobj
+194 0 obj
+<</Type/StructElem/S/TD/P 195 0 R/A[<</O/Table/Headers[]>>]/K[344]/Pg 417 0 R>>
+endobj
+195 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[193 0 R 194 0 R]>>
+endobj
+196 0 obj
+<</Type/StructElem/S/TD/P 198 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[345 346 347 348 349]/Pg 417 0 R>>
+endobj
+197 0 obj
+<</Type/StructElem/S/TD/P 198 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[350]/Pg 417 0 R>>
+endobj
+198 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[196 0 R 197 0 R]>>
+endobj
+199 0 obj
+<</Type/StructElem/S/TD/P 201 0 R/A[<</O/Table/Headers[]>>]/K[351 352 353 354 355]/Pg 417 0 R>>
+endobj
+200 0 obj
+<</Type/StructElem/S/TD/P 201 0 R/A[<</O/Table/Headers[]>>]/K[356]/Pg 417 0 R>>
+endobj
+201 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[199 0 R 200 0 R]>>
+endobj
+202 0 obj
+<</Type/StructElem/S/TD/P 204 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[357 358 359 360 361]/Pg 417 0 R>>
+endobj
+203 0 obj
+<</Type/StructElem/S/TD/P 204 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[362]/Pg 417 0 R>>
+endobj
+204 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[202 0 R 203 0 R]>>
+endobj
+205 0 obj
+<</Type/StructElem/S/TD/P 207 0 R/A[<</O/Table/Headers[]>>]/K[363 364 365]/Pg 417 0 R>>
+endobj
+206 0 obj
+<</Type/StructElem/S/TD/P 207 0 R/A[<</O/Table/Headers[]>>]/K[366]/Pg 417 0 R>>
+endobj
+207 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[205 0 R 206 0 R]>>
+endobj
+208 0 obj
+<</Type/StructElem/S/TD/P 210 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[367 368 369 370 371]/Pg 417 0 R>>
+endobj
+209 0 obj
+<</Type/StructElem/S/TD/P 210 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[372]/Pg 417 0 R>>
+endobj
+210 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[208 0 R 209 0 R]>>
+endobj
+211 0 obj
+<</Type/StructElem/S/TD/P 213 0 R/A[<</O/Table/Headers[]>>]/K[373 374 375 376 377]/Pg 417 0 R>>
+endobj
+212 0 obj
+<</Type/StructElem/S/TD/P 213 0 R/A[<</O/Table/Headers[]>>]/K[378]/Pg 417 0 R>>
+endobj
+213 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[211 0 R 212 0 R]>>
+endobj
+214 0 obj
+<</Type/StructElem/S/TD/P 216 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[379 380 381]/Pg 417 0 R>>
+endobj
+215 0 obj
+<</Type/StructElem/S/TD/P 216 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[382]/Pg 417 0 R>>
+endobj
+216 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[214 0 R 215 0 R]>>
+endobj
+217 0 obj
+<</Type/StructElem/S/TD/P 219 0 R/A[<</O/Table/Headers[]>>]/K[383 384 385 386 387]/Pg 417 0 R>>
+endobj
+218 0 obj
+<</Type/StructElem/S/TD/P 219 0 R/A[<</O/Table/Headers[]>>]/K[388]/Pg 417 0 R>>
+endobj
+219 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[217 0 R 218 0 R]>>
+endobj
+220 0 obj
+<</Type/StructElem/S/TD/P 222 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[389 390 391 392 393]/Pg 417 0 R>>
+endobj
+221 0 obj
+<</Type/StructElem/S/TD/P 222 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[394]/Pg 417 0 R>>
+endobj
+222 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[220 0 R 221 0 R]>>
+endobj
+223 0 obj
+<</Type/StructElem/S/TD/P 225 0 R/A[<</O/Table/Headers[]>>]/K[395 396 397]/Pg 417 0 R>>
+endobj
+224 0 obj
+<</Type/StructElem/S/TD/P 225 0 R/A[<</O/Table/Headers[]>>]/K[398]/Pg 417 0 R>>
+endobj
+225 0 obj
+<</Type/StructElem/S/TR/P 226 0 R/K[223 0 R 224 0 R]>>
+endobj
+226 0 obj
+<</Type/StructElem/S/Table/P 227 0 R/K[186 0 R 189 0 R 192 0 R 195 0 R 198 0 R 201 0 R 204 0 R 207 0 R 210 0 R 213 0 R 216 0 R 219 0 R 222 0 R 225 0 R]>>
+endobj
+227 0 obj
+<</Type/StructElem/S/Div/P 269 0 R/K[226 0 R]>>
+endobj
+228 0 obj
+<</Type/StructElem/S/TD/P 230 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[399 400 401]/Pg 417 0 R>>
+endobj
+229 0 obj
+<</Type/StructElem/S/TD/P 230 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[402]/Pg 417 0 R>>
+endobj
+230 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[228 0 R 229 0 R]>>
+endobj
+231 0 obj
+<</Type/StructElem/S/TD/P 233 0 R/A[<</O/Table/Headers[]>>]/K[403 404 405 406 407]/Pg 417 0 R>>
+endobj
+232 0 obj
+<</Type/StructElem/S/TD/P 233 0 R/A[<</O/Table/Headers[]>>]/K[408]/Pg 417 0 R>>
+endobj
+233 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[231 0 R 232 0 R]>>
+endobj
+234 0 obj
+<</Type/StructElem/S/TD/P 236 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[409 410 411 412 413]/Pg 417 0 R>>
+endobj
+235 0 obj
+<</Type/StructElem/S/TD/P 236 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[414]/Pg 417 0 R>>
+endobj
+236 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[234 0 R 235 0 R]>>
+endobj
+237 0 obj
+<</Type/StructElem/S/TD/P 239 0 R/A[<</O/Table/Headers[]>>]/K[415 416 417 418 419]/Pg 417 0 R>>
+endobj
+238 0 obj
+<</Type/StructElem/S/TD/P 239 0 R/A[<</O/Table/Headers[]>>]/K[420]/Pg 417 0 R>>
+endobj
+239 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[237 0 R 238 0 R]>>
+endobj
+240 0 obj
+<</Type/StructElem/S/TD/P 242 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[421 422 423 424 425]/Pg 417 0 R>>
+endobj
+241 0 obj
+<</Type/StructElem/S/TD/P 242 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[426]/Pg 417 0 R>>
+endobj
+242 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[240 0 R 241 0 R]>>
+endobj
+243 0 obj
+<</Type/StructElem/S/TD/P 245 0 R/A[<</O/Table/Headers[]>>]/K[427 428 429 430 431]/Pg 417 0 R>>
+endobj
+244 0 obj
+<</Type/StructElem/S/TD/P 245 0 R/A[<</O/Table/Headers[]>>]/K[432]/Pg 417 0 R>>
+endobj
+245 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[243 0 R 244 0 R]>>
+endobj
+246 0 obj
+<</Type/StructElem/S/TD/P 248 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[433 434 435 436 437]/Pg 417 0 R>>
+endobj
+247 0 obj
+<</Type/StructElem/S/TD/P 248 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[438]/Pg 417 0 R>>
+endobj
+248 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[246 0 R 247 0 R]>>
+endobj
+249 0 obj
+<</Type/StructElem/S/TD/P 251 0 R/A[<</O/Table/Headers[]>>]/K[439 440 441 442 443]/Pg 417 0 R>>
+endobj
+250 0 obj
+<</Type/StructElem/S/TD/P 251 0 R/A[<</O/Table/Headers[]>>]/K[444]/Pg 417 0 R>>
+endobj
+251 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[249 0 R 250 0 R]>>
+endobj
+252 0 obj
+<</Type/StructElem/S/TD/P 254 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[445 446 447 448 449]/Pg 417 0 R>>
+endobj
+253 0 obj
+<</Type/StructElem/S/TD/P 254 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[450]/Pg 417 0 R>>
+endobj
+254 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[252 0 R 253 0 R]>>
+endobj
+255 0 obj
+<</Type/StructElem/S/TD/P 257 0 R/A[<</O/Table/Headers[]>>]/K[451 452 453 454 455]/Pg 417 0 R>>
+endobj
+256 0 obj
+<</Type/StructElem/S/TD/P 257 0 R/A[<</O/Table/Headers[]>>]/K[456]/Pg 417 0 R>>
+endobj
+257 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[255 0 R 256 0 R]>>
+endobj
+258 0 obj
+<</Type/StructElem/S/TD/P 260 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[457 458 459 460 461]/Pg 417 0 R>>
+endobj
+259 0 obj
+<</Type/StructElem/S/TD/P 260 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[462]/Pg 417 0 R>>
+endobj
+260 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[258 0 R 259 0 R]>>
+endobj
+261 0 obj
+<</Type/StructElem/S/TD/P 263 0 R/A[<</O/Table/Headers[]>>]/K[463 464 465 466 467]/Pg 417 0 R>>
+endobj
+262 0 obj
+<</Type/StructElem/S/TD/P 263 0 R/A[<</O/Table/Headers[]>>]/K[468]/Pg 417 0 R>>
+endobj
+263 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[261 0 R 262 0 R]>>
+endobj
+264 0 obj
+<</Type/StructElem/S/TD/P 266 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[469 470 471]/Pg 417 0 R>>
+endobj
+265 0 obj
+<</Type/StructElem/S/TD/P 266 0 R/A[<</O/Table/Headers[]>><</O/Layout/BackgroundColor[0.89411765 0.9411765 0.92941177]>>]/K[472]/Pg 417 0 R>>
+endobj
+266 0 obj
+<</Type/StructElem/S/TR/P 267 0 R/K[264 0 R 265 0 R]>>
+endobj
+267 0 obj
+<</Type/StructElem/S/Table/P 268 0 R/K[230 0 R 233 0 R 236 0 R 239 0 R 242 0 R 245 0 R 248 0 R 251 0 R 254 0 R 257 0 R 260 0 R 263 0 R 266 0 R]>>
+endobj
+268 0 obj
+<</Type/StructElem/S/Div/P 269 0 R/K[267 0 R]>>
+endobj
+269 0 obj
+<</Type/StructElem/S/Div/P 378 0 R/K[227 0 R 268 0 R]>>
+endobj
+270 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(Terminals and commands)/K[473]/Pg 417 0 R>>
+endobj
+271 0 obj
+<</Type/StructElem/S/Lbl/P 274 0 R/K[474]/Pg 417 0 R>>
+endobj
+272 0 obj
+<</Type/StructElem/S/Code/P 273 0 R/K[479]/Pg 417 0 R>>
+endobj
+273 0 obj
+<</Type/StructElem/S/LBody/P 274 0 R/K[475 476 477 478 272 0 R 480 481 482 483 484 485 486 487]/Pg 417 0 R>>
+endobj
+274 0 obj
+<</Type/StructElem/S/LI/P 286 0 R/K[271 0 R 273 0 R]>>
+endobj
+275 0 obj
+<</Type/StructElem/S/Lbl/P 279 0 R/K[488]/Pg 417 0 R>>
+endobj
+276 0 obj
+<</Type/StructElem/S/Strong/P 277 0 R/K[490 491]/Pg 417 0 R>>
+endobj
+277 0 obj
+<</Type/StructElem/S/P/P 278 0 R/K[489 276 0 R 492]/Pg 417 0 R>>
+endobj
+278 0 obj
+<</Type/StructElem/S/LBody/P 279 0 R/K[277 0 R 493 494 495]/Pg 417 0 R>>
+endobj
+279 0 obj
+<</Type/StructElem/S/LI/P 286 0 R/K[275 0 R 278 0 R]>>
+endobj
+280 0 obj
+<</Type/StructElem/S/Lbl/P 285 0 R/K[496]/Pg 417 0 R>>
+endobj
+281 0 obj
+<</Type/StructElem/S/Code/P 284 0 R/K[499]/Pg 417 0 R>>
+endobj
+282 0 obj
+<</Type/StructElem/S/Code/P 284 0 R/K[505]/Pg 417 0 R>>
+endobj
+283 0 obj
+<</Type/StructElem/S/Code/P 284 0 R/K[507]/Pg 417 0 R>>
+endobj
+284 0 obj
+<</Type/StructElem/S/LBody/P 285 0 R/K[497 498 281 0 R 500 501 502 503 504 282 0 R 506 283 0 R 508]/Pg 417 0 R>>
+endobj
+285 0 obj
+<</Type/StructElem/S/LI/P 286 0 R/K[280 0 R 284 0 R]>>
+endobj
+286 0 obj
+<</Type/StructElem/S/L/P 378 0 R/A[<</O/List/ListNumbering/Circle>>]/K[274 0 R 279 0 R 285 0 R]>>
+endobj
+287 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(Reviewing diffs)/K[509]/Pg 417 0 R>>
+endobj
+288 0 obj
+<</Type/StructElem/S/Code/P 292 0 R/K[510]/Pg 417 0 R>>
+endobj
+289 0 obj
+<</Type/StructElem/S/Code/P 292 0 R/K[513]/Pg 417 0 R>>
+endobj
+290 0 obj
+<</Type/StructElem/S/Code/P 292 0 R/K[516]/Pg 417 0 R>>
+endobj
+291 0 obj
+<</Type/StructElem/S/Code/P 292 0 R/K[518]/Pg 417 0 R>>
+endobj
+292 0 obj
+<</Type/StructElem/S/P/P 378 0 R/K[288 0 R 511 512 289 0 R 514 515 290 0 R 517 291 0 R 519 520 521]/Pg 417 0 R>>
+endobj
+293 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(Finding things)/K[522]/Pg 417 0 R>>
+endobj
+294 0 obj
+<</Type/StructElem/S/Lbl/P 299 0 R/K[523]/Pg 417 0 R>>
+endobj
+295 0 obj
+<</Type/StructElem/S/Code/P 298 0 R/K[526]/Pg 417 0 R>>
+endobj
+296 0 obj
+<</Type/StructElem/S/Code/P 298 0 R/K[530]/Pg 417 0 R>>
+endobj
+297 0 obj
+<</Type/StructElem/S/Code/P 298 0 R/K[532]/Pg 417 0 R>>
+endobj
+298 0 obj
+<</Type/StructElem/S/LBody/P 299 0 R/K[524 525 295 0 R 527 528 529 296 0 R 531 297 0 R 533 534 535 536 537 538 539 540]/Pg 417 0 R>>
+endobj
+299 0 obj
+<</Type/StructElem/S/LI/P 300 0 R/K[294 0 R 298 0 R]>>
+endobj
+300 0 obj
+<</Type/StructElem/S/L/P 378 0 R/A[<</O/List/ListNumbering/Circle>>]/K[299 0 R]>>
+endobj
+301 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(Sessions)/K[541]/Pg 417 0 R>>
+endobj
+302 0 obj
+<</Type/StructElem/S/Code/P 305 0 R/K[542]/Pg 417 0 R>>
+endobj
+303 0 obj
+<</Type/StructElem/S/Code/P 305 0 R/K[544]/Pg 417 0 R>>
+endobj
+304 0 obj
+<</Type/StructElem/S/Code/P 305 0 R/K[548]/Pg 417 0 R>>
+endobj
+305 0 obj
+<</Type/StructElem/S/P/P 378 0 R/K[302 0 R 543 303 0 R 545 546 547 304 0 R 549 550 551 552 553]/Pg 417 0 R>>
+endobj
+306 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(Config)/K[554]/Pg 417 0 R>>
+endobj
+307 0 obj
+<</Type/StructElem/S/Code/P 309 0 R/K[563]/Pg 417 0 R>>
+endobj
+308 0 obj
+<</Type/StructElem/S/Code/P 309 0 R/K[568]/Pg 417 0 R>>
+endobj
+309 0 obj
+<</Type/StructElem/S/P/P 378 0 R/K[555 556 557 558 559 560 561 562 307 0 R 564 565 566 567 308 0 R 569 570 571 572 573 574 575 576 577]/Pg 417 0 R>>
+endobj
+310 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(Themes)/K[578]/Pg 417 0 R>>
+endobj
+311 0 obj
+<</Type/StructElem/S/Code/P 313 0 R/K[583]/Pg 417 0 R>>
+endobj
+312 0 obj
+<</Type/StructElem/S/Code/P 313 0 R/K[589]/Pg 417 0 R>>
+endobj
+313 0 obj
+<</Type/StructElem/S/P/P 378 0 R/K[579 580 581 582 311 0 R 584 585 586 587 588 312 0 R 590 591]/Pg 417 0 R>>
+endobj
+314 0 obj
+<</Type/StructElem/S/H2/P 378 0 R/T(The virtual filesystem (9P))/K[592]/Pg 417 0 R>>
+endobj
+315 0 obj
+<</Type/StructElem/S/Code/P 318 0 R/K[594]/Pg 417 0 R>>
+endobj
+316 0 obj
+<</Type/StructElem/S/Code/P 318 0 R/K[596]/Pg 417 0 R>>
+endobj
+317 0 obj
+<</Type/StructElem/S/Code/P 318 0 R/K[599]/Pg 417 0 R>>
+endobj
+318 0 obj
+<</Type/StructElem/S/P/P 378 0 R/K[593 315 0 R 595 316 0 R 597 598 317 0 R 600 601]/Pg 417 0 R>>
+endobj
+319 0 obj
+<</Type/StructElem/S/Span/P 378 0 R/A[<</O/Layout/Placement/Block>>]/K[602 603 604]/Pg 417 0 R>>
+endobj
+320 0 obj
+<</Type/StructElem/S/Span/P 321 0 R/A[<</O/Layout/Placement/Block>>]/K[605]/Pg 417 0 R>>
+endobj
+321 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[320 0 R]>>
+endobj
+322 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[]>>
+endobj
+323 0 obj
+<</Type/StructElem/S/Span/P 324 0 R/A[<</O/Layout/Placement/Block>>]/K[606 607]/Pg 417 0 R>>
+endobj
+324 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[323 0 R]>>
+endobj
+325 0 obj
+<</Type/StructElem/S/Span/P 326 0 R/A[<</O/Layout/Placement/Block>>]/K[608]/Pg 417 0 R>>
+endobj
+326 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[325 0 R]>>
+endobj
+327 0 obj
+<</Type/StructElem/S/Span/P 328 0 R/A[<</O/Layout/Placement/Block>>]/K[609 610]/Pg 417 0 R>>
+endobj
+328 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[327 0 R]>>
+endobj
+329 0 obj
+<</Type/StructElem/S/Span/P 330 0 R/A[<</O/Layout/Placement/Block>>]/K[611 612]/Pg 417 0 R>>
+endobj
+330 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[329 0 R]>>
+endobj
+331 0 obj
+<</Type/StructElem/S/Span/P 332 0 R/A[<</O/Layout/Placement/Block>>]/K[613 614]/Pg 417 0 R>>
+endobj
+332 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[331 0 R]>>
+endobj
+333 0 obj
+<</Type/StructElem/S/Span/P 334 0 R/A[<</O/Layout/Placement/Block>>]/K[615 616]/Pg 417 0 R>>
+endobj
+334 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[333 0 R]>>
+endobj
+335 0 obj
+<</Type/StructElem/S/Span/P 336 0 R/A[<</O/Layout/Placement/Block>>]/K[617 618]/Pg 417 0 R>>
+endobj
+336 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[335 0 R]>>
+endobj
+337 0 obj
+<</Type/StructElem/S/Span/P 338 0 R/A[<</O/Layout/Placement/Block>>]/K[619]/Pg 417 0 R>>
+endobj
+338 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[337 0 R]>>
+endobj
+339 0 obj
+<</Type/StructElem/S/Span/P 340 0 R/A[<</O/Layout/Placement/Block>>]/K[620 621]/Pg 417 0 R>>
+endobj
+340 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[339 0 R]>>
+endobj
+341 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[]>>
+endobj
+342 0 obj
+<</Type/StructElem/S/Span/P 343 0 R/A[<</O/Layout/Placement/Block>>]/K[622 623]/Pg 417 0 R>>
+endobj
+343 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[342 0 R]>>
+endobj
+344 0 obj
+<</Type/StructElem/S/Span/P 345 0 R/A[<</O/Layout/Placement/Block>>]/K[624]/Pg 417 0 R>>
+endobj
+345 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[344 0 R]>>
+endobj
+346 0 obj
+<</Type/StructElem/S/Span/P 347 0 R/A[<</O/Layout/Placement/Block>>]/K[625 626]/Pg 417 0 R>>
+endobj
+347 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[346 0 R]>>
+endobj
+348 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[]>>
+endobj
+349 0 obj
+<</Type/StructElem/S/Span/P 350 0 R/A[<</O/Layout/Placement/Block>>]/K[627 628]/Pg 417 0 R>>
+endobj
+350 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[349 0 R]>>
+endobj
+351 0 obj
+<</Type/StructElem/S/Span/P 352 0 R/A[<</O/Layout/Placement/Block>>]/K[629]/Pg 417 0 R>>
+endobj
+352 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[351 0 R]>>
+endobj
+353 0 obj
+<</Type/StructElem/S/Span/P 354 0 R/A[<</O/Layout/Placement/Block>>]/K[630 631]/Pg 417 0 R>>
+endobj
+354 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[353 0 R]>>
+endobj
+355 0 obj
+<</Type/StructElem/S/Span/P 356 0 R/A[<</O/Layout/Placement/Block>>]/K[632 633 634 635 636]/Pg 417 0 R>>
+endobj
+356 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[355 0 R]>>
+endobj
+357 0 obj
+<</Type/StructElem/S/Span/P 358 0 R/A[<</O/Layout/Placement/Block>>]/K[637 638]/Pg 417 0 R>>
+endobj
+358 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[357 0 R]>>
+endobj
+359 0 obj
+<</Type/StructElem/S/Span/P 360 0 R/A[<</O/Layout/Placement/Block>>]/K[639]/Pg 417 0 R>>
+endobj
+360 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[359 0 R]>>
+endobj
+361 0 obj
+<</Type/StructElem/S/Span/P 362 0 R/A[<</O/Layout/Placement/Block>>]/K[640 641]/Pg 417 0 R>>
+endobj
+362 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[361 0 R]>>
+endobj
+363 0 obj
+<</Type/StructElem/S/Span/P 364 0 R/A[<</O/Layout/Placement/Block>>]/K[642]/Pg 417 0 R>>
+endobj
+364 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[363 0 R]>>
+endobj
+365 0 obj
+<</Type/StructElem/S/Span/P 366 0 R/A[<</O/Layout/Placement/Block>>]/K[643 644]/Pg 417 0 R>>
+endobj
+366 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[365 0 R]>>
+endobj
+367 0 obj
+<</Type/StructElem/S/Span/P 368 0 R/A[<</O/Layout/Placement/Block>>]/K[645 646 647]/Pg 417 0 R>>
+endobj
+368 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[367 0 R]>>
+endobj
+369 0 obj
+<</Type/StructElem/S/Span/P 370 0 R/A[<</O/Layout/Placement/Block>>]/K[648 649]/Pg 417 0 R>>
+endobj
+370 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[369 0 R]>>
+endobj
+371 0 obj
+<</Type/StructElem/S/Span/P 372 0 R/A[<</O/Layout/Placement/Block>>]/K[650 651 652]/Pg 417 0 R>>
+endobj
+372 0 obj
+<</Type/StructElem/S/Div/P 373 0 R/K[371 0 R]>>
+endobj
+373 0 obj
+<</Type/StructElem/S/Div/P 378 0 R/K[321 0 R 322 0 R 324 0 R 326 0 R 328 0 R 330 0 R 332 0 R 334 0 R 336 0 R 338 0 R 340 0 R 341 0 R 343 0 R 345 0 R 347 0 R 348 0 R 350 0 R 352 0 R 354 0 R 356 0 R 358 0 R 360 0 R 362 0 R 364 0 R 366 0 R 368 0 R 370 0 R 372 0 R]>>
+endobj
+374 0 obj
+<</Type/StructElem/S/Span/P 378 0 R/A[<</O/Layout/Placement/Block>>]/K[653 654 655 656 657 658 659]/Pg 417 0 R>>
+endobj
+375 0 obj
+<</Type/StructElem/S/Code/P 377 0 R/K[660]/Pg 417 0 R>>
+endobj
+376 0 obj
+<</Type/StructElem/S/Code/P 377 0 R/K[662 663]/Pg 417 0 R>>
+endobj
+377 0 obj
+<</Type/StructElem/S/P/P 378 0 R/K[375 0 R 661 376 0 R 664 665]/Pg 417 0 R>>
+endobj
+378 0 obj
+<</Type/StructElem/S/Document/P 17 0 R/K[19 0 R 20 0 R 36 0 R 37 0 R 53 0 R 54 0 R 55 0 R 56 0 R 64 0 R 65 0 R 66 0 R 93 0 R 99 0 R 100 0 R 105 0 R 160 0 R 161 0 R 162 0 R 182 0 R 183 0 R 269 0 R 270 0 R 286 0 R 287 0 R 292 0 R 293 0 R 300 0 R 301 0 R 305 0 R 306 0 R 309 0 R 310 0 R 313 0 R 314 0 R 318 0 R 319 0 R 373 0 R 374 0 R 377 0 R]>>
+endobj
+379 0 obj
+<</Type/Annot/Subtype/Link/Rect[133.98361 58.145325 172.33961 67.41614]/Border[0 0 0]/A<</Type/Action/S/URI/URI(https://docs.helix-editor.com/keymap.html)>>/F 4/StructParent 0/Contents(https://docs.helix-editor.com/keymap.html)>>
+endobj
+380 0 obj
+[/ICCBased 437 0 R]
+endobj
+381 0 obj
+[417 0 R/XYZ 25.51181 645.8511 0]
+endobj
+382 0 obj
+[417 0 R/XYZ 25.51181 804.6376 0]
+endobj
+383 0 obj
+[417 0 R/XYZ 25.51181 463.1918 0]
+endobj
+384 0 obj
+[417 0 R/XYZ 25.51181 276.91058 0]
+endobj
+385 0 obj
+[417 0 R/XYZ 25.51181 110.019775 0]
+endobj
+386 0 obj
+[417 0 R/XYZ 211.1811 571.6865 0]
+endobj
+387 0 obj
+[417 0 R/XYZ 211.1811 362.6673 0]
+endobj
+388 0 obj
+[417 0 R/XYZ 211.1811 191.56 0]
+endobj
+389 0 obj
+[417 0 R/XYZ 211.1811 84.62604 0]
+endobj
+390 0 obj
+[417 0 R/XYZ 396.8504 804.6376 0]
+endobj
+391 0 obj
+[417 0 R/XYZ 396.8504 765.3951 0]
+endobj
+392 0 obj
+[417 0 R/XYZ 396.8504 717.2342 0]
+endobj
+393 0 obj
+[417 0 R/XYZ 396.8504 659.0976 0]
+endobj
+394 0 obj
+[417 0 R/XYZ 396.8504 619.8551 0]
+endobj
+395 0 obj
+<</Type/ExtGState/ca 0.6509804>>
+endobj
+396 0 obj
+<</Type/ExtGState/ca 0.16078432>>
+endobj
+397 0 obj
+<</Type/ExtGState/ca 0.7490196>>
+endobj
+398 0 obj
+<</ProcSet[/PDF/Text/ImageC/ImageB]/ColorSpace<</c0 380 0 R>>/ExtGState<</g0 395 0 R/g1 396 0 R/g2 397 0 R>>/Font<</f0 399 0 R/f1 402 0 R/f2 405 0 R/f3 408 0 R/f4 411 0 R/f5 414 0 R>>>>
+endobj
+399 0 obj
+<</Type/Font/Subtype/Type0/BaseFont/FVNFXV+LibertinusSerif-Bold-Identity-H/Encoding/Identity-H/DescendantFonts[400 0 R]/ToUnicode 419 0 R>>
+endobj
+400 0 obj
+<</Type/Font/Subtype/CIDFontType0/BaseFont/FVNFXV+LibertinusSerif-Bold/CIDSystemInfo<</Registry(Adobe)/Ordering(Identity)/Supplement 0>>/FontDescriptor 401 0 R/DW 0/W[0 0 500 1 1 581 2 2 505.99997 3 3 428 4 4 561 5 5 489 6 6 427 7 7 652 8 8 619 9 9 250 10 10 905 11 11 551 12 12 598 13 13 706 14 14 256 15 15 325 16 16 358 17 17 641 18 18 244 19 19 456 20 20 322 21 21 613 22 22 616 23 23 561 24 24 521 25 25 736 26 26 558 27 27 716 28 28 529 29 29 777 30 30 716 31 31 545 32 32 504 33 33 315 34 34 514 35 35 614 36 36 315]>>
+endobj
+401 0 obj
+<</Type/FontDescriptor/FontName/FVNFXV+LibertinusSerif-Bold/Flags 131078/FontBBox[0 -238 893 720]/ItalicAngle 0/Ascent 894/Descent -246/CapHeight 645/StemV 168.6/CIDSet 418 0 R/FontFile3 420 0 R>>
+endobj
+402 0 obj
+<</Type/Font/Subtype/Type0/BaseFont/QUEAPS+LibertinusSerif-Italic-Identity-H/Encoding/Identity-H/DescendantFonts[403 0 R]/ToUnicode 422 0 R>>
+endobj
+403 0 obj
+<</Type/Font/Subtype/CIDFontType0/BaseFont/QUEAPS+LibertinusSerif-Italic/CIDSystemInfo<</Registry(Adobe)/Ordering(Identity)/Supplement 0>>/FontDescriptor 404 0 R/DW 0/W[0 0 500 1 1 486 2 2 389 3 3 783 4 4 401 5 5 190 6 6 353 7 7 250 8 8 307 9 9 477 10 10 518 11 11 489 12 12 519 13 13 357 14 14 478 15 15 521 16 16 447 17 17 219 18 18 266 19 19 276 20 20 475 21 21 486 22 22 503.00003 23 23 489 24 24 472 25 25 564 26 26 444 27 27 499]>>
+endobj
+404 0 obj
+<</Type/FontDescriptor/FontName/QUEAPS+LibertinusSerif-Italic/Flags 131142/FontBBox[-78 -238 786 700]/ItalicAngle -12/Ascent 894/Descent -246/CapHeight 645/StemV 95.4/CIDSet 421 0 R/FontFile3 423 0 R>>
+endobj
+405 0 obj
+<</Type/Font/Subtype/Type0/BaseFont/URHWUA+LibertinusSerif-Regular-Identity-H/Encoding/Identity-H/DescendantFonts[406 0 R]/ToUnicode 425 0 R>>
+endobj
+406 0 obj
+<</Type/Font/Subtype/CIDFontType0/BaseFont/URHWUA+LibertinusSerif-Regular/CIDSystemInfo<</Registry(Adobe)/Ordering(Identity)/Supplement 0>>/FontDescriptor 407 0 R/DW 0/W[0 0 500 1 1 390 2 2 447 3 3 264 4 4 428 5 5 316 6 6 220 7 7 250 8 8 457 9 9 542 10 10 505.99997 11 11 310 12 12 504 13 13 531 14 14 538 15 15 519 16 16 220 17 17 702 18 18 500 19 19 236 20 20 515 21 21 372 22 22 747 23 23 271 24 24 493 25 25 560 26 26 661 27 27 587 28 28 528 29 29 268 30 30 490 31 31 512 32 32 596 33 33 323 34 34 424 35 35 790 36 36 497 37 37 695 38 38 363 39 40 298 41 41 485 42 42 338 43 43 646 44 44 236 45 45 1130 46 46 685 47 47 597 48 53 465 54 54 730 55 55 839 56 56 557 57 57 272 58 58 297 59 59 503.00003 60 60 582 61 61 541 62 62 749 63 63 550]>>
+endobj
+407 0 obj
+<</Type/FontDescriptor/FontName/URHWUA+LibertinusSerif-Regular/Flags 131078/FontBBox[-48 -238 1072 708]/ItalicAngle 0/Ascent 894/Descent -246/CapHeight 658/StemV 95.4/CIDSet 424 0 R/FontFile3 426 0 R>>
+endobj
+408 0 obj
+<</Type/Font/Subtype/Type0/BaseFont/DYDMIL+DejaVuSansMono/Encoding/Identity-H/DescendantFonts[409 0 R]/ToUnicode 428 0 R>>
+endobj
+409 0 obj
+<</Type/Font/Subtype/CIDFontType2/BaseFont/DYDMIL+DejaVuSansMono/CIDSystemInfo<</Registry(Adobe)/Ordering(Identity)/Supplement 0>>/FontDescriptor 410 0 R/DW 0/CIDToGIDMap/Identity/W[0 85 602.0508]>>
+endobj
+410 0 obj
+<</Type/FontDescriptor/FontName/DYDMIL+DejaVuSansMono/Flags 131077/FontBBox[-9.765625 -250 611.8164 937.9883]/ItalicAngle 0/Ascent 759.7656/Descent -240.23438/CapHeight 759.7656/StemV 95.4/CIDSet 427 0 R/FontFile2 429 0 R>>
+endobj
+411 0 obj
+<</Type/Font/Subtype/Type0/BaseFont/OTVRNR+NewCMMath-Regular-Identity-H/Encoding/Identity-H/DescendantFonts[412 0 R]/ToUnicode 431 0 R>>
+endobj
+412 0 obj
+<</Type/Font/Subtype/CIDFontType0/BaseFont/OTVRNR+NewCMMath-Regular/CIDSystemInfo<</Registry(Adobe)/Ordering(Identity)/Supplement 0>>/FontDescriptor 413 0 R/DW 0/W[0 0 280 1 1 652 2 2 626]>>
+endobj
+413 0 obj
+<</Type/FontDescriptor/FontName/OTVRNR+NewCMMath-Regular/Flags 131076/FontBBox[56 -213 596 725]/ItalicAngle 0/Ascent 806/Descent -194/CapHeight 683/StemV 95.4/CIDSet 430 0 R/FontFile3 432 0 R>>
+endobj
+414 0 obj
+<</Type/Font/Subtype/Type0/BaseFont/RDRXIL+DejaVuSansMono-Bold/Encoding/Identity-H/DescendantFonts[415 0 R]/ToUnicode 434 0 R>>
+endobj
+415 0 obj
+<</Type/Font/Subtype/CIDFontType2/BaseFont/RDRXIL+DejaVuSansMono-Bold/CIDSystemInfo<</Registry(Adobe)/Ordering(Identity)/Supplement 0>>/FontDescriptor 416 0 R/DW 0/CIDToGIDMap/Identity/W[0 13 602.0508]>>
+endobj
+416 0 obj
+<</Type/FontDescriptor/FontName/RDRXIL+DejaVuSansMono-Bold/Flags 131077/FontBBox[42.96875 -208.00781 584.96094 759.7656]/ItalicAngle 0/Ascent 759.7656/Descent -240.23438/CapHeight 759.7656/StemV 168.6/CIDSet 433 0 R/FontFile2 435 0 R>>
+endobj
+417 0 obj
+<</Type/Page/Resources 398 0 R/MediaBox[0 0 595.2756 841.8898]/StructParents 1/Tabs/S/Parent 1 0 R/Contents 436 0 R/Annots[379 0 R]>>
+endobj
+418 0 obj
+<</Length 13/Filter/FlateDecode>>
+stream
+x������
+endstream
+endobj
+419 0 obj
+<</Length 515/Type/CMap/Filter/FlateDecode/WMode 0>>
+stream
+x�m�M��0����C$�@�8�,!A ��вj�!h$bGNr��W�k�U�A�g���?ޏӍ2'�&?}pg[�4)� w���+�bu�vKj��:�)?���0<��:(���/e˗Z%�5(��4A~����4����X�u#���/�]m��� �Z����נ�ݚ��=�k���D��nKRu�{rߪ)[��x�zn�l(A�Z�ID}��z{��k��y��m�/4�7�-x���c�$�*k���Q��l�"/�X��-}�Z�D�_��C�+��kˊm�/��bM��(��X�x�b��\�)�K�״"kG�Q��$h�� 4�A)2P�h�3��� Z8����h *@9��v�f���Q�ؗ;�� "C�~i*D��
+�φc�sc��3���t�c��;f�z�����3�8ǝ��1�1���u���$<��\�S� �5%�s G�p�'a��E<f��eݻ�q��Z��e��w��{���=�[�2�+
+endstream
+endobj
+420 0 obj
+<</Length 4399/Filter/FlateDecode/Subtype/CIDFontType0C>>
+stream
+x��Wy|Su�O(ͽ@'h/)�^��*�
+�CV��Pj�J��I�ІnY�&m���lMҦ�6�WڦK����vQѺ0�#���{�(��F߉��{�>a�������sN������o���3y|>_�RF�$7?#� �In�t� �C���A*��9�>��g����1{�%�������x��s���s�����?#��G����W����|��� ��ɖTIv~F�z���:7#-=?��ٲ���l�˞��O�����#W�)��l(�O���-��f���G�<�M��Z�t�z۝TފѳgcE���e��38��@�;�W�1Q����x���jg6s���{:t��=J���_?�1�dX��ؙ���>�[�z�g� ����Z>+֙٫��?�?��WDŽֹ�����gdl���87oż3���c�+c|�Xp�X�yf��㎫F�'�C�`8ar�_�E�3��Bp^{~�
+CI0!B� �B lG
+�����(����/���
+l�ƴ]O�t��pnbb�=���07��v��z��Y���A�L���| �M)Υ0�黏�Je'������nl4�5l����j_.�-7�,J��Ի+�H�BF�0��� [;��&j��n4kE��g5���\F��=��{�e �D<
+3`6�#��Ԩ(��M}��h��3�!S��Y�ĵ�Z��*�Ս2X �u�z�<�E^S0����lg��6�Mn���5Ǩ@��fE81�p��dl���w��9X'Bј27�HM(���[��ob���z���_CT��A�W}�s�v;]UG(Wu���TTy+�����@kVgZ�$k�>� 0u�Gͤ��p�PIe�J�T�t����Ǒ��{+�Щ=�4Jh񘕑~�� �x��Ȓg)4�e�S_K��gk�]��gr� v��ߑ�]q�m��L�*m崴l�f��Xƕ���7�v6�DQ�C�gϦ���p�`GC쨄����LQmN�60���BŮ�2jw�̚p��w1m޶��Tk�1��A,Va.�*h�����A �~�1@A\ n��`J�FB�?�w�k����I�4۽���=�WFK�� ۏ�2��E�S���~8�x�uZU�"�k����G���T�?g��\j21B��
+�߄�?v
+�l{�IN ���h���W��{*��[y���}>\�-�� ���;z{d�[�:c5��� ���t�,�O�ڭ�ɘ�|��0�U�W���2&�;K�AuuZ)�N�;�.�V�E\���'8=�TFB���'`�(x����G7
+~�]�e��9��!��#�qv�L�&��(L��B �:4�n�0&��e ��]�����ek(b��P�yjT�wK�3W le�~��&{F�q����-����/����� ~t!�| Q������'���H[.�$M��! #�܅+�[\��[YT���O�an�T��=h-v]"� �8VSG ����[QT�rGT7wj��Q����"ק�M ��kp ��_C,����
+`�`�gaQ�ٳ"Iw��`Ow���S,ΐ��pz��� ��^���C��B�s���'��`FL�� ѫ���c�+�/� ���� ƊJ� �R&�s��~[`ZĢy��tWF��V5��7S�o�������MkKsC��;ƌ���-�w����b�0�Ѣ���h��� ��c1��UO_TJ5�ELae����,7^C
+�R�F���P���`{H�,$.����]��c+�L���p7z7��#F�lSf���QB�u٦ ��'�����c �)GhYMK����h�Su�2u���j[Bq��ٗ,9����2,CZ\�b�6c=���~ւq�^�;Cr���|��B�B�#��6������TQ@�$nJ.��������8��ގ�������J��Oj?�/BCH�W.�1�kh�8C�M���D@X���H�����)����3��f?�4z|kS܀����O��L�3BTT��)�y��B����ݮ�\����kF��YD�E�͙�í}���}��eY��~;�{�rS�C�V⛻��� ��V�,[���'���X�f�2�S�R�#���9��n6[z��X�͈T[�1k��|������&���{�z?r��Y����H�8�M�x�p�<[\�U��T��}�Y|����ym7��Xh��̘P����A_�/l���Ic�ś�K�ic�����=+����Dz�7�7� -�%�ex�Cѹ�mv�ժ_pj�W�5��������&�ϱ��٤� ���30?Z�4[�����n����ܗo(�Clfj
+������>�S��NXm��͆�䏢}K��F�����#d�wX��\F��`6�*� re�5Y��Ȉi��u?yN\V�9�p� ����%(��~P�NGV��o����e'�&�iAZ�~��_��!ٿ33'�!�'�j�%�:pP[�ɤ�NM$�t�:�C#�޻KI��e�b�8�*�����9��
+Ií6}x���aC|Ӡ=.n�[SѓU(�a��Qw����64�]14q������h���SrF;�v�sS�*��ʔ��-��4|u���qWZQJ��QJ4I�-ɣ�{�M�>����(bx08/zJ^������ um'}�ki!�h� ~�ï��1���6�/�]}[)7�i��\����np�v0b��an�:�x��v��D���H�/�B��}9�rKn�6��Mp�����&d�
+�9�H5х�R����j��4��=�\p�W�l:�.N�$7[~Fg8�;?${�%3�u�\���a v��6i�o��Y�x'�Xx�ݰ��Q��c��GaO�����EA��h��h�����O ax0�������ksY5+Oϸ=�8q��ح/J[���Y��ei�̱z H�Y��q�z��{�~#��}�M˸��' �ʶ�@�F��z��j𨫋u%y�чJ��r�أ6�J(IA���Z��0���Cy:m�Z�X��no���BX� �*�?
+ע� �*c�Km��쬭�_W;u��bvOz��>�^iQ�v�|4]���<��gip1� �� {�'�7�T�����;|��Bȿ� ���Â
+�T�:Uv�L�Y�Yeyy������Y+ka�%��;�z�M�)��>�h:ZU�1y(w����� �_!K������^����\x�{��?uB5�#=p熱���Dˢ e:��u��ف��ى���ġj���n���V��0M�����E���Pc��V�WE�\��}Ա��m�N>��Ja��!� �A�w������*N��$�n\K�������>+���g��J׃W�Y,o�:�C�9��.�0��o�6e�w󅓸�����El�^�le�.�Á�z͝Md��u�:�!�N��囩� 4{[�����@l#Sc�X�v��h<Q�5��-,g��+��
+6�Bc�#�n�� �g��W�W�M������.��=�@<�<9���I W�8G�W�/��w�dd�Y�}{H�{oS=��R��,|D6,~��s c�����P҄��Qd(6�,˲�z�j)M �Ϊ�zc��?��uu��#� z��ѩ�_�J��bߦ�ߑS==��ܾnK]kh1W�� �P����x���>p����
+endstream
+endobj
+421 0 obj
+<</Length 12/Filter/FlateDecode>>
+stream
+x�����
+endstream
+endobj
+422 0 obj
+<</Length 463/Type/CMap/Filter/FlateDecode/WMode 0>>
+stream
+x�m�Mo�0����ك����@mEjH�8�CM�{&�$�l˘C���'�V{
+�ׯ�I�j1 ���Dy��K0V����U�Kk�8O�1� ��W�
+endstream
+endobj
+423 0 obj
+<</Length 3652/Filter/FlateDecode/Subtype/CIDFontType0C>>
+stream
+x���{XW��q *W�YuFgl_��}m�j�ꪈ�w��"��@�%�I&��r�@H��&wP�x� ^i ��n�־]}���'�q���j�����3s�yf��~?��9L�ĉ &�9}sr<7K��!����J�-� <����Џ�gB1��P6�� ϯ�!�����f��-�f3����f0�ӧ�f0��C�t��� �@蛌 &3��)"��ݐ��& s#���Yɇ��s^���h��w-��+�;���l��p�s"D�$~V�Bc��@�.�j���a�5W�3�V�ȋ�?��h�}69�Ǔ�N2�N�<4���`2 Ƭ��^3 ��r3]�� c�
+|| c�9aÄ� �A�����h��C���!�\g�Y�&Oʝ̞<:�"t��_U�+�N��e8���I���� �D?��mO��;��8`%����z�?� �����gc�S[ Ns��x�^M��FUN���l�/��1g�� ��M:���Z���}_��&��D
+�9"� �/uv����M��2%�J)MŎ�:��{n�+�6�(<����XX��Nx���R�d���1����
+R�� ��Y�06���
+�Q�,9��Aџ(�����`�3�R0 9a�50,~t�`�W���S��irTY��Pi�u�;�N���٦#���L���4|?����v��!0勎�#��I�+��4N`$����W"9YɅ���f �b8t�U�r�����FWh����E8�S�
+�DI79�]z��> �����=XNp���o�R��]��طc��Z��O��m8���5�� �<{��҃�g��ӌ�1��`����*}�l�� �bUT����|Y�E/+�}�^�Њ��h��j>�ǹ�bH���� �"iCoo��lvPj�Md�(IY�q8�a�(��ؑ�qP+8��vr����G�k�`qH���J��{�O���J���F��� ����ST� ʨ�`�:�eW��<���� }p�<���Ρg����]%����S':����!Nx̎u�h*y�����n�ޓ$��(#g�^����߆y`� ' ���gR�Ӥ:�*��R�<���R<���G{į��]UЫ����U�̧�W2�y�L����"1x��n�����C�.�����>
+-��&�
+�_WX���@E��"A������r7~��i6��r�7�-��S�8�ThJ���J�T
+TI��T�n�dL�*�UjwQ��g(�6�։�x|�ՙ��})ykc�}��{Щ<�/ F� �p�5�Qa��U���&w9�rRJ+OSXT���\{5q
+�i�b���9����j�������f�Z�R�l�l��F*��'�h��
+󭹍o6�Z���>�P�%$.���
+��
+g夥t+�N�x|gG��q�Lc|�A
+��5z5����tk�nm���3`&� ��LZ#&1�V{��n��/�ϫGo��<ݍ��Z{}���w{y��L ,��s��|�ݎ$�sQA��^�_=����ӎ^w���ًb?4j� �o�м ��$)�P*o�)۷E'�� a'���ں�r/�����c4�ٝ9%h��]����{K�Yp}y����a����w/����J,�9p��38b&yMa�_��C���*IJT��9ոK)�P�R�'�ʾ~���Ո��e6oͭ�`]Л�f�]��� :7(����G||��_�!;
+^dGYa ��B/� �����f�K��;n��c��]��Ȝ�'۠I@�e��5���#"v�KK�v�O[.Y�����W�t*�+'���bz����C�n�ɦ'�뀰�k`�i�
+endstream
+endobj
+424 0 obj
+<</Length 11/Filter/FlateDecode>>
+stream
+x���
+endstream
+endobj
+425 0 obj
+<</Length 633/Type/CMap/Filter/FlateDecode/WMode 0>>
+stream
+x�m�Io�0���Ӄ�䐚��$ $���qОq�
+�)A���� �����qf8��L�mn]��7���wک��f��4]��t`?�0;v��pO]����X/׾�4]��kr|��_��I=h1 c{H��������@��������4���д��t��+��!������[��i�x�K'� }m�5�(*�ևm�7�a����Z��rS'�DD�w�7���*�&�;D^{�}��tu2�-���IRq����g�e{`� �yU(I_�>����ϭ; �u�x�5�[���A)���PUU5��e���϶��zNJ�v���ȡ,�*���uT���JAݢNC�A���d�'�jUA-�O�����C?��A � �h�+��g��W�A ��_)u�+$S�$S��K�9�k0� � sӁф-�c F ��)*��]� 8 8 8K�9�%�pb��N�Ns���s�Nw�9�F#��I �V�GF}~� s5`�Ad�h�̂Ϣ΂�b�V�Q�2(| |^,�1�_�|��)�IX�e`��+ř|���1S�o5�ф�FF���S�a���=:� �������g �����]��.Tſ� ��֠^���~u�
+endstream
+endobj
+426 0 obj
+<</Length 6832/Filter/FlateDecode/Subtype/CIDFontType0C>>
+stream
+x��Y x��n Y ׎�2�3��."��\�MV�)�R��/I�$m��dm��Mi隮)�;X@PQvIJ/*"�O����O
+]������&�9_�w����gX^#Fx�X,�"C�#��ք�G���:$,)r[��n���v4�~f�9ҋ�jᅫ�=�M�<�Cܽ�y��˫{�3^^���?�����'x.�<�9Ͽ��'z�Y,�`�������!щ�)�bbS�#��� ��2��)�M�<�qk�C� �5ne|�����qs��c�&yy=���%������ k}n����l<r$����G��G5���g���G��byyyy���� F�e<�������k�g�e^WYKX� ~$��"�4�����ϱpg���y���?�ޣ #Ǐ������Ǣ�UP9F8�,}|�7���w/��K��(|R�'�{R��O=y�ן��Y��<v��:�5\K�$>~:��g.��ɯ���"��������mK��~����V�Y~O�=�暈0 �0 �9���n���|�T0�ǹg�M�W�f��7�4M�Ԉ�/;�b�޲�0� l{'�B�F��m��je�Vc6i5fJ^Q�j$��\��э���V�bgP~/�Ұ���`�۹�IQ˜L|̦o�52N>Va����#�,�_:�yvu1�X�o���XMpR�MF%��Q���
+S2�P��d]� ����K���~�0$4:m���I�����8k8v��v)�+D��8�Ыk�|�!TP]G�I����(�Ua�0|����)>n)#��D�d��RJ�Z�EwX�b�}X�M�I��դB���z��q��h���L&�Ca�/�K�q�6v���%�*}/����d��L
+�A�I= oY���d5^a�'|-TY� Y kD@R
+y�,�����)x�fV̝>�wu�]���ȑk��I�i� ��mk��HE�Z��ɩ"��J‚u �����W���!K
+8:X&D>�L�<[A��"c� I��6G��bJ )���Ջ����>��N�pW��(�
+��+4�J+s5}6#��Z��Q��t
+��J�r��x�e��|T3.�媦���(3\�a;��s,dcS[i3Q��L�SV�.6
+G�z�S�J�Vd�,R˸\ �E�&�Ci�1J=����Uu&֐����p;�qM�•��_�!���aKu���W �����B���c�|}BN��Q����(-��?l6���
+�1�� wo� �s��z�VO�Q۴���<�F#'U��ۉ�[�B������sp4��7���*�K\]���0Y��!!w��H�'|�|���s�;�������<3���K��#qR��O7����]�@�<�p�z�¤�2gu�$<�Lɱe8��2GI��HT@���C�w&�E������P2C�4��j(������<����".� �w��g�\�v lN<�80�Ӯ��:�mO�'��_V�c�ž��dX@�p�
+�U�mց����貄���������脄hR
+�-��)9����/o���n�4R�N�o��۬����9��3�����Ϻ���vx f�{�<���������s����^Q�;����
+��Hb�
+�2Lj ��"rOr��0�g�0� [��V���鰐X&n`�J���O�/|2L9
++a�1����1��K�&
+���-��=���ItTԶ���Qɢ3��A�>�x�6�1b|�;t�}�������C*{t�S�������:�v� L�d
+:�c��X�^l֊���b�~x���Ş����>�6|�% J}6# �t�ҪX�i�z�`+����V�Y�O=X�dw�0�,�����Q&��%1gBLB%X.�S��Ԟ*��"�`�0�M
+
+�΂�<�v�&�%ݦ��u�Uf�*;a2Y-9�ݤ�e�wV+ꉟ`� xo�y+ $5&�2G
+wT��缌����)*-S��9 �\)0���\1(뼿��>�{�'@a<���?@
+����K���pm8��Yw�hk�40��`u������owNڼ6�?�ڶ1k�L<}���瞪/V�����mX4�dw�B^M�x=�6x��v����f�q���7Y����u�2��ņ����|�Y=��M�F:88� ��C�B�4��P
+���_Ŭۗ��ғ���F�����#��2�T'���CW�'>���P�)����パ�Bo�C�6 ��=c�0u�
+�xB�q_@�͜�ϒh�J\���'�X8�����5w�5($: �5fDǯ%��c�X��o�7>���_��1��^N*c4�Z��!1�)H���}������X̂����Ai����Tw5�ĸ\5���Rd;_�4�Kj��ʄE�˛���U ���~�I�
+� �,����i�h;���-��h*MZD����2����{�۵�m��s���~�Z�Pj,����Z?b�_Ħm֥T*䴝/X=� ��(�tO~�2ID��E�}҂�ڴ����'�Se�g~���t8�}{�P��OaN+YO�c>�&�"���M�f
+��g�{l���C Q�=�����8!t�{�������z��&rr�&Ca܃h�="D���F��ini�� ��N�>擕+�$���3nY�b��.��T�t���&CA � @�$�[ �O`瘸ߢr�
+ŢE�� ���7���e� >���Z�ߋ�)L�:�ھ��ڟ9 &�WU�
+��k�������\ |��2m�.�F�t6�f�ҕv�o]Z�؄�U�t�l�{C�e�� �ۛ�����,�鈛UH�����������ht4�SG ���T.�8 �4�C(�FCS�-2?�?_e��v;v��}�gD�����'��J3{�.��q5��݃d9���L�8ݧ�,;ˆOS��sX�K5Z�6b]���:�AfQ���KM�D�>!�B}�i��Z�.�����l���[D�����{��9gf_��װ#���BQq�����4GcҘI�Ƭ����N5�Ŀ�4�o�
+r�\v����W��]- ��-���z��V3u2 ~jj|�p;�5�oq�����7��KbG{���`���wÄ��bo8y�'a��� ��,/I' 3S�EDrr�8�r��ǵo��֢�hD@h�<�*�Uc������Z(�l�Q����P��U�#B�t�p*�pJ�5�#=�Ey" �;܄�e_��s!F8 ڸ��f]��qvp�J�RE}0 ����ѳ�t�)����׹�C����e\L{s];܍����//��nU��zZ�����\8#�}�L�ջ;�Y�W!�*�e³�� �>��փT}ܶj_����H�q��޵TLe]F3ap_(�v�&��=�㯫?�XONOژ�BL��{W�>��F=Xݻ�,�r�5�G��>)lu�-ݰj֋�qGWX��%�N�!;%6|}��" �'˴� �(9-�R�!u�,�
+�g��Tj���9j
+[����h���Zc��L�l>�,��d�
+I�j�@��<�(+s �S����~>V����q!�^G�7e����c�0_Hr���������İ�e{�z�:��p2,�|H��)ZPJ�56�����([ҿ���u4�&����l:�@9ܨ� ����i<�8 ���<��Ry������L]��?O��=��2
+:(���wY��EO���ħwѕu�g�]�ؚDZ���V��|��z���}wp���S=3"��И �L�YNZe��$B*�D7d;��k���ʓ�
+� 7�j���|��)V�XK�?|���Ţ;���k��&:x�Ff��h��44t�m� ����=)En^�^�]���3�=b{$�y��H}�.��lR�"[�Mbg2STjI�dG�e�o��|&}���U8M�B
+kݙkЉ��aI�!=�ΠT^
+�̔���X:�X��nx�ݧ�QXku�$��T�L_�R��U�{FG�p��?�1�}���TG���e)%�b %�Z�+��������9����EPح��-u3��8�DD-�> ��ܿ�$9=s�ںa��ِy���iR���{��Z����n�����¬0:X�! �u4��TL�s������x%�XĻ�N�0 %��8�P��=I7�[��K�=����Uܙ��{�x��2u=Kza�参C˨��� ;�7,��[��s�FX�_�رD�!/��/���RR
+endstream
+endobj
+427 0 obj
+<</Length 13/Filter/FlateDecode>>
+stream
+x����
+�
+endstream
+endobj
+428 0 obj
+<</Length 714/Type/CMap/Filter/FlateDecode/WMode 0>>
+stream
+x�m�Ko�0����E�v�!~%mU!�P$}�T3k&Rq�<���}����}~�:&�񺹺w퇿�? ��v�k�x�vY�/�z:�0>{�;Y�[��m=�Q,��uh�,�ס���?��������k��4��!���f����D�I��c3Eq���/�Mn����1�E{�� ٌ5��o�Ů �g%��fR ��#U���.o����k����:z
+!����a��"5v)�����;�7a/.N�~3n�����IQ��>��;���ۃ3���RȯG���3���S�NB�źu~趵�aﳻ�(���[�V�y�����"�cW����]��]Q;OJ%U]C�J� ����[@����*��kxVP7����
+�x>B-`c�9Y�1)Ÿ�q
+����'�4�5��4f����|
+�N��"�:� >�>��13���L���Cu��� �����Y�?�OC>���C/�|ؑ���x>Ad�?vF>����c�ȧ�D�6�)[`�6�)+1O��a���D|�Y���t��Z���7h=��c���u��&���ߵ]�J���q���e� ��:
+endstream
+endobj
+429 0 obj
+<</Length 13125/Filter/FlateDecode>>
+stream
+x�ݼ xT��0�;۽�e��d&�u��0 1d'�@0C �����,��@@���5�h��
+E�ai@*�R$Q����h��6����{ν�pi������y���9sﹿ�۷s
+{
+�G/Iv
+n
+��"8RчHPiS�F)�m��f�-;; �K�m��+����-ۚ��n�=$#�O�Ì<1`U #�&'#O�$�b���/�(�{�~��b���]#}b��}
+�:Iz����/'&�l�L��?>���;��[����0H�*�N(Pv"��(U�&Rl3�T��7� ��ަ��+ʵ+��N,��!N��F
+i�9�gX��{�l��5����!��gln�����<��Q����\@0��E:�]�(����!���F�Ԓ�M�Z} �sE��L�'8]�t)�6��Y��P��+VU��@BB���L7}��e�oF>5u���<}����f%�m_9|$�E�h!���snd!?���gxk�=�W�4���+�
+�|��l$`%��&�I� I��)-�m�B���Z޴
+t|^�Xc �XS!e(�V�� �g ��he��6i�n�X3����']����}�N>�n�>dE�=��q�N�p����?h���8��� _${x��^�k2סS�d��f� ����5���*�5;;�۵���q�w\�š�'ו����o̮CW7�߰eˆ��v�� �c'�W�W���t��>lm���W��
+z(�E�#,�R�� ��c�����VH5�Y�WJ�iK�h)=#^c:���8'�p��W��K�<�?"B�8� �Bi��J%��57�fX���D��?u ��k��Aߺ�Hߺ�"�z�N���`��@6 �Q=cTr�:�9)��d�$�&�S��a�#�4�LF�^�Er� )ojf֞#…J���Y�^LPfQ�D�QO����p8��a,Ra7F�� %�8� %�]/S6�ò�l9C�c��� ��L�u�� Ɖ��x.�M�y�Y�e�������$�! G�hƢ цD�������P�D�<<��V��d]Ma�0�6�NAS�H�C#�:U��ݧ�^<x�N�/�yMd��z<�c�&�z
+��l�ʘ�QU=D�Bi�� ��P�q�=J{[���ʛ/��S��ٶl�-;�����N���zT�� ���!�������p�nY^fV@W�2{��2�D4S �.��<��G<�:|���k~���~�6l�z��G�+O���-���‘�k��<���'�6��ӻ1>~̘�m�<���
+2�I�
+v���,��IA�.b�r%�&T�ቕ�P�b3�3~�H���n
+������93��)�|uQ�h��WDo@��jғ*���Qgi��6ېP�$�w�����y�z ��f��MZ�b������ْ���F�H���c����5?=a�V��BP��ӵtؠޗ�4�tۈ�&Q�Z�6�)N��ê��,N�9(O ��J>e5� �*� � �Mg+4��@�V��ꅲ�m?ٗ���۾6QF�Se��uV�-�g����Z m� S`
+�d,�Q"�!HT�dR򐙱�[&?Yv��!|�)4 9�J+����m��L��O��O�}+�f�V �3b��
+�t!�T�a���~?J���a�*���� P���
+�7:ڕ�Zr�h6�֊^�gi���Z�ӥO\D�9�.gǦ�T�"X�a<Z
+�Y� G��,�'��dLd���2'�ݜ�R���ž�'�Z���y������_�Vi]C� �r }2���~����f�zB���S�II�޼rѲ�������;�
+��p�dRZr�:!0D,Ւ���3����m|p�4�c�`<
+.}�]��4�QY������T�Dd��ꯪ~�s+�^��0�u�7XJǹ'ׯ߶�������s��'�d� �B__d�ҡCDi6� 'u�lF�c ��`֑��hI����j(vIs�� ��S�ڋ��_M���h'�W߬:ua�*�w�5�n�u�`� >��؀"}mh��6�,.kvA��-T 6-{ $�N�c ቯBd%�mgM���'<춘��.�k�7�aP~?<�<�7�M 럓�?l�r�_��+������i�բ��Z!"a���^'��%�0/�$O�� �Q���m2Rf �K�@�i&��tjM�\��(�<�ZE�g�:Lm-m�l�{ۡu�7.� ��d$�eUE'u�_�p�ٿ�r�+gQ�u$=��=�X���{�^^�V<3�c3k���'��Wݰv3`->�xu�'��w�>�[b(�
+��Q�U EYX~?���y��
+�2�2>����`څw�]t�%�w�v�wv��~��'��~�_�/�����7�7���8>N����t\>�;�?n8n,�)dK���A�A�A݃z��O�1MAj.�%����U���76�ő}����w�����[��|�׮�����J���Y}�F���/� ����>( ����Z�(mB�D��ص�bߜ��V�y�hD����< F��!�I�Lp�d1�0+~��=�$.�Q�9tF:=r� �8Ԡ�?� �=�W��v�c#��M��g��;Q�q��Ũ�� &��8� �̴>���H0�G*j��ş�"���d���Kt�K�8E�LW �5���9���jlf�0�c锂���B�� u���}!�OH43d
+����>.�(k)A���(9;��7./A�v�����o��̋�Ғ)sΣ_�ESǗ�<��Xr�K��a�F���_5�5s��!1����On���^��h� �R�}q#�-�EQ �z�M5�LE� F�����D)��Z�Z��C�st3k B}Bl� b��򦰼�7ӳSճ �_A��O�_D��֎ ��W�$���JVPH�31�}2C��"�P�� (��Ghj�(�_�>u �z��8$ �
+׼���W�_����b�궿�|dg �#���o�ƹE#�/Q4wc�ߒ���#7�C=Ԗ�w�5r���#�ol��HJJ;�ac#�-�7���Fm<����4w���Q�4�{����9r�����S��*n8ܨ�M�4��� ��T��3
+QH�� J��ů�6�}�����Mq���2y��r>@%u��� 6�'vh��Pqɐ�7)-�[,�<
+4�[bg�
+�>R�-3����Ίt�P��nc�y�����o��]G������˨��/�˼���P!��A�D��F�����m<
+7IQ@��2�?Q�Xk$)�7�� ܴO��t���a����@ŷ���KP�{%����R+�F���y�%��c�.S\X�W�_jS���[E�U��Tx�=����fU�92{�2bl"_�����n۶væ���>6��锆���Ϗ����]�$�9�gϑ?����x����G���Fz����|I4t�۫���|����=5��h���+���ڶ�W۶�v۶駶��?�m�m������؃�z�6SŶz�Adډ���5L“��i���/����%��8S&�G2i?�_�O����4ơI��L������}�q�i��Դ�,�+�ˌ�)еO�>��� ��Or���Y���$��m��H��� ��| ���՞o�/����d��8v2J������;���twk��M*��ظ~�����o��Iu��\�򍒺�Çq�h��~�Aǖ�Q���o���]WcK��TH6�h�E� ;�A2��q& ];� ;�6�'N�L�X�n����'���l�x�/>�����N}� jn�&�oI|'\Y���Q��f4+-~u��3t��v,{��2{c4Y�Y�~�:���s>���}�^�x �ڹ�|F�s�>�Ϋ���JL;\/�V���ʉΆ��#��T����0�.�����|?��+֗�G�
+�J�De�Ťx�KJ��t�H!" � X�T,O��'���e�]��6��˿�8�Ƿ��b�?���Vܶ�C�J�'� ��CP�)}e��Q�onT����u{
+�@��aU���4��Π SR/��(���g����Ҳ�A^�I/!&[҂B!���i��X���Uc����'�%�6�hV�;�g��M�u=m�]��ls�U>jk�7+�jɠ��Մ0Г{���+�-�5���-�n;R�9!���!2|�'^�\����#��Z'h��,�A��q�6���h�y��/�T�������
+��ʟ��_�����ɽ"<
+��8�VSS �?�����
+��77U2tː�B�/�{�����N�}-�iqi�xj�kϙ�=hɹ�Z�p�d����7�t ֤Ge���|A.�Q">��r�Κ�h����P
+�a��S�l�6���A�8)(N�A�SpV�f��S�VB
+��u�ʠN�+P
+��e��(���\���$8 G`T��P �a6C����Є��P��h�/T`�f3j@�a3p��1���[m8��Š�8o ��~���x ~�D�yT�94�.�{��LbE�v�}/-�ޑ��^�l�^�۩{_���пjl�b8d 1�5��?6��ƙ�APl�"so�b�AK�e�冲P�b5Y��c�����������\��=�>Ծ����[��Q�X�x�q���}Ǘ!��!�B�t��c$�|�
+X sa��R���0 �!R!b`��ȃ����RX �`:�A/��BX3!b` ,�c�`-Q�͂%0 �2�%�  �`L��P10Ja:,�9�������b`T� X
+E@ ��!ʡ��xu�%0W�.(K� Ⱥ��Χ;���l��F��
+H�%P�f�,���*uɰf�R(����N�����࠘5f�(�吠���N
+�~te�s�!���5H�����ohb̿�yn��B�⊐���b�1P��-.���*�2�m�`���f蚣�"�,�pf�wgu��IX�&q)��.T�_�sm�r�K�9Zf8� s��ŝ:>f���`Q
+����IG�_n����.�R�ʏ�ѫ����Ĩ�5{�`� p�N��<՝�Ӱ��L��N��M�r�e��
+��0[�� j:�A�"()W�Y�rb̂�*<mNw=^��
+�v�c �S�s\��0�U�p[�}�m���x!�
+-[r��N[Y��>��s�*aۚ����S�4nh�|���S@����}��y��'�X
++T|g�^@�N��S?���Ɋ.����–;=��]���+����T
+yv׺��%V��U �o�)�
+�� h�F�X�RS�����i�,�Z�n�,��4u�q%wh����1�yL�\�n����+ J~ګkR���;�v^Yҥ��vsw��w��+-W�*Q������E��O���Q7���i�3�8#��ŦN\�6,�&�ePs�c��a�Ϛ�N�E�(ń��h��Dw�k8���9�{�sI
+�C! �|��e�zG܏U�q�G��*, ��ž1*l���߆C!�`��|(V�ȇ�*�Q0F�=F�(T��r�"#�~����٨�^�R?���*.��`T�U��J@ۅ�Hȇ10���<(T� ���긨 ς
+to��
+�c��Qm? &�( �#�>H�!�q0�0Ȃb�
+}`"�!�;8�0�B&DA(���B@�X���8�����à �`�ɠ@ L�<�O��
+��D�^7� �ojjj�nlAZj`��.
+V� �DN8'�������H'�:J�_E��^ž�������z���^k�c�&�k>�G��m
+�� �m
+�oN�r�tr�N��!m_am��5�:�E�B��\¾�!�Kȗ�����wN�� �sri>���%�}�>�A> #�Ԑ�9�'}�`q�|PC�������������*�n?Һ��Z��N.�c`8y�@�s�N�m��s����'o֐��^v��789�����k������A���S����NNl5�vr�D��|�5q��cS؟��?��ǎzٱ)䘏��#��!���˜��� ��^���r����L��~N^��N�q�{i�������t�<��ʞ�I�Z���$�߭"{��o9���3���
+c�%d�o�+��F!�6������vp�=��=���8y:��Vd�5�橣������ž:J�ZC�|�˞�B���m����'��'��ǽ���˪�Ƕ�cv��H�*����Tn��J/�b%�9���FN6��� �������:N��Gǒ���y����*���_�"�\���4�G8Y��2N*��X��T4"�}@����t��,��Ŝ<��"N��e�5daYO�p,)�Ip2?���dn:)�A�%�9��I '3g��LNf��f��tN�q� 'S'�T3�RB&�N�dd��$#��I��L�d<'�G�����8N�r2���V�ќ���"NF�$6��G��dXa(�E
+�Xa(�ʆr2d�� )!����(�%����,2(���ȠF���i�@ ˳��F >=�3��2����/��|f�kDk|z�kҳ\�mD>_ ���(� �Ar8�ߓ��$ۚDzKHߴp�w8��O����$s8��z'��,��tkK�$-����Ij8II���P��a�GIR�`�d'I�X,�K��^���@��&��e��ܣa�xI��8��I<'q� �c�|��B<��Z,,�wLs�"1I$z8qY󘋓(N"#�X$'���0�I'��8C򘳀�8�XHq��H"v��‚��f�c6N�(�Y�b�0�J�w��Y,Ģ��d`f1k� 2�Y��5"�KԤ'&�[Y�ȉA� ��C�N!2'Jb'�N��� �Q����$
+A��d�V������F���[��
+endstream
+endobj
+430 0 obj
+<</Length 9/Filter/FlateDecode>>
+stream
+x�{
+endstream
+endobj
+431 0 obj
+<</Length 352/Type/CMap/Filter/FlateDecode/WMode 0>>
+stream
+x�mQ�j�0��+�ArH��%C���C4�=;��Ē����H��Rz�����̮���x�ꊋ�s hUg.�}� �[ź�; r�S֮@�,:��m)�#����:��?�!�yg�j ��n����� J�� �C<'�~��B�$�ҝ�j�9K�Q��Q�j!����uI�̍(ܬ�t(>��a[�Z�r`�N�L
+�!!�t���
+'�����y�*
+endstream
+endobj
+432 0 obj
+<</Length 550/Filter/FlateDecode/Subtype/CIDFontType0C>>
+stream
+x�%�OhA�gM���4Ő��3H=$i��J/5$Rh#بH��i�wew��E��2��$Ĉ �^z݋"�jO9z(=�(Eؕ V�\����{��N�0�?�뙵�"����r�Z�4gΛa
+�f��zA�ҩB����0<w�=vE
+�P�p���P�$T�Lj�����(���%,"R������ <A��#�K��I�
+!Oo$��VNb9�%�DJV�%)i����B|u%�ͯg�A[��J����
+�� -
+endstream
+endobj
+433 0 obj
+<</Length 10/Filter/FlateDecode>>
+stream
+x���
+endstream
+endobj
+434 0 obj
+<</Length 407/Type/CMap/Filter/FlateDecode/WMode 0>>
+stream
+x�m�Mo� �������5��v7�"5N,��5��فI)�����i�ڃ�����w
+@��DT��+���+�WP���l�����=�|sF0�Ii�r'8ƾE�
+endstream
+endobj
+435 0 obj
+<</Length 4907/Filter/FlateDecode>>
+stream
+x��X pSו��;�ʖ%Y����l���ن�*�`�� 1)$ؖllKX6ء4�����q�lK�7!)����n�d� �m�di�N��Y
+i�3.�t�6q��ν�I����vw���zz���|�;�{��
+��V�_�<��� ��b�UM`yx[�Y[�G͠�X+�a��<h,O��E���aXM��h�A<Eo��r�}��r
+F��~�‹8���Fq��1�W��-�1V���>V�γ8V�6z�x#x
+?b`O1�*�y���x W�y�8F�y~���]L0�4f����
+ b�� ���⣭�5v^6u(O(����{/�+�Ve��.���I�c�c�� ��6�A��:|�7!^ ��$U�#���Y,��畕�+X��q���� gcFLI�$�^~o" ؁�~?��UR
+��Q�]��nlq�x���p�W�%�9����!���TC��ŷ��y��U�y?n�bQẆ��+5�j����uM-��[|���r�T�1at��G��v���=�|��Pފ�,�E���6��S � ӛ�� ��,��)*JΜ_
+˹�s�)V�����*&Ô5��6����L��pP������M��AIV�0�d�_����eV��e��({��?�h��v��%5��E<Ґ�M1RH>�ڗnv؊ɑ�(�29>)8\�:n�R�rM�vG�gYEy����y�P]��];�=�2~�eh���{�wt�O?�񧍰d�R{U�@�@{���)@=e�#^�+��M<��ݱ\!z�q�X�����bT$G<ִʥ(�e�rZe麦��Z�%��-�).+s����X]���mg�Z {E{I{ç��d�<��iw]�UIخ5 �.����X��w�#UI�/���d���S����q��]�̸�`b�ԛٷpA����|GZ��1�rZ&όO�_��*+++u��T�u�j��$�fM�4>��bVQ�_�q�Y�Y��3�e�T���-X`�f�� ���1�^��7��g���kz���Oj��|'��Bw�`C�rt��c?}��X���k67�ڸ���?�w*������-���E�G
+RU{��GT�s��U���TV�ԡ�w)���.:�]����=9Ύ�{g��������B`�2�J�`�Eu��ʢc��q��#�%q
+_����u��וLeX�9-��7�%) X?LP`�W0��X>8D���@`��ˀq����Ƶ�X�ڸ&,�o�ku�5G:��&���u,rY�q�,d\'����u��a5�a}�B'� юEpƒR�� N�aN܊.�#�~���V��NԢ�(�U�F7�h�b��7?����ňC5�؁Vl�
+�;��U�hCPV��̬E�
+\_ ��!pE��g͍�� k��u�+���H�:?;�t5�J�z�x
+d�^��������ibя!ɷCV�]<K���� E� �Bs��#Mpy���3�F��u��KX��@��6�X+��4�P���қ�q�oF ��L�Qs� �O3k�oV� Oo���Lfۛ�ˍ8�*�JK“���z����gn�N8���}3���N0���Gz��sop.�F���B̏���3�M�;us���~6E��l�������1(uֳ�!��SL�~q�DV̌����;F�Q��ϰ�QعY���ݨ���9k�¹7�Wrg���g�F����ӻ.��D��=q.���\D��;�*�d�\������E��x��NKWQ��Q�nC����h�v6` �q��(�j�'Ј ،ZT��2.UrD����xj%�l�X:F#�$�8%��T��u�E=����H5h���(�ףu��6���Q�M���ke7�۫��)毗\t���0��lV�)�l=jЈո��­��x����F^�Gy�1�VI���\�M�����MhD6�I�)�� ��҇5h4|�� �H�Vc�E�X���,YK��L�Y�#"�^Z]'���6Q��(�9@��y�7G-7I��P'��6I 5���(n$w�J�[Wc��O�
+ 1&Tz�Eg6Έ��i���`.� O�"M7�$�6;:7ʎ��%�&�����Ѐ��H�=k��� muL=������D|�ed7b�1CǛ녾C�i/�T�W��l:�Qp���,��zU��L�,��[D�c"J:s}��6"q�d�gd����7��"�>M�б"�gGP�)t�ꕤ�S�굫��s-|��=�{��Jg���3j��N@��k�ܞ9����Y?���yf�p7:�"OɅs��H���n��hf��}�� ��]�~~�������!��"���2�y/,��鶮���K1O����7;��>!
+.B#��G^�ߒ�U�s��{�<�>|�D|�$��ݰ<EE/�%�d���}>��D(����3'���'�V\ׇ
+ :g0�wz�!�
+a3�/�}�D�](���A�.<��9�� _����;�_|g��
+ud��>
+�So�iޫQO�6�s�z���]n޽����Ν����w��.�<�Ύl����wd��B>��5jӨum��.m���o���v��C[�l|��Ztl��6{h�F�M��BM�Ը���ic��otP��6hT����i���4Z����)��a�M��&h���G5�)�fU���t�J��yh��Vޒ�Wjt�g��-I��xZQ��W S�g�yeU�W?O��˗����iY��/K���t^�����<����Y��=>ZZd�Kө�$����T�N�E6^�ME�V^d��1��5��K�y��
+�x���I|I2-c�x��bS_�D���~��u�0�����t^�O��t�^G����tʳS�<;����Y�]�� w�SN���dRv��gk4�����<;ee��,;e��aV33�<3�2uN��<�J��j���֑6����d_N),��L��CV��['��x(9��'�$�xR %�&��lJ�O� ��Lq��ؘ�L���1�8�@1�C�j�fn�#��>�r3�1o��)���II$g��1�;x�-���_������x
+endstream
+endobj
+436 0 obj
+<</Length 22148/Filter/FlateDecode>>
+stream
+x���[��6���_�-�E_�+���=�؞q�x��>���UgJ�{J�ޚ�3���'xD2I�c���"�e2��@�/����O������t��?}���w�7q�7���������oފ���?��(�8×��������~��'@K�&n�Ex��������x�������7#���7�����/���/�����?���� PH@R:ys�J4lPJk�e Ix'���
+��)�
+�#Ɂp��8'y�.z��L����m�x?��%�Lj���[ �z�a��Z�2θg�9#�S����i���x���)
+����P���kv���
+����WjR]%��oR�d?�V,iP[A�u��M�y����l�Ea�!T�I%�[p v��V�7���~�it=�����!�b������R�3���N*a�=���u�ݣԅ&m�k��H� &A�6c;��Ah!֩��Z�\�䥺��O ���Kq}Rŕ���p��T/r@k���Z�Qw)��Һ�;i?�Ɇ� Jp��`@�G+NJ�Ο�\� M�3����?O�/�z�|��'��� ������%���1hu��%n�C/�f�%@g���j�+�4�F�.WqS�$�y!r��M��?�C����x�*>w�_�![#u�������(�QY6��†�r
+Z|1��!6��Efr��b�/�R�cɼ���7r�`����~IQ�z�|�[0n�����,�7��:Knܿb�o���� �,��HrDӟ��I&u��b̰�����R��ju�-�Qz�W��pߏ��w#E6�q�����Exnj��4x�+%�4�t�gK�1�߷�
+����*�7�5+Z���o�dnlR�-L��|�*���.�}="5xkF�
+��q�=Y����*�GPr<�ʵc^2�
+*��r܊�K�ZԹ�y�ނ�=_G���)�Fy������z���:��Wb"�INR
+Ph��?��D���H~f���Q�}fb���*�x8O��Z�p$_�L7d�,��b�{=�:K�ʓ��W��m�^ k��6���� _�ŦM%�0��[��0�/BU�Y�UT�Y�`�d)Wc�b-B����!�!Z�����ɩ�B(1n�<�//��r+��b'���?b��)�ѻN� ��`+[T � l�7����ٞ��,�1�M
+s�.B��/��H�-�ɷ�Ƶ_�8�n�������W�1S�1�~߲]����7�ڄ˅����G�^�uS@{dX<�uV�C�����ʞ�
+b �=R�֢l
+z7�x����`��s��`����z�� �u�t�$ ΘΎڽײ+@vf�;��s��/�yЦO�����(��$p�%�=}��Ǡ�—�}��+
+��>�l��\1����'��+�@�;�L��[x7c�.EqYQ��(��@&c�wG�Ķ�]��YQ�~���y�rR���|^J�F�/�*Gd7��I�ҩԩ"�t�'ש�o�4�����5LC
+����I�
+����0��+�t�K;N����Ǟ\s�[ G�R��a�I=`�rq��K[���I�^���ձ����^n$�i^ȳ�gۀ���J
+�^�࣡�K<
+w�"���Z�T0�]�դ�n6E!�O[.(̫��}�;���<t�m@_����ݿt����/e�5v�3��� Ö�����@1�0�l]J�V�]Z֦ۢ��w�>g���Qm�Ҩ�`�B�� v)T���Ҩ�����v`�.ujQ�����NHi�3�Sځ�H���jЗ>5s�" i����?=��K\y�.U��UA@JL��W�L�Tf��o��]��2h*ђ2ؠ�t�k�·YŬ�h^xjV�&m[ �
+��n���υ��k۠�C�<�3Rq7B}�sDv�����4ŵ�y��Ϯ*J2@��KW|g���R��ݥ).j����Hp�w�������f}�C�kP�[�+WSy��ێ���mؙ�g��{��x)`[��A䥀��N Қ�H�ԯ�Ȃ���h�.��^�%Ы��R�*����E���A���L:��i����ϒw�S�$�]�T�$�K���r�.}��<�K�:u�6kSkcȑ+�@jk�rrr����}��d��z��S���S�c'PR�#���Ns��@��Ƈ��yp��6m��fBq�A���1�mP_*�<~�`�xx�/-y^J��+��$)���?�2#q������"��󗼦��&J�~EUow[��1m]klCd@h��=��$�2�o�|�{���t���6�T8�[
+���>��v����[�s�Z{)<��9!i���DJ>Th~^�&уs[�|��TH,�a�����
+�)�ڀ�W7@ħ��c��΄����( �2϶e�<���>[I�ʁ5���<{Ҕ�@��e��K��
+�j򾌳
+�.�l�8���E�0#�g�h�t���CSM�/��
+��T�;X�R�%�\Zգ��Ru�.�jQ���6�����O/��V�A��)"��aR̿�}�y�v'�Ú}~:�v�/-o��ԼgW�$x�Vx�y�Pf�H (K��+�a+�.MoQӛ�I�c�:,>��L* ��v5ǤT�g�\m�ҭV��K�zz�J 9��K�Z�2 R�|h��R��T+��4I͐r�hs'Z�{��ƀ��Oq=P�_��?/pB�V����n=ʗ7R��\�%ʍ.���i�|J��$����㓳I�����w'X�x&�� ��g�� (��&}I�g����V���3�l���6�^p��]�x�
+I�PZ䎽��x�d�d�[2Y�-V X��i����T�m��2�
+��]���\YK�N�t��e�<��B�w�2�͕3��rc�7Ƥ�e�� ވ��ZY�V�;�c��ֺ�"Y����#���>��� �dz^{i`��݂��3. �0 ,��K{v�;v�'�R��`��0�*`��x�.�kQ����J��S��WR���[|Ͻ��t�-NZ�2I]hC���.�?�'���f�a�S>s*FߧҴ�_e�p��_$(����m~�)�*k���q�+��|�
+oEޥ�-�u��Qܿ�[�h'�TWk��=^�-ʋ ������-UGO�͛� ����pY�9��������;�n�GC����e�!kys��<=�{Y��)�U�Uƻ����<r�+^I�F�Wҵ��jnt����C�K �C�<O�ZI�(v���@��k{K��_)� ���l'9ƫ=,5�|�g
+�ו���ؙ�
+��{6�h�C8q�[\�q0�t���:��03=���>M%���!����i=���&��ǵ̅E��=�� &�!�C#����e(�6 ���%�N�)$x�,� ������<w��x�Kk�i�9��
+���W昳�T��Y�>�x`1�w�ѯrĞ�t#��/WfzM���i��z��R���Q��P��@�A�~w�z���)1�/+7}��T%��U�� �*��T3 �Ү���/cI�9����
+� ¤'�(����(R!>{ߌG��F��/����܀ �8z�j���
+7 �2h�� ��X.;w�x d�c�5�U��g�בj7j��Q�����7�,�xb�IX������n2l��|,��̂x:Ƣ4X���f,�i�m[�Rq+(4� �-2��]̌[L�G��>��g���zJk�r���W�]�tu�儠2Z���~Wz�_���r�s�:��
+&*洒�r3�6�(�k�e�L��u_��$h2N#Hc�c'8��,���ޖ�
+WQ�MIn�C�0B^��#W����
+N��M7w��e���-oz;_S�6 m�xG��"�-f���u}�>&�����7��f#�ƈw8�Y�p
+>NA�ԩ�H�9��^ ~*�B쬲y�r$�}VZ�V)�"�q+���nd�yc��1�Q>J<��Oɠ�`�ʟ��D4\m�tNbPnn㹮���v$>�.c陀57��1���ڸB�ٛe�����4�9CȪ���r�[ K3P��ׁB(1��T����SΓt�e� ��?��T�B/A)4�)')߁��Iʎ�U���� 5;‘�XQ�0E��j/%��m���w�r�K���J��y.�� � �nN�ߤ6�*2�[
+�s�{Z2u�@�켴�D:�0��CۘF�-N�� b�}��0�}�!|R2��������;p�J�~n&HaA��6���PM�L�X�i���d:k^b�,k*煇ln]����\*/�j���`H�m��I �7r45��\쁊]K�����"yӹ�a��,�ҋ�$i� `�v!��k����=��E���R���Y��s
+X�³�����{<[G�)�l���F �#i~`� �\�7 ��,M"�����+�����=iR�@O�j���S�`�2U5o`T9Xp�k������8㵄�=�8 ��`9yN+�����:�`�p����@���=�4l`���׬�e4���+�\��v��\��9Q��!�|{�m��̴�;��X��Z�b���$��bj#�ޥ�o,Rm;�� l����UFw~ N��V��?�4�� ��R+򺝷0p3ݦ��Nj��|;�dq�B ���,xe�>UǺJ�fl��A[U���"u�^ޑ�)͢���%d�)��u� ��f�ȼi�i޲?9XA���FA}�
+9^�{7� ��`�d�*(�΀%%l;ʹ��A��C9]�sfj#���;-f<2����LmS��z�}H�������0H�a�L�+Ϭ%�R�"�-�ˢ�԰6�ͤ ���� ��j �� V����֮TqU�O�Ea����FHT�y�,�-���@�\�����=�e�#���j�rL9�ߡ�ςЂ|%
+�Ʀ���2K�5HE�< �t�U�@Zˮ���8������jp|ƃ^���\Sh,uAް������נ�4a�dy����C7o�,�j��N�A�1�9�
+򾄅č�>�W��)�[K�Z��]��㰤�J�3w���b��/jKi��QM�SGSp��:زI|� ���T%[�v\+�j����zn��d�r:~�`9g����6��WO:Z�L���?��Ï_�ˇ�y�ہC����hi���6��7m��>��2�Q��im����O��i�SR��� �j'�*1��cc< �l����R�&e��� 0cJ��SG�0%!O��񒟊2�Ӽ(쫺׺��TP���y�{��^���z*(͆��dVNX��MT�]P���H��v4kϚ�f�^ᒤ�JM�=-5�HƧ*4t��I��[j^���*"�-s |��m�?�x��klC�p����(�/Xpiq%��-_p�뻧,�; bs����8%��.��b3O���?Tnq(��]���xy\�h����t�Y�4��#��޳���5�?��[\"q�t����G�Z����%"�<#o�v=O�)�˝�foiHm����\��q�禕r`�����ٲ�ڀW�um��M�ۃځb���Y���ۀ!�D�v}ˮ���H����o��� 3������n��tE6<H��#�E��qnTn1L$��-{n ������{^H ��;����ۦ��Z����{>�9 ҿ�z�%�/��������Ֆ;L6J���:Z�ww��/�-��R�� nM\x'��)-�4�,ٮ�i7M;���  ߚ��٘V���Z�(}�ݖ��T�n�@y����9�Rpi
+C"5K] ���mO��i��W�+�,j���cn���@0Q�unv����Aw?|�)̷g'��Oph
+C� ���۶G[M��q�X����wzv�-�4d�CÏ?w�h���p�, fh�ud�᨞�Nc�y�h��v�@?Hg�pK���'9����L��X��ӟ(�<O��k:�P� ��n����+����h�X'A �O�#�G!6�����F�6�����*��y뫂������c_��|����k��=��J5�4���B~�B����Ru�ue�1� �ȥ�T
+�96r��+�n�\{�m˄A��
+��r��]����URg�>6� --�#>�g86s,vNN���q[:��)F�?3?���-Օ����x�+���HשAv�u�d�h�:��p�<!yJZ��'���e�)��5�r��O�@
+'�5&�W�lt��*�5�����;��Ɓ�aL71{D6sXü�|Ӟ� Ԁ=N�n�����FXo�߸�;Mi�zj����"ܩ"���M7�~<
+j�� j�B�Ƅ��ȼ��
+ z�*��I�1~���]��4��_.KoY+��<����R$J;�3a�-�z�w��rc�y�)äb�ĪA!(k�"B��}za"�!�h�NI����OX�d%e�x��pm�s�S\��m�k)�w��*r@/�'��5���8��ƛ%��Xʕ-�+1Ӵ�2�<b_����8Ç�bG
+�P���ђ�%��T���O ����Z
+�0���m)Ya"J�kЩ�E�5%��eK����o;yL�ufv�]�PN=4T�PN?4�b�4Fۧ
+X5][! ��p=�c�v:Z
+v�Z��L7�1�ȧ�r7S}��G��� r6�l�����i+�RC����6d��ռ(ʘ���(���� J@�hňс1F��k�a0��[̄�"���f��ቁ��lɀ+��F�n�F���16�TDl+GD�Z)0J��v\����O���,�,6��>U�ņ�����
+�1���
+���eM���\H!���H ��+&i;��AI��u�<��4hp�ȝ]�x��h�A FZ�q��G�=qC��5�c�2�b�2ݝ�Kx��_��d0�� ����Զh�♴��m��%���9i���ti����W��0P���m�0�P �x���kǏ�Gʊ�G2����h�eVZL�˛�����_��� �=F�E������]�5h$ኛ�ʣ$�o%�����8�cvk��zn\(��Yg� �M7;K>x��'��;p��?�w� �涙��
+}.ŖjE�4�הܗP�}�mB~XԬ� \fy����<O�[7��o=���ݞ�qM��R8��V��1 �'I����M�zS� f+���~����o�+���j]ş���
+�d��pd����+ \��Lh�z=��ve���7�=AL�ۯ���G.�c�����[<Rܸ �H�1��dzzۂ��`�7 �؋U du�B��a�oI��C _��'u�8\��ԯ���8a� w����W�>�#p��4q�&Y+Ӳ�dߠ�~
+���c�����T >� �!>����2���C`ɚ�ʞ^�����JB:)Ǫ�z�tZSKH��=%�����as(­�UJ7#� ��Ƴ�^ y�Io�w/o:����-��<�J��m�:~�F�)�O�d�iM�75�V�ӌ?מo��+�kZ:����7�6�4�� ];�m��(El�
+��s�i��2�M]��o����C����|�?Vt�¤+��q�t�2-�p������CmT�Q[� 5�+=�i�E�wo. $ݦ�i�����u����Ok!�_�����袥n[Hb���1�bjsj:��)�hñ��K�UI�(��Ҁ.M�1逑EO2���go�R' ���n�ܚ���b]Y����C���k�R�s#8n�}���C���w�M>��y$(�M��w��D���Ȼ��Y��CRý��cC�G �gL�_�~Y;��rnNwR^��e��<1ouq��9}��Z{�Ʂ����aXɴo]�e�������/k�R�6�۷m
+޶0�<�a��ǁ�����1C
+1��G#{�x+��h ��eJj��5�c�3�b�3� �bzl`%���?������iѵb@��" "=�*k �
+��w��լ��-�4I���Z0�B��@�0=����2�H�Ɔ�\õ Y6d�J�M6Z��E���N�4\��p���8������(7}RW�RY�c� �j��%a*!�Y����R�,P�s��VsatL�-����R��G�'�&�A�Rs��ك��'�U��I'�:� �� � gyzl8���dj��;��V��a�)���%x߅M�<c���
+E��H �X�:I�*h}Z�a{� �VR��iB5G��Q����������^��}i2�Չ��2僇{]>xX%���n�><v2G��d;�r�2�Ү�&�%
+^Xt�T.� 3Dɒ��;��HϏ�@&�*�
+ ��[h��?S�.Eb_�F]J��F]}��WMueDK1����2 ����0\��M4I�%Ѷz’��w�w.:�� ɮ-�5������[V� G�w-79ٖ4��~�����V/Y�cb�:������-RQA��D��=�4Xo@w�k,vkK!-��΂V|�Z|�ԙW 9Hi5j��9����T�Q?;�${�|��m��4�n�i�L�Ƚ�3E�m��{p��š���k�k��泀�p?x!? X�U��d? `р�$�
+�Ĺ��6@�1��u@=�o��ǰ�ׁ���:�ôZ��>e��C�v.��q��8��l��g��-���ܥg�.=z���K=HNJ��1K,8�я��S�oX��*=z��a�/7�{#�$> ��fCW�\q����UX�2���-�Ҧ:�7�D^�?�����ٲs�3�w�ݢÅ�D�Q����vYK��{^H������
+�x�j>mj�(���jk���H"W�D����Qs�m+���<�t�D��D%8ϕD$j����G
+��dbH��)�,�̋.�A��� ���4�SEaMEP��JI�DP3�A�k"�t�QM5�ۧ��r��T��BJ3� %�Z��+�b T@��]��Pa�@�di
+i�K4rl�L2΋���IˤJ�������y�P�e,$`��]k ��B,�ƮOb�t̕�Or�9����Y�A� }F�T
+;] �EGbh��vZhI�V8�'�Jc�#!t6Ҫ�m���;e��@���*rQwȰh!�JP���&�&�h��G���AG�g���V��bg(9T5C���2$��w��l(�~�ާ�L�Q6I�?�O?N8��0�a��BĆX���E.W�]�K@†sZ� �t��4�U�����Q�ށQ�5�p\��
+�y Vk0����O,@��yR�zU����Hh�1|�U`=�m���p�ׁ���:�ó^�CXVKP���k@�v�k�TA(˸}� Z̝�JZP������{" '�������?�S���H�~ ʙX2�T��w�d�M-h�����Z���֜����q��s8�8D;,���S��-���7wm)ŮW���#n�"5�X YקI��Byjj�sǡҚ��uv_aכd����*�'Lk�S4Ih��ΗhzX4U�W)�:_2ɪ�Ay
+�UյW�%�5�t6�TU,5F۶~�����9��ܾ��m-uU*�7�e+�0��/�������>�Tƒ��%��S�jrJH �>,�89ejr*���kkr���)W�S�����Tc�m*K��?���8��d��<5 X��Fr���ץ|J~� �n:�+�w��)L��O�Q�O�҅)Ó�I�<����N�!ˍ�R���
+��#9�y
+G-��Q;,��D����$:q�t���4/+��<��F���g�#�U IT�s��5�L��ITI�Ҿ��5짙 �v�'�@//��I>� G���}�ֹ�㐀y��%94���T�rx����#7���8�A���g�/�yn��0R8�P��?PB�M*�B&^��Ýi�<J�z��r�K6=(�
+c�#٤ �3�|�T4ɦ�SXla�p$��aq�l*��d����&@�Gܦ����}�>} SΓeS5���-獵O��us��m⩚�,Kʝ/��y1��p�j"D;,�@E<FO��t�&G�9���vc�I�f=�8�;p�:FfG⩴�m��duL�T,��eI]i��Ra�p$�Ђ3Z�o*���R �9������k�R-��|�US�#N�N���-)��)z%(�L�+���Ri�H�Y�6�l��8�wZ�F]گ�e�ʩj^�t`�郜ua q$�b0Oa���đ�j�����ky����?{�Y �s��
+�#~[��c�Ō��0�̿�#�:�s��M�-�E�R)?��WR��R�� ݀ü
+�
+�p(1ޟl��Vg�����oN
+���I���:Q)�|��Ҏ�ML-\WȧR�b
+oy��N��S+~]Q+J3�4c�Dg׭Wi, 7a3���Ft�d��T������0��" k����� ����-������A��U��3���U��-X���m�B�vD����K�SC��y��Z���Pu���������#Y��=ս��يȣ��ł�?��1�JQP�8� �� �;հ�*z du+4�=�Ӌ$�O � e�-�qf�^k�BЂ6��眽]������b�Ai��Tv�튩��1 a �[퐔�5(�W8%��x��ҁ2V�}�xa5o���d[�x���� ����~�h��*��͙�{�5C�0lZih�kH��QU�U,x�8���I-xm@kJ�F�8!��Wt�J`O�
+T�q�L����~���c[07<�قs7 ��x�s<`��m
+N<4`����4p�KL�t��c�]�6I����ZNm��S�_���X��S�}�0�m���*����/~��_>����Nqw���s?ͪٛ^.��$�Ѱ�4R7z��ce|�Z�{�P��u�r�#͋M �J��-o�O�F��C<:�PzM��<�b��Ѓ)=X�"3�;l��. ���/��__�J{~KK�� ��� tx���2#�1�+�QY��ƥǪ�����{�=%��?�ߘ�d�\��s�$���TXr�8���� ��� ���9<UHR(0F�j��/���U���j���C�(ɟ�Uaբ��,{+�� �*����v"���4!�:�熸�]�8(�y�C[#ς3MK���2}(�E�a!���Ck������E>��K* �E�h\���I�0���.K���ٿ����<;��y*���a�mf�1�X����\�q���A�Jd��&�(��1���}w�N�w�<��K=�,�޶䝶�pO4Ri�0Y�d�u�&�0v8(CA#Zd� '�C�,F�2� e ���F��kOv¿>O�a)�р����_Eh�Y�wt 4�V�ј�%�����jI��d�Gʰ��9;G����j0�)�OZK��9|�� �0t7T/]JK���z�Y���� �� �u�?���ӂ
+}��J���!j>��q����5FV��Ɲ1V���z(1N.����Ύ���/�b�n��:{_m�:C����ķv%j<���`�>�Ɂ������PMׁ�d��pd��S:�4�.P(ƫW�J2Yy�x�"m1|e�<U� �R1�p�U$��,�E��f��Fah-ή<�
+��D��D�ϛ0��u���iҒg5*w�F^���G��YS� 'c���W��;���A��c�����W�����/-�Iʃ4��MxXI4�3sq2#joVpK) ފ#^�^��r�-ɒ7J�u��v8��E�R�P�3�=���X)p�#^��$:���ۯ��`g��^��s6��H0P��ހ��
+��[�0^+&d�\�dڍ��%����XP� '�ߞ�s_Ȣ�<w ��[f�6����=�<&$��Ï{�Is���*����$,%ɴ>(Q^�P�tWg+L�'t �m/
+��x�2g[���#e�`�:Q�
+S�I) �؞X�'��][O�ѣu;n^�^��C�����i��f�v�jYq�rr����C����<�}��%��+[���[���T���Sf���?��>�8����$�;-��vzni�@B܍������
+����Z��;��ƨ-�ݍ�bO]?�M7cm���VI0\��6^�s�<]hp�`.j�����s�S� �rt�F˛���j���D0��� �}���!������XeΫ������ɏ�s�?��$�"l|���>Nߠ�2���N��;O]�4���Q�˃-����>m�h*�ֵ�l�9�O!��V�p����� My=}X���4�vo:���ǧ�� ���Hz�z4����=*�c�> �h�o��G�Ơ~n=��ɂ���X���cY���lʠs�H_�TT����n ���Nd�pƴ��s�LT0e�J`6�s���ITNN1J yƀL��C�C��!Ot0SP��
+��!О5��X�X!�ײ���M��#�E
+3صu���d7��X�:���*�xO�o>�?�r!7T����s�F�a���x+���V�h?������Hpw4l^YRu������@jV�1[��8�)(|�r�5S$�&q��R�(����]n���N�
+�ka4���Swõ&�;��$�����)* L'�c"�o�}�J*r L��=���p�H=�VfU�\� b���n�a�y�$<h�`n� t��A��p��[hߩ�5��T������ v[�,�^r�FFzy#)O�ZrP�kd�v�d�x���q��'�!��I���xrej{��^;��(۟5��J��@;��Ѭ2ܲ��;)����*�k|�L��5��E��qk�u�%�o��My:�
+e�0��$7�U܂�1!��K �BhЌ� K��s���[��O"� 8�'� [ o��͓M�x8��=����F��׭Ϸ��Ӝ��q��
+�3�G��Ni�;w\q�Yo�=,W�ܰ����Z@�R�����G�:Q��^�e��Rݺ64_�re8b��eיh����y���B.V���C}矊�i(e<�R���F�a����'oA�#�j���b"���zך���$ x����8��
+�=�y,]X�ݫ��f�|�4X>���
+9��'����<@.6'(��>�.�rk� �h^�?<�=!��FZ��y2-ۊ�'-PV[v����:?��ϥl�!"��b�%�J�����võB�E����
+��o� ��J6��!|a��xJ�^,�;�!f��?[�j
+���'�qNs"I�g�2��](~�����$9)���`�=����'t�a3tD���z��K�7���ƮHd�������F!q! ��t�.hѦ4<��6
+qO5���;�m�����$L M�E���H��#�g��"H����������N�� �G��D�LiNo�!�o�/s��F��J6��si�BxJ�y��(�j �z��pZO�f��78)��%�-"z�I�0;���lT������jkD�0lt�vx��|tf.?g���A�v����'�*,��\�Uu���0�L�jJe�z������-��/)R�Sj �Gi����/�(@��뀗<Ij���5 �
+�ޑG�:T�������_!7A �K�@�Fn�I���@=�����b��dY#2����q��l�J@w�w��н��Brr5�.}ҋ�y ��s:�+�� �ƈԸ�R�Q�9�0�4�iͿ6dz7��;��,��a� �Lo��8���#-\͜�-$]��r�O<5��/t�_A=V<�:<��5���1�7�7 N���b���R�\����IG L���o۳�B�ǩ������-^�$�8�W�>�p5�Q����Q��3�Ɉ�p,*Վe,��}*ygSO����
+?��G��2�R��)�Q�(�0�5"��� ��$X
+��O�
+endstream
+endobj
+437 0 obj
+<</Length 314/N 3/Range[0 1 0 1 0 1]/Filter/FlateDecode>>
+stream
+x�}��Kq�?�U�X 94%MQKS��N�#Ԧ��Q�v��B�ˡ�h�Fk ������!
+��ՠ����ZP��~xx^ޗ��Q�����x"��^P��� c�!��H0
+ ��0l+��ߣ�y7���;�׫���;Q�?V.�_�tF��3L�E�K�)y ��z�80e�IP���k��T�/%[�p
+endstream
+endobj
+438 0 obj
+<</Creator(Typst 0.15.1)/ModDate(D:20261022095214-03'00)/CreationDate(D:20261022095214-03'00)>>
+endobj
+439 0 obj
+<</Length 996/Type/Metadata/Subtype/XML>>
+stream
+<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?><x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="xmp-writer"><rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><rdf:Description rdf:about="" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xmp="http://ns.adobe.com/xap/1.0/" xmlns:xmpMM="http://ns.adobe.com/xap/1.0/mm/" xmlns:xmpTPg="http://ns.adobe.com/xap/1.0/t/pg/" xmlns:pdf="http://ns.adobe.com/pdf/1.3/" ><xmp:CreatorTool>Typst 0.15.1</xmp:CreatorTool><dc:language><rdf:Bag><rdf:li>en</rdf:li></rdf:Bag></dc:language><xmp:ModifyDate>2026-10-22T09:52:14-03:00</xmp:ModifyDate><xmp:CreateDate>2026-10-22T09:52:14-03:00</xmp:CreateDate><xmpTPg:NPages>1</xmpTPg:NPages><dc:format>application/pdf</dc:format><xmpMM:InstanceID>lFJVixS5GtCfr2tu1oSzmQ==</xmpMM:InstanceID><xmpMM:DocumentID>lFJVixS5GtCfr2tu1oSzmQ==</xmpMM:DocumentID><xmpMM:RenditionClass>proof</xmpMM:RenditionClass><pdf:PDFVersion>1.7</pdf:PDFVersion></rdf:Description></rdf:RDF></x:xmpmeta><?xpacket end="r"?>
+endstream
+endobj
+440 0 obj
+<</Type/Catalog/Pages 1 0 R/Metadata 439 0 R/Lang(en)/StructTreeRoot 17 0 R/MarkInfo<</Marked true/Suspects false>>/ViewerPreferences<</Direction/L2R>>/Outlines 16 0 R>>
+endobj
+xref
+0 441
+0000000000 65535 f
+0000000016 00000 n
+0000000069 00000 n
+0000000161 00000 n
+0000000268 00000 n
+0000000349 00000 n
+0000000436 00000 n
+0000000530 00000 n
+0000000618 00000 n
+0000000722 00000 n
+0000000822 00000 n
+0000000916 00000 n
+0000001010 00000 n
+0000001098 00000 n
+0000001184 00000 n
+0000001270 00000 n
+0000001365 00000 n
+0000001433 00000 n
+0000001610 00000 n
+0000006811 00000 n
+0000006916 00000 n
+0000006997 00000 n
+0000007140 00000 n
+0000007297 00000 n
+0000007365 00000 n
+0000007446 00000 n
+0000007543 00000 n
+0000007611 00000 n
+0000007754 00000 n
+0000007923 00000 n
+0000007991 00000 n
+0000008085 00000 n
+0000008200 00000 n
+0000008268 00000 n
+0000008424 00000 n
+0000008589 00000 n
+0000008657 00000 n
+0000008750 00000 n
+0000008861 00000 n
+0000009017 00000 n
+0000009176 00000 n
+0000009244 00000 n
+0000009338 00000 n
+0000009432 00000 n
+0000009500 00000 n
+0000009659 00000 n
+0000009821 00000 n
+0000009889 00000 n
+0000009983 00000 n
+0000010095 00000 n
+0000010163 00000 n
+0000010319 00000 n
+0000010481 00000 n
+0000010549 00000 n
+0000010642 00000 n
+0000010740 00000 n
+0000010817 00000 n
+0000010957 00000 n
+0000011026 00000 n
+0000011096 00000 n
+0000011189 00000 n
+0000011257 00000 n
+0000011326 00000 n
+0000011424 00000 n
+0000011492 00000 n
+0000011596 00000 n
+0000011682 00000 n
+0000011760 00000 n
+0000011917 00000 n
+0000012074 00000 n
+0000012142 00000 n
+0000012237 00000 n
+0000012332 00000 n
+0000012400 00000 n
+0000012557 00000 n
+0000012628 00000 n
+0000012800 00000 n
+0000012868 00000 n
+0000012963 00000 n
+0000013034 00000 n
+0000013105 00000 n
+0000013226 00000 n
+0000013294 00000 n
+0000013451 00000 n
+0000013522 00000 n
+0000013702 00000 n
+0000013770 00000 n
+0000013865 00000 n
+0000013964 00000 n
+0000014032 00000 n
+0000014189 00000 n
+0000014260 00000 n
+0000014432 00000 n
+0000014500 00000 n
+0000014607 00000 n
+0000014678 00000 n
+0000014749 00000 n
+0000014820 00000 n
+0000014891 00000 n
+0000014962 00000 n
+0000015094 00000 n
+0000015186 00000 n
+0000015261 00000 n
+0000015334 00000 n
+0000015407 00000 n
+0000015517 00000 n
+0000015643 00000 n
+0000015830 00000 n
+0000015989 00000 n
+0000016061 00000 n
+0000016178 00000 n
+0000016275 00000 n
+0000016347 00000 n
+0000016530 00000 n
+0000016693 00000 n
+0000016765 00000 n
+0000016870 00000 n
+0000016967 00000 n
+0000017039 00000 n
+0000017198 00000 n
+0000017357 00000 n
+0000017429 00000 n
+0000017534 00000 n
+0000017631 00000 n
+0000017703 00000 n
+0000017870 00000 n
+0000018029 00000 n
+0000018101 00000 n
+0000018202 00000 n
+0000018299 00000 n
+0000018371 00000 n
+0000018550 00000 n
+0000018717 00000 n
+0000018789 00000 n
+0000018890 00000 n
+0000018991 00000 n
+0000019063 00000 n
+0000019226 00000 n
+0000019389 00000 n
+0000019461 00000 n
+0000019566 00000 n
+0000019663 00000 n
+0000019735 00000 n
+0000019914 00000 n
+0000020077 00000 n
+0000020149 00000 n
+0000020246 00000 n
+0000020347 00000 n
+0000020419 00000 n
+0000020598 00000 n
+0000020761 00000 n
+0000020833 00000 n
+0000020950 00000 n
+0000021047 00000 n
+0000021119 00000 n
+0000021282 00000 n
+0000021465 00000 n
+0000021537 00000 n
+0000021634 00000 n
+0000021731 00000 n
+0000021803 00000 n
+0000022006 00000 n
+0000022076 00000 n
+0000022162 00000 n
+0000022329 00000 n
+0000022402 00000 n
+0000022617 00000 n
+0000022689 00000 n
+0000022786 00000 n
+0000022887 00000 n
+0000022959 00000 n
+0000023126 00000 n
+0000023305 00000 n
+0000023377 00000 n
+0000023494 00000 n
+0000023643 00000 n
+0000023715 00000 n
+0000023882 00000 n
+0000024041 00000 n
+0000024113 00000 n
+0000024218 00000 n
+0000024319 00000 n
+0000024391 00000 n
+0000024498 00000 n
+0000024608 00000 n
+0000024775 00000 n
+0000024946 00000 n
+0000025018 00000 n
+0000025131 00000 n
+0000025228 00000 n
+0000025300 00000 n
+0000025475 00000 n
+0000025634 00000 n
+0000025706 00000 n
+0000025819 00000 n
+0000025916 00000 n
+0000025988 00000 n
+0000026163 00000 n
+0000026322 00000 n
+0000026394 00000 n
+0000026507 00000 n
+0000026604 00000 n
+0000026676 00000 n
+0000026851 00000 n
+0000027010 00000 n
+0000027082 00000 n
+0000027187 00000 n
+0000027284 00000 n
+0000027356 00000 n
+0000027531 00000 n
+0000027690 00000 n
+0000027762 00000 n
+0000027875 00000 n
+0000027972 00000 n
+0000028044 00000 n
+0000028211 00000 n
+0000028370 00000 n
+0000028442 00000 n
+0000028555 00000 n
+0000028652 00000 n
+0000028724 00000 n
+0000028899 00000 n
+0000029058 00000 n
+0000029130 00000 n
+0000029235 00000 n
+0000029332 00000 n
+0000029404 00000 n
+0000029575 00000 n
+0000029640 00000 n
+0000029807 00000 n
+0000029966 00000 n
+0000030038 00000 n
+0000030151 00000 n
+0000030248 00000 n
+0000030320 00000 n
+0000030495 00000 n
+0000030654 00000 n
+0000030726 00000 n
+0000030839 00000 n
+0000030936 00000 n
+0000031008 00000 n
+0000031183 00000 n
+0000031342 00000 n
+0000031414 00000 n
+0000031527 00000 n
+0000031624 00000 n
+0000031696 00000 n
+0000031871 00000 n
+0000032030 00000 n
+0000032102 00000 n
+0000032215 00000 n
+0000032312 00000 n
+0000032384 00000 n
+0000032559 00000 n
+0000032718 00000 n
+0000032790 00000 n
+0000032903 00000 n
+0000033000 00000 n
+0000033072 00000 n
+0000033247 00000 n
+0000033406 00000 n
+0000033478 00000 n
+0000033591 00000 n
+0000033688 00000 n
+0000033760 00000 n
+0000033927 00000 n
+0000034086 00000 n
+0000034158 00000 n
+0000034321 00000 n
+0000034386 00000 n
+0000034459 00000 n
+0000034556 00000 n
+0000034628 00000 n
+0000034701 00000 n
+0000034827 00000 n
+0000034899 00000 n
+0000034971 00000 n
+0000035050 00000 n
+0000035132 00000 n
+0000035222 00000 n
+0000035294 00000 n
+0000035366 00000 n
+0000035439 00000 n
+0000035512 00000 n
+0000035585 00000 n
+0000035715 00000 n
+0000035787 00000 n
+0000035902 00000 n
+0000035992 00000 n
+0000036065 00000 n
+0000036138 00000 n
+0000036211 00000 n
+0000036284 00000 n
+0000036414 00000 n
+0000036503 00000 n
+0000036575 00000 n
+0000036648 00000 n
+0000036721 00000 n
+0000036794 00000 n
+0000036944 00000 n
+0000037016 00000 n
+0000037115 00000 n
+0000037198 00000 n
+0000037271 00000 n
+0000037344 00000 n
+0000037417 00000 n
+0000037543 00000 n
+0000037624 00000 n
+0000037697 00000 n
+0000037770 00000 n
+0000037936 00000 n
+0000038017 00000 n
+0000038090 00000 n
+0000038163 00000 n
+0000038289 00000 n
+0000038391 00000 n
+0000038464 00000 n
+0000038537 00000 n
+0000038610 00000 n
+0000038724 00000 n
+0000038838 00000 n
+0000038944 00000 n
+0000039009 00000 n
+0000039067 00000 n
+0000039177 00000 n
+0000039242 00000 n
+0000039348 00000 n
+0000039413 00000 n
+0000039523 00000 n
+0000039588 00000 n
+0000039698 00000 n
+0000039763 00000 n
+0000039873 00000 n
+0000039938 00000 n
+0000040048 00000 n
+0000040113 00000 n
+0000040223 00000 n
+0000040288 00000 n
+0000040394 00000 n
+0000040459 00000 n
+0000040569 00000 n
+0000040634 00000 n
+0000040692 00000 n
+0000040802 00000 n
+0000040867 00000 n
+0000040973 00000 n
+0000041038 00000 n
+0000041148 00000 n
+0000041213 00000 n
+0000041271 00000 n
+0000041381 00000 n
+0000041446 00000 n
+0000041552 00000 n
+0000041617 00000 n
+0000041727 00000 n
+0000041792 00000 n
+0000041914 00000 n
+0000041979 00000 n
+0000042089 00000 n
+0000042154 00000 n
+0000042260 00000 n
+0000042325 00000 n
+0000042435 00000 n
+0000042500 00000 n
+0000042606 00000 n
+0000042671 00000 n
+0000042781 00000 n
+0000042846 00000 n
+0000042960 00000 n
+0000043025 00000 n
+0000043135 00000 n
+0000043200 00000 n
+0000043314 00000 n
+0000043379 00000 n
+0000043660 00000 n
+0000043790 00000 n
+0000043863 00000 n
+0000043940 00000 n
+0000044034 00000 n
+0000044394 00000 n
+0000044641 00000 n
+0000044678 00000 n
+0000044729 00000 n
+0000044780 00000 n
+0000044831 00000 n
+0000044883 00000 n
+0000044936 00000 n
+0000044987 00000 n
+0000045038 00000 n
+0000045087 00000 n
+0000045138 00000 n
+0000045189 00000 n
+0000045240 00000 n
+0000045291 00000 n
+0000045342 00000 n
+0000045393 00000 n
+0000045443 00000 n
+0000045494 00000 n
+0000045544 00000 n
+0000045747 00000 n
+0000045904 00000 n
+0000046447 00000 n
+0000046661 00000 n
+0000046820 00000 n
+0000047275 00000 n
+0000047494 00000 n
+0000047654 00000 n
+0000048417 00000 n
+0000048636 00000 n
+0000048776 00000 n
+0000048992 00000 n
+0000049233 00000 n
+0000049387 00000 n
+0000049595 00000 n
+0000049806 00000 n
+0000049951 00000 n
+0000050172 00000 n
+0000050425 00000 n
+0000050576 00000 n
+0000050658 00000 n
+0000051261 00000 n
+0000055753 00000 n
+0000055834 00000 n
+0000056385 00000 n
+0000060130 00000 n
+0000060210 00000 n
+0000060931 00000 n
+0000067856 00000 n
+0000067938 00000 n
+0000068740 00000 n
+0000081937 00000 n
+0000082014 00000 n
+0000082454 00000 n
+0000083096 00000 n
+0000083175 00000 n
+0000083670 00000 n
+0000088648 00000 n
+0000110868 00000 n
+0000111275 00000 n
+0000111388 00000 n
+0000112461 00000 n
+trailer
+<</Size 441/Root 440 0 R/Info 438 0 R/ID[(lFJVixS5GtCfr2tu1oSzmQ==)(lFJVixS5GtCfr2tu1oSzmQ==)]>>
+startxref
+112648
+%%EOF \ No newline at end of file
diff --git a/docs/typ/cheatsheet-a4.typ b/docs/typ/cheatsheet-a4.typ
new file mode 100644
index 00000000..7694382f
--- /dev/null
+++ b/docs/typ/cheatsheet-a4.typ
@@ -0,0 +1,40 @@
+// The printable cheatsheet: one A4 side, three columns. The facts are in
+// cheatsheet.typ and the elements' look in style.typ; this is page,
+// type and headings only.
+// typst compile --ignore-system-fonts docs/typ/cheatsheet-a4.typ
+#import "style.typ": palette, mono, density, tagline
+
+#set page(paper: "a4", fill: palette.paper, margin: (x: 9mm, y: 8mm), columns: 3)
+#set columns(gutter: 4.5mm)
+#set text(font: "Libertinus Serif", size: 8.6pt, fill: palette.ink, lang: "en")
+#set par(leading: 0.42em, spacing: 0.55em, justify: false)
+#set list(indent: 0pt, body-indent: 3pt, spacing: 0.42em, marker: text(fill: palette.grip)[▸])
+#set terms(separator: h(0.5em), spacing: 0.42em, hanging-indent: 0.8em)
+#set table(stroke: none, inset: (x: 1.5pt, y: 1.6pt))
+#show raw: set text(font: mono, size: 0.92em)
+#show strong: set text(fill: palette.tag-name)
+
+// The title is the page's, not the content's: a level-1 heading in the
+// content is not drawn here.
+#show heading.where(level: 1): none
+#place(top + left, float: true, scope: "parent",
+ block(width: 100%, inset: (bottom: 2pt), stroke: (bottom: 0.6pt + palette.grip), {
+ text(size: 15pt, weight: "bold", fill: palette.tag-name)[pardes]
+ h(1fr)
+ text(size: 9pt, style: "italic", fill: palette.tag-fg, tagline)
+ }))
+#show heading.where(level: 2): it => block(
+ width: 100%, fill: palette.tag-bg, inset: (x: 2pt, y: 2pt), above: 0.75em, below: 0.4em,
+ sticky: true,
+ {
+ box(fill: palette.col-grip, width: 0.55em, height: 0.75em, baseline: 0.1em)
+ h(3pt)
+ text(size: 9pt, weight: "bold", fill: palette.tag-name, it.body)
+ },
+)
+
+#show heading.where(level: 3): it => block(above: 0.6em, below: 0.35em, sticky: true,
+ text(size: 8.4pt, weight: "bold", fill: palette.grip, it.body))
+
+#density.update("tight")
+#include "cheatsheet.typ"
diff --git a/docs/typ/cheatsheet.typ b/docs/typ/cheatsheet.typ
new file mode 100644
index 00000000..43162f52
--- /dev/null
+++ b/docs/typ/cheatsheet.typ
@@ -0,0 +1,159 @@
+// The pardes cheatsheet: the facts only, an index into the docs, not a copy.
+// cheatsheet-a4.typ lays it out; style.typ says how each element looks.
+// config.zig's "docs/typ" test checks every #word, #key and #tag here
+// against the registry, the keymap and the default tags.
+#import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs, fstree
+
+== The mouse
+#pairs(
+ btn("B1"), [select, and focus the pane. On a tag: type there.],
+ btn("B2"), [#word("Exec") the word or selection: a builtin, else a shell line.],
+ btn("B3"), [#word("Look"): open the file, address, directory or URL, else find the word's next place. Resting the pointer tints what #btn("B3") would take.],
+ [sweep], [drag #btn("B2") or #btn("B3") to #word("Exec") or #word("Look") exactly what you swept.],
+ [grip], [drag the box left of a tag: up/down resizes, onto another column moves the pane. A column's right edge drags its width.],
+)
+=== Chords: hold the first, click the next
+#pairs(
+ chord("B1", "B2"), [cut the #btn("B1") selection],
+ chord("B1", "B3"), [paste over it],
+ chord("B1", "B2", "B3"), [copy: cut, then paste back, #btn("B1") still down],
+ chord("B2", "B1"), [#word("Exec") the word with the #btn("B1") selection as argument (#word("Grep") on a selected name)],
+ chord("B2", "B3"), [cancel the sweep (#chord("B3", "B2") too)],
+)
+Over a program that takes the mouse, Shift swaps: #btn("B1", shift: true) selects, #btn("B2", shift: true) goes to the program.
+One button: Alt/Option-click is #btn("B2"), Cmd/Super-click #btn("B3"), sweeps too (a terminal passes only Alt); Ctrl-click is a definition; a program that takes the mouse gets the plain click.
+
+== Tags
+#tag("Newcol Joincol Find Grep Help Changelog Tutor Dump Themes Config Debug Exit")
+#tag("New Tty Find Grep Joincol Delcol")
+#tag("Save Tty Collapse Del", path: "/home/me/notes.txt")
+#tag("Tty+bash Save Mode Filter Collapse Del", path: "/home/me/src")
+#tag("Tty PdfSections PdfTint PdfFit Collapse Del", path: "manual.pdf [1/12]")
+- #word("Del") over unsaved text refuses once; again discards. #word("Del") `j`: rows below. #key("SPC d") between two panes takes #key("k") (rows above) or #key("j") (below), asking only if you pause.
+- #word("Undo") #word("Redo") #word("Edit") #word("Mode") work typed anywhere. #doc("tags")
+
+== #word("Look") addresses
+Typed anywhere, then #btn("B3") or #key("Enter"):
+#pairs(
+ addr("file:12"), [line 12],
+ addr("file:12:5"), [line 12, byte column 5],
+ addr("file:/re/"), [next match after the selection (`file:0/re/`: first)],
+ addr(":40"), [the pane looked from, line 40 (`:40:5`, any address after `:`)],
+ addr("~/x"), [home; also in #word("Save"), #word("Restore"), `pardes ~/x`],
+ addr("@p3:12"), [pane 3 by serial, a terminal's lines too],
+ addr("src/"), [a directory: a pane listing it; `Get` reads it again],
+)
+Addresses are sam's: `#n`, `/re/`, `?re?`, `$`, `a,b`. #doc("fs", section: "look-and-exec")
+
+== Keys: normal mode
+Helix-style: motions *select*, then an edit acts on the selection. Mode box: blank normal, `^` insert, `$` raw terminal. Every helix key: #link("https://docs.helix-editor.com/keymap.html")[its keymap].
+#pairs(
+ [#keys("h", "j", "k", "l") #keys("w", "b", "e")], [move; words select],
+ [#keys("g g", "g e")], [first line, last line],
+ [#keys("g h", "g l", "^")], [line start, end, first non-blank],
+ [#keys("x", "v", "%")], [line, character select, all],
+ [#key(";")], [collapse to the cursor],
+ [#keys("d", "c", "y")], [delete, change, yank],
+ [#keys("p", "P", "R")], [paste after, before, replace],
+ [#keys("u", "U")], [undo, redo],
+ [#keys("i", "a", "I", "A", "o", "O")], [insert; #key("Esc") back to normal],
+ [#keys("s", "S")], [regex: a cursor per match, split],
+ [#keys("C", ",")], [cursor on next line; keep primary],
+ [#keys("/", "n", "N")], [search (a query pane), next, previous],
+ [#keys("m i", "m m")], [textobject, matching bracket],
+ [#key("|")], [pipe each selection through the shell],
+ [#keys("g d", "g r")], [definition, references (language server)],
+ [#keys("Ctrl-d", "Ctrl-u")], [half page down, up],
+ [#keys("Enter", "Tab")], [#word("Look"), #word("Exec") the selection (like #btn("B3"), #btn("B2"))],
+ [#key(":")], [to the pane's tag and back],
+)
+#doc("keys")
+
+== Keys: panes
+#pairs(
+ [#key("Ctrl-w")], [window mode: #keys("h", "j", "k", "l") move the outline, #key("d") deletes it (then #key("k")/#key("j") between two), #key("c") collapses it, #key("Enter")/#key("Esc") or a pane's letter focuses (not in insert or raw `$`)],
+ [#key("Esc")], [back to the previous pane (insert: to normal)],
+ [#key("Shift-Esc")], [back to the previous pane from any mode but raw, where it is the program's Esc; needs the kitty keyboard protocol or the GUI, elsewhere a plain Esc],
+ [#keys("Ctrl-o", "Ctrl-i")], [jump history back, forward; this file first. #key("Ctrl-i") is #key("Tab") without the kitty protocol: #key("SPC j i")],
+ [#key("Alt-n")], [new terminal below],
+ [#key("Alt-c")], [move the pane to a new column],
+)
+
+== The leader: #key("SPC") in normal mode
+#pairs(split: 2,
+ key("SPC ?"), [#word("Help"): every builtin],
+ key("SPC f s"), word("Save"),
+ key("SPC f n"), word("New"),
+ key("SPC f f"), word("Find"),
+ key("SPC f g"), word("Grep"),
+ key("SPC f r"), word("Recent"),
+ key("SPC b b"), word("Panes"),
+ key("SPC s s"), [declarations],
+ key("SPC f c"), word("Config"),
+ key("SPC d"), word("Del"),
+ key("SPC n t"), word("Tty"),
+ key("SPC n 9"), word("Tty9p"),
+ key("SPC w"), word("Window"),
+ key("SPC j j"), word("Last"),
+ key("SPC j l"), word("Jumplist"),
+ key("SPC y"), [clip yank],
+ key("SPC p"), [clip paste],
+ key("SPC t t"), word("Themes"),
+ key("SPC t n"), word("NextColor"),
+ key("SPC t w"), word("Wrap"),
+ key("SPC c n"), word("Newcol"),
+ key("SPC c p"), word("Placement"),
+ key("SPC s d"), word("Dump"),
+ key("SPC s r"), word("Restore"),
+ key("SPC s a"), word("Attach"),
+ key("SPC s D"), word("Detach"),
+ key("SPC h t"), word("Tutor"),
+ key("SPC h m"), word("Messages"),
+ key("SPC q"), word("Exit"),
+)
+
+== Terminals and commands
+- #key("Ctrl-b"): raw (`$`) or normal. #word("Mode") cycles raw, normal, insert. #word("Filter"), #word("Tty+bash").
+- #btn("B2") on a non-builtin line runs it in a *command pane*: #tag("Kill Save Collapse Del", path: "/home/me/src (make) exit 0")
+- #word("Kill") `make` stops it; #word("Exit") quits. #word("Repl") `python`: `.py` clicks go to it.
+
+== Reviewing diffs
+`git diff` output is a diff: #btn("B3") on a file line, an `@@` or a line's `+`/`-` jumps there. #doc("tags", section: "reviewing-diffs")
+
+== Finding things
+- A query pane under the pane: line 1 the query, its first word the source: `/pat`, `Find name` (fuzzy), `Grep text` (literal), `Recent`, `Panes`, `Symbols`, `All`. #keys("Ctrl-n", "Ctrl-p") step, #key("Enter") lands and keeps the rows, #key("Esc") puts things back. #word("Help"), #word("Tutor").
+
+== Sessions
+`pardes --detach=work`; `--attach=work` or #word("Attach") `work`; #word("Detach") leaves it running. #doc("detached")
+
+== Config
+#word("Config") (#key("SPC f c")): `~/.config/pardes/init`, a builtin a line (#word("Theme") `atelier`). #word("DumpConfig"): every setting. #word("Dump") / #word("Restore"): the workspace. #doc("config")
+
+== Themes
+#word("Themes") lists them; #word("Theme") `name`; #word("NextColor"); #word("ThemeFile") `x.zon`. #doc("themes")
+
+== The virtual filesystem (9P)
+Pane shells get `$PARDES_9P` (the socket) and `$PARDES_PANE` (their own pane); a command clicked in a pane also gets `$winid`, the pane it was clicked in.
+#cmd("9ns --mntgen # then m=$PARDES_MOUNT in every pane")
+#cmd("9p -a \"unix!$PARDES_9P\" read index")
+#fstree(```
+index a line per pane @rules
+look write: a #word("Look") @look-and-exec
+exec write: an #word("Exec") @look-and-exec
+log events; follow waits @log
+pane/
+ new open: a new pane @panes
+ <n>/
+ addr where data reads, writes @addresses
+ ctl builtins: #word("Save"), #word("Edit") … @panes
+ body its text (>> appends) @panes
+ data the text at addr @addresses
+ look a #word("Look") here @look-and-exec
+ exec an #word("Exec") here @look-and-exec
+```)
+#cmd("echo notes.txt:12 > $m/pane/$n/look")
+#cmd("echo /foo/ > $m/pane/$n/addr; printf bar > $m/pane/$n/data")
+#cmd("echo 'Edit ,x/foo/c/bar/' > $m/pane/$n/ctl")
+#cmd("exec 3<>$m/log; echo follow >&3; cat <&3")
+`pardes FILE` opens it here; `EDITOR='pardes --wait'`. #doc("fs")
+
diff --git a/docs/typ/guide.typ b/docs/typ/guide.typ
new file mode 100644
index 00000000..58e5d907
--- /dev/null
+++ b/docs/typ/guide.typ
@@ -0,0 +1,383 @@
+// The guide: pardes day to day, the path a newcomer reads once. Edge cases
+// live in the reference, the pager and the language servers in setup, the
+// keys on the cheatsheet.
+#import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs, glossary, annotated, clip, mode-box
+
+#word("Look") (right-click) opens `src/bar.c:12`; #word("Exec") (middle-click) runs `make`.
+
+#annotated("/docs/site/media/themes/orchard.png", (640, 513),
+ alt: "a pardes window: workspace tag, column tag, a file pane, a terminal and a diff",
+ ([the workspace tag: words for the whole session], -22, 11),
+ ([a column's tag], 400, 34),
+ ([a pane's tag: its path, then its words], 560, 58),
+ ([the box: the pane's mode, and the handle to drag it], 8, 58),
+ ([the body: here a file, below it a terminal], 200, 104),
+ ([the scrollbar: how much of the body is in view], 8, 160),
+)
+
+#glossary("Words you'll see", <words>,
+ [the pane with the keyboard], [where your keys go; one pane at a time],
+ [the session's directory], [where pardes started, or the directory `pardes DIR` named; workspace and column tags run there],
+ [active column], [where the next new pane goes (below)],
+ [command pane], [a terminal that runs one command line and shows its output],
+ [`+` names], [panes pardes makes, named in their directory: `+New` a scratch (text with no file yet), `+Search` a query pane or a listing of places, `+Pager` paged text, `+Errors` output, `+Unsaved` the panes holding unsaved text],
+ [serial], [a pane's number, never reused: the `3` in `@p3:12` and in 9P paths],
+ [message row], [the line where pardes says what happened, and asks: answer a prompt (#key("s")'s regex, #word("Save")'s path) with #key("Enter"), cancel it with #key("Esc")],
+)
+
+= Modes <modes>
+
+Each pane keeps its own mode. The box left of its tag shows it.
+
+#pairs(
+ [#mode-box(" ") normal], [keys move and select; an edit acts on the selection. File and PDF panes start here, and so does a terminal from #key("Alt-n").],
+ [#mode-box("^") insert], [keys type. #keys("i", "a", "o") and the rest enter it.],
+ [#mode-box("$") raw, terminals only], [keys go to the program. A terminal from #word("Tty"), the shell a bare `pardes` starts with, and a command pane start here.],
+)
+
+#key("Ctrl-b") switches a terminal between raw and normal. In normal,
+its text is a page to move over and copy from. #word("Mode") in the tag
+steps raw, normal, insert.
+
+#pairs(
+ [#mode-box(" ") normal], [#key("Esc"): back to the previous pane (#word("Last")), unlike helix. #key("Shift-Esc"): the same.],
+ [#mode-box("^") insert], [#key("Esc"): back to normal. #key("Shift-Esc"): out of insert and back to the previous pane.],
+ [#mode-box("$") raw], [#key("Esc"): back to the previous pane. #key("Shift-Esc"): an Esc to the program. Either way the terminal stays raw. #word("ProgramEsc") `on` swaps them back: #key("Esc") goes to the program, except at a shell prompt with nothing typed on it, and #key("Shift-Esc") always goes back.],
+ [a PDF], [#key("Esc"): clears the selection and the search highlights. #key("Shift-Esc"): back to the previous pane.],
+)
+
+In acme, Esc selects the text typed since the last click; here it leaves
+insert mode, or goes back a pane.
+
+#key("Shift-Esc") needs the kitty keyboard protocol or the GUI. Elsewhere
+it is a plain Esc. The previous pane is the last one you jumped from, else
+the next pane down the column.
+
+#pairs(
+ [#key("Ctrl-w") or #key("SPC w")], [window mode (#word("Window")): each pane's tag box shows a letter instead of its mode, and the focused pane's tag is outlined; #keys("h", "j", "k", "l") move the outline, #key("Enter") or #key("Esc") gives that pane the keyboard, #key(":") its tag, a pane's letter gives it that one. #key("k") past a column's top pane goes on to its tag. #key("d") is #word("Del") on the outlined pane (between two panes it waits for #key("k") or #key("j"), as #key("SPC d") does) and the outline moves to the pane that took its rows; #key("c") is #word("Collapse"). The mode stays on for the next key],
+ [#keys("Ctrl-o", "Ctrl-i")], [back and forward through the places you jumped to (the jump list), this file's first: another file's only once it has none left that way (#word("JumpScope") `all`: every place in order). #key("Ctrl-i") needs the kitty keyboard protocol or the GUI, being #key("Tab") elsewhere: there use #key("SPC j i") and #key("SPC j o"), or the mouse's side buttons],
+)
+
+Raw mode sends almost every key to the program. Leave it (#key("Ctrl-b"))
+before #key("Ctrl-w") or #key("Alt-n").
+
+= The mouse <mouse>
+
+#pairs(
+ btn("B1"), [select; a click puts the cursor there and gives the pane the keyboard. In a tag it starts typing, in insert mode. A double click selects the word; at a line's start or end, the line; just inside a bracket or quote, up to its match.],
+ btn("B2"), [#word("Exec"): a builtin word runs, anything else is a shell line.],
+ btn("B3"), [#word("Look"): open the file, address, directory or URL, else find the word's next place.],
+ chord("B1", "B2"), [cut the selection],
+ chord("B1", "B3"), [paste over it],
+ chord("B1", "B2", "B3"), [copy],
+ [Alt-click (Option)], [#btn("B2"), sweeps too, for one button or a trackpad; in a terminal too],
+ [Super-click (Cmd)], [#btn("B3"); not in a terminal, which never passes Super],
+ [Ctrl-click], [the language server's definition],
+)
+#clip("chords")
+
+A program that takes the mouse gets the plain click.
+
+#btn("B3") on `src/bar.c:12:5:` in a compiler's error opens `src/bar.c` at
+line 12, column 5. A click takes the word under it: letters, digits and
+`. - + / : @ _ ~`, less a trailing `:`. Drag to take exactly what you
+swept. In normal mode #key("Enter") is #word("Look") and #key("Tab") is
+#word("Exec").
+
+A builtin's argument: sweep `Find conf` with #btn("B2"), or select `conf`,
+then #chord("B2", "B1") on `Find`.
+
+#key("x") #key("y") then #key("p") copies a line below. Every pane shares
+the registers. #key("SPC y") and #key("SPC p") use the system clipboard.
+
+= Tags <tags>
+
+#tag("Newcol Joincol Find Grep Help Changelog Tutor Dump Themes Config Debug Exit")
+#tag("New Tty Find Grep Joincol Delcol")
+#tag("Save Tty Collapse Del", path: "/home/me/notes.txt")
+
+A tag is text with undo. Type `make` into one and #word("Exec") it, or
+delete the words you never use. Any word runs from any tag: #word("Exit")
+in a pane's tag quits too.
+
+#pairs(
+ [#key(":")], [the keyboard to the tag, on #word("Save") the first time; #key("Tab") runs it, #key(":") comes back],
+ [edit the path, #key("Enter")], [renames: the next #word("Save") writes there; the typed path survives #key("Esc"), pending, and a second #key("Esc") drops it],
+ [#word("Collapse")], [folds the pane to its tag],
+ [drag the box], [up or down resizes; onto another column moves the pane],
+)
+
+= Where commands run and panes go <command-panes>
+
+#btn("B2") on `make` runs it with the #word("Shell") setting's `-c`.
+Where it runs depends on where you clicked:
+
+#clip("where-commands-run")
+
+#pairs(
+ [a terminal's text or tag, at a prompt with nothing typed], [typed into that shell, in its current directory],
+ [any other pane's text or tag], [a command pane in that pane's directory, in the last column],
+ [a column's tag], [a command pane in the session's directory, in that column],
+ [the workspace tag], [a command pane in the session's directory, in the last column],
+)
+
+A file's text and tag run in its directory: `make` from `README` at the
+project root is right, from `src/main.c` it is not. The keyboard stays
+where it was. The command pane's tag ends in `running`, then `exit N`:
+
+#tag("Kill Save Collapse Del", path: "/home/me/src (make) exit 0")
+
+Click into the command pane: #key("n") selects the next `file:line`,
+#key("Enter") opens it, and #key("n") from there goes on to the next error.
+A finished command pane is in normal mode, so #key("x") #key("y") copy from
+it at once. The next command for that directory reuses it.
+#word("Kill") `make` stops the commands pardes started with `make`.
+#word("Save") or #word("Del") in a column tag acts on that column's pane
+with the keyboard, else its first.
+
+Every other new pane goes into the *active column*: where you last typed
+or left-clicked, or where the last new pane went. The new pane takes the
+keyboard. A listing is the exception: it opens below the pane that asked,
+which keeps the keyboard, so #keys("n", "N") walk the listing. #btn("B3")
+on a file open in another column jumps there, but the next new pane still
+lands in the old column. #word("Placement") `pardes` picks other rules
+(#doc("reference", section: "placement")).
+
+To open beside: #word("Newcol"), then #word("Look") a file name typed in
+its tag opens it there; #key("Alt-c") moves a pane into a new column.
+#clip("columns", wide: true)
+
+Closing a column's last pane leaves it empty; #word("Delcol") and
+#word("Joincol") take columns away. Closing the session's last pane quits
+pardes.
+
+= Look <looking>
+
+#pairs(
+ addr("notes.txt"), [opens it, or goes to the pane already showing it],
+ addr("notes.txt:12"), [line 12],
+ addr("notes.txt:/TODO/"), [the next match of `TODO`],
+ addr("src/"), [a pane listing it, as acme's directory window: a #word("Look") at an entry opens it, `..` goes up, `Get` reads it again (#word("DirLook") `terminal`: `ls` in a terminal there)],
+ addr("https://ziglang.org"), [the browser, through `xdg-open` (`open` on macOS); there is no plumber],
+)
+
+#key("Enter") does the same from the keyboard; the other address forms are
+on the cheatsheet. A relative path is found in the directory of the pane
+the #word("Look") came from, then of each pane on the jump list, most
+recent first.
+
+= Search <search>
+
+#key("/") opens a query pane under the pane: a `+Search` whose first line
+is the query, typed into, and whose rows are what it finds, made again at
+each key. It takes its rows from the pane it searches and from no other,
+is born #word("SearchRows") rows tall and never resizes itself; nothing
+found is a count of `0` in its tag, not an exit.
+
+#pairs(
+ [#key("/") `vw`], [every match in the text tinted and ticked on its scroll rail, the first after the cursor selected; the rows under line 1 are the lines holding it, each its place as text first (`file:line:col`, the shortest path a #word("Look") from the pane resolves), then the line coloured as the file is, under the declaration it is in],
+ [#keys("Ctrl-n", "Ctrl-p")], [the next or previous match, typing; the text follows it],
+ [#key("Enter")], [the keyboard on the match, the pattern in `/`, the rows kept as text (#word("Save") keeps them as a file)],
+ [#keys("n", "N")], [the next or previous match in the text, round the end without a word],
+ [#key("Esc")], [typing: the text as it was, the query pane closed],
+ [#key("*")], [the selection as line 1, the keyboard staying in the text],
+)
+
+Line 1's first word names what it searches, and editing the word changes it:
+
+#pairs(
+ [`/pat`], [the pane's own text: a regex, any case unless it has a capital (#key("/"))],
+ [`Find name`], [the files below the pane's directory, by a fuzzy match of their names (#key("SPC f f"), #word("Find"))],
+ [`Grep text`], [the lines of those files holding `text`, literally (#key("SPC f g"), #word("Grep")); past 2000 lines #word("More") goes on],
+ [`Recent name`], [the files opened lately, in any window (#key("SPC f r"), #word("Recent"))],
+ [`Panes name`], [the open panes, then the ones closed this session, `(closed)` and dimmer: #key("Enter") (or a #word("Look") at its `@pN`) brings one back where it was, its text with it (#key("SPC b b"), #word("Panes"))],
+ [`Symbols name`], [the text's declarations (#key("SPC s s"))],
+ [`All pat`], [every open pane's text, its rows under each pane (#key("SPC /"))],
+ [`Refs`, `Def`, `Impl`, `Diagnostics`], [the language server's lists (#key("g r"), #key("g d"), #key("g i"), #key("SPC l d")): one answer is a jump, none a message; several open the list with the keyboard on its current row in normal mode (#keys("j", "k", "n", "N") step it, #key("Enter") lands, #key("Esc") goes back), the diagnostics' keeping it in the text for `]d`; their places in the text tinted as a `/`'s are],
+)
+
+A row in a file no pane shows is shown in a `+Preview` under the query
+pane. The current row follows the keyboard only (#keys("Ctrl-n", "Ctrl-p")
+typing, #keys("n", "N") and #keys("j", "k") in the pane's normal mode);
+#btn("B1") on the rows places the caret and selects, as in any pane, and
+moves nothing else. #key("Enter") lands the current row, making the
+preview that file's pane where it stands.
+The preview colours the file as its own pane does, and the query's hits
+in it are its places, tinted and ticked, the current one selected.
+#btn("B3") on a row's place goes there, as on any address; the rows kept
+as text (#word("Save")) are a list of places that still work.
+#btn("B2") on line 1 runs it again. The next search from the same pane reuses its query pane,
+its kept rows back on #key("Esc") (#word("SearchPane") `new`: a pane each;
+#word("SearchPlace") `column`: in a finder column at the right). A PDF's
+and a terminal's #key("/") still ask on the message row and list a
+`+Search`.
+#clip("search")
+
+= Unsaved panes <unsaved-panes>
+
+#word("Del") on a pane with unsaved text, its box filled
+(#mode-box(" ", unsaved: true); a `*` in a terminal), refuses once, saying `1 unsaved pane — Del again to discard`, and lists the pane
+in `+Unsaved`; #word("Del") again discards it.
+#word("Exit") (or #key("SPC q")), #word("Restore") and #word("Delcol")
+refuse once the same way. #key("SPC d") between two panes also asks which
+takes the rows: #key("k") above, #key("j") below. Typed straight on,
+#key("SPC d") then #key("j") just closes the pane; the question shows on its notice band
+only if no answer has come after a moment, a hint for a Del that seemed to
+do nothing.
+
+= Terminals <terminals>
+
+#tag("Tty+bash Save Mode Filter Collapse Del", path: "/home/me/src")
+
+- #word("Tty") opens a terminal in the pane's directory, #key("Alt-n") one in
+ the session's directory; #word("Tty+bash") picks the shell.
+- #word("Del") closes a terminal and its shell at once, running or not, and
+ a shell that exits closes its pane.
+- #word("Save") writes the scrollback to a path it asks for.
+- #word("Filter") maps the program's colours through the theme.
+- #word("Petscii") draws a program's images as glyph art instead of pixels.
+- In raw mode Ctrl-V types what you yanked, Ctrl-Shift-V the clipboard.
+- In normal mode, editing a terminal's text edits a copy, and the first
+ edit says so: #key("Tab") or #btn("B2") runs it, and the program's next
+ drawing replaces it.
+- A program that tracks the mouse gets #btn("B1") and the wheel;
+ #btn("B2") and #btn("B3") stay pardes's. Hold Shift to swap.
+- #word("Repl") `python` in its tag makes #btn("B2") on a `.py` pane send the text
+ to that REPL.
+- `git log` and `man` open in a `+Pager` pane (#doc("setup", section: "pager")).
+
+= Reviewing diffs <reviewing-diffs>
+
+`git diff` run as a command, or a `.diff` or `.patch` shown as text (below),
+is drawn as a diff, each hunk in its file's language. #btn("B3") on:
+
+#pairs(
+ [`diff --git`, `---`, `+++`], [the file],
+ [`@@ -3,7 +3,8 @@`], [the hunk's first new line],
+ [a line's `+`, `-` or space], [that line in the new file],
+)
+
+A `.diff` or `.patch` looked at, and a diff paged (`git show`), opens as
+a `+Diff`, stacked as delta shows one: each hunk under its `path:line`
+(`Space j n`/`Space j p` step through them, #btn("B3") opens it) and the declarations
+around it, a `+`/`-` before each line, the words a changed line changed
+tinted and a line added or removed whole faintly. A mailed patch keeps its
+message and diffstat above. The files are found from the diff's directory
+or one above it. #word("Diff") on a `+Diff` shows the diff itself as
+text (a paged one's `+Pager` is closed once stacked), and on the text stacks
+it again; #word("DiffLook") `text` in the startup file opens the text
+first.
+
+= Call hierarchy <callstack>
+
+Put the cursor on a function and run #word("Callstack") (#key("g c") or #key("SPC l b")).
+`+Callstack` starts at the outermost callers and follows calls down toward
+the selected function, with shared callers grouped and vertical guides
+joining the levels with rounded corners. Each caller has a clickable location and its function
+signature, extracted by the same tree-sitter context mechanism as other
+location results. Signatures and call-site snippets use source syntax colors;
+only calls to the selected function receive background emphasis. Guides
+continue alongside every line of a multiline signature and through screen
+wrapping. Cross-directory Look paths are shortened when possible.
+#btn("B3") or #key("Enter") on a location opens and reveals that source
+pane. #word("LookNext") / #word("LookPrev") (#keys("SPC j n", "SPC j p"))
+select locations without opening them. The view follows the language
+server's static call hierarchy; recursive paths are marked `↻`, and a
+hierarchy deeper than the limit invites continuing from another function.
+Every caller is listed: the walk runs as long as the server keeps answering,
+says how many callers it has found on the message row once it takes more
+than a second, and shows what it found if the server stops answering.
+Asking anything else stops it. A tree too big for one page (about 100,000
+rows, the memory one query may use) ends in a row saying so: running
+#word("Callstack") in `+Callstack` shows the next page, from where this
+one stopped, with that caller's own callers above it again.
+At each level, callers whose function or file name contains "test" come
+after the rest.
+#word("CallstackDepth") reports the current caller depth;
+`CallstackDepth 16` changes it for subsequent queries. The default is 8
+levels, and the accepted range is 1–64.
+
+`CallstackLayout stacked` (the default) puts each signature and call snippet below its
+location, aligned with the location text; `CallstackLayout inline` puts it
+beside the location again. A bare #word("CallstackLayout") switches modes.
+`CallstackCorners rounded` (the default) uses rounded tree guides;
+`CallstackCorners square` restores sharp corners. Bare #word("CallstackCorners")
+switches styles. Layout and corner changes apply to the next query. These settings are retained
+by #word("Dump") / #word("Restore").
+
+= `pardes FILE` and `--wait` <editor>
+
+In a pane's shell:
+
+```
+pardes notes.txt open it here and return at once (acme's B)
+pardes --wait notes.txt return when that pane closes (acme's E)
+```
+
+A file not there yet opens empty, and #word("Save") creates it.
+`--wait` makes pardes an `EDITOR` (#doc("setup", section: "editor-setup"));
+refusals and `--nested` are in the reference.
+
+= Keys <keys>
+
+#pairs(
+ [#key("w") #key("d")], [select a word, delete it: motions select, edits act on the selection],
+ [#key("x"), #key("v"), #key(";")], [select the line; extend; collapse to the cursor],
+ [#key("s")], [a cursor per regex match; every edit acts at each],
+ [#key("/"), #keys("n", "N")], [search the text in a query pane (#link(<search>)[Search]); step its matches, round the ends],
+ [#keys("SPC j n", "SPC j p")], [#word("LookNext") / #word("LookPrev"): select locations across panes; #key("Enter") opens one],
+ [#key("g l")], [line end],
+ [`12G`], [line 12; a bare #key("G") does nothing],
+ [#key("SPC ?")], [#word("Help"): every builtin, with its leader path and keys; `SPC w ?` only the paths under `SPC w`; #word("Tutor") (#key("SPC h t")) practises them],
+ [#keys("g d", "g r"), `SPC l`], [the language keys, once a server is installed (#doc("setup", section: "language-servers"))],
+)
+
+The keys are helix's, and helix's
+#link("https://docs.helix-editor.com/keymap.html")[keymap] is their full
+reference. Where pardes differs (#key("Esc") leaving the pane, the
+#key("SPC") paths, #key("Ctrl-w"), #key("Ctrl-b")), this guide and the
+cheatsheet (#doc("cheatsheet")) say so.
+
+= Sessions <sessions>
+
+```
+pardes --detach=work & a session with no screen of its own
+pardes --attach=work show it here
+```
+
+The session owns the panes, shells and files; frontends come and go, and
+all of them see the same screen. #word("Attach") `work` (#key("SPC s a"))
+switches this window to it; #word("Detach") (#key("SPC s D")) leaves it
+running.
+
+= Config <config>
+
+#word("Config") (#key("SPC f c")) opens the startup file,
+`~/.config/pardes/init`: one builtin a line, run at start, `#` a comment.
+
+```
+Theme atelier
+Shell zsh
+# Placement acme is the default; Placement pardes picks the other rules
+```
+
+#word("DumpConfig") opens every live setting as the line that sets it.
+#word("Dump") saves the workspace and #word("Restore") brings it back
+(what a dump keeps is in the reference). Keys are compile-time, in
+`src/config.zig`.
+
+= Questions <questions>
+
+/ Why not helix and tmux, or acme?: helix and tmux edit and run shells
+ well, but their text is inert. acme makes text the interface and is
+ modeless by design, with win for shells and page and the plumber for
+ documents. pardes keeps acme's text as the interface and trades the rest
+ for helix's modal keys, a VT terminal and PDFs in a pane. What changes
+ for acme users and scripts is in #doc("reference", section: "from-acme").
+/ Does it run inside tmux?: Yes, as in any terminal. Where tmux does not
+ pass kitty's protocols, #key("Shift-Esc") is a plain Esc and images draw
+ as glyph art.
+/ Does my helix config carry over?: No. The keys are compiled in
+ (`src/config.zig`); `~/.config/helix` is not read.
+/ How do I quit?: #key("SPC q"), or #word("Exit") in any tag.
+/ What does "pardes" mean?: The name of the four levels of reading a text in rabbinical exegesis (#link("https://en.wikipedia.org/wiki/Pardes_(exegesis)")[Wikipedia]).
diff --git a/docs/typ/install.typ b/docs/typ/install.typ
new file mode 100644
index 00000000..d97d30f7
--- /dev/null
+++ b/docs/typ/install.typ
@@ -0,0 +1,25 @@
+// Installing pardes: the downloads, else the clone and the build, included
+// by setup.typ and by the site's landing page, so it is written once. The
+// downloads and the mirrors come from `project` in style.typ.
+#import "style.typ": cmd, project
+
+#if project.download != none {
+ let d = project.download
+ for f in d.files {
+ let name = f.url.split("/").last()
+ [pardes #d.version, #f.what (#str(calc.round(f.bytes / 1000000)) MB):]
+ cmd("curl -LO " + f.url + "\necho '" + f.sha256 + " " + name + "' | sha256sum -c\nchmod +x " + name + " && mv " + name + " ~/.local/bin/" + f.program)
+ }
+ [The checksums are also in #link(d.sums)[`SHA256SUMS`].]
+ parbreak()
+ [Or build it from source:]
+}
+
+#let first = project.mirrors.first()
+#cmd("git clone " + first.clone + " && cd pardes")
+
+With Zig 0.17 (the build fetches everything else; once that is
+downloaded, a first build from a clean cache took 62 seconds on 16 cores):
+#cmd("# pardes, in a terminal\nzig build -Dplatform=tty --prefix ~/.local")
+#cmd("# pardes-gui, its own window\nzig build -Dplatform=gui --prefix ~/.local")
+Then run `pardes` or `pardes FILE`.
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
new file mode 100644
index 00000000..b83b4a83
--- /dev/null
+++ b/docs/typ/reference.typ
@@ -0,0 +1,1146 @@
+// The reference: every file the virtual filesystem serves over 9P, what it
+// does, how it fails, and the limits. How pardes behaves on screen is the
+// guide's; recipes and traps are scripting's; how a mount cuts writes and
+// the listeners are building's.
+#import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs, fstree
+
+Every native session is a virtual filesystem, served as 9P2000 (not .u,
+not .L) and modelled on acme's (#doc("reference", section: "from-acme")):
+panes, columns, tags and the session are files. Paths here are the served ones (#file("/pane/2/body")); through a
+mount they sit under the session's directory (`$m`; #doc("scripting", section: "find-the-session")
+says how to find it). The served #file("/README") is a
+one-screen summary of this page. Two builtins: #word("Look") (right-click): open what the
+text names, or else find it; #word("Exec") (middle-click): run the builtin
+it names, or else run it as a shell line. The files #file("look") and
+#file("exec") take a line each, as those clicks would.
+
+= The tree <tree>
+
+#fstree(```
+README the one-screen summary (src/fs-help.txt) @other-files
+index a line per pane: serial kind dirty name column @rules
+status pid, version, panes @other-files
+look write a line: a #word("Look") at the pane with the keyboard; read: the serials touched @look-and-exec
+exec write a line: an #word("Exec") there; read: the serials touched @look-and-exec
+pager write a directory: a new +Pager there; read: its serial @pardes-stdin
+log the event log; write follow to wait for more @log
+screen the rendered screen as JSON @on-screen
+listeners dial addresses @other-files
+focus the serial of the pane with the keyboard; write one to move it @columns-and-tags
+ctl settings and session builtins @root-ctl
+commands every builtin, one a line @other-files
+recent files opened lately: open|closed <path> @other-files
+layout a line per column, then active <serial> @columns-and-tags
+tag the workspace tag @columns-and-tags
+tagexec a word clicked in the workspace tag @columns-and-tags
+col/ the columns @columns-and-tags
+ <n>/ column <n>; rmdir closes it when empty @columns-and-tags
+ tag its tag
+ ctl its builtins (Delcol Joincol New Tty)
+ exec a word clicked in its tag
+pane/ the panes @panes
+ new open it to make a pane; read answers the serial @panes
+ <n>/ pane <n>; rmdir closes it @panes
+ name the file name; write to rename @panes
+ body the text; a write appends, > replaces @panes
+ tag its path, then its words; a write replaces the words @panes
+ ctl builtins and ctl words, a line each @panes
+ addr the address data and xdata work on @addresses
+ dot the selection, as an address @addresses
+ limit where a forward search stops @addresses
+ data the text at addr; a write replaces it @addresses
+ xdata the text in addr's range only @addresses
+ sel the selected text; a write replaces it @panes
+ dirty 1 while the text differs from its file @flags
+ mark 0 or 1; a write marks an undo point @flags
+ scroll 0 or 1; a write scrolls the pane @flags
+ errors write-only: text for the directory's +Errors @panes
+ event the pane's clicks and keys, as acme's event file @event
+ look a #word("Look") at this pane @look-and-exec
+ exec an #word("Exec") at this pane @look-and-exec
+ tagexec a word clicked in this pane's tag @look-and-exec
+ pty/ terminals only @pty
+ ctl winsize, sig, exec @pty
+ status cols rows busy @pty
+ data the live stream: bytes in as typed, output out @pty
+ run write a command line; read: exit N, then its output @pty
+os/ the host filesystem @mounts
+src/ the editor's sources (only with -Dembed-sources=true) @mounts
+```)
+
+Panes and columns are named by serials the editor gives: stable while they
+live, never reused (so they can have gaps). Nothing is created by a listing, stat, walk or read:
+only an open of #file("/pane/new") makes a pane (so `ls -l` and `find` are
+safe), only `rmdir` of #file("/pane/<n>") or an empty #file("/col/<n>")
+removes. Tcreate is refused everywhere.
+
+#file("/index") rows are `serial kind dirty name column`, kind `text`,
+`term` (a shell), `cmd` (a command's pane, no shell to type into), `pdf` or
+`image`, the name `<dir>/+New` for an unnamed scratch.
+Names may hold blanks, so split `head, col = row.rsplit(maxsplit=1)`, then
+`serial, kind, dirty, name = head.split(maxsplit=3)`. Names in
+#file("/index"), the log and a terminal's tag are escaped: a newline `\n`, a
+backslash `\\`, and any other control byte, DEL, a C1 control or a byte that
+is not UTF-8 `\xNN`, so a name decodes to the bytes it is.
+
+= Rules for every file <rules>
+
+*Failure.* A write fails whenever what it asked for fails, and logs one
+`err <serial|-> <file>: <why>` record, with no `msg`; a write that succeeds
+logs none. A refused write says why in the log's last `err` record, found
+with `grep '^err' log | tail -1`: after a refused #word("Del"), #word("Exit") or #word("Restore") the
+newest line may be `new N .../+Unsaved`. Only writes log: a
+refused open or truncation (an OTRUNC open such as `> data` after a failed
+`addr`), create or remove answers its error alone, as do a write to
+#file("pane/new") (`permission denied`) and a write on a read-only fid
+(`bad use of fid`). Errors are words (Plan 9's where pardes has none of its
+own), never a C library string; a bad setting value is quoted, the value
+itself (`bad value in control message; takes on, off "maybe"`); a ctl
+refusal quotes the offending word alone (`wrong #args in control message "Newcol"`). Through 9ns the kernel sees an errno 9ns reads
+from those words (cloud9's `fs.enameErrno`): the first of these that the
+words hold, case aside, wins, and anything else is EIO (`Modified`, a
+sam command pardes's #word("Edit") leaves out, `B <cmd`):
+
+#pairs(
+ [`control message`], [EINVAL],
+ [`interrupt`], [EINTR],
+ [`shut down`], [EIO],
+ [`not exist`, `not found`, `no such`], [ENOENT],
+ [`exists`], [EEXIST],
+ [`not empty`], [ENOTEMPTY],
+ [`not a dir`], [ENOTDIR],
+ [`is a dir`], [EISDIR],
+ [`permission`, `denied`], [EACCES],
+ [`read-only`, `read only`, `readonly`], [EROFS],
+ [`no space`], [ENOSPC],
+ [`not allowed`, `not permitted`, `cannot`], [EPERM],
+ [`fid`], [EBADF],
+ [`bad offset`, `invalid`, `bad `], [EINVAL],
+ [`busy`, `in use`], [EBUSY],
+ [`too long`], [ENAMETOOLONG],
+ [`too many open files`], [EMFILE],
+ [`not supported`, `unsupported`], [EOPNOTSUPP],
+ [acme's address and argument words: `no match for regexp`, `no previous regular expression`, `address out of range`, `addresses out of order`, `past end of body`, `written to addr failed`, `not locked by this open`, `too small for the panes`, `owns the size`, `no question asked`, `answer takes`], [EINVAL],
+)
+
+A file pardes reads (#word("Get"), #word("Look"), #word("Edit")'s `e` and `r`) that is a directory where a file is wanted says `is a directory` (EISDIR), an unreadable one `permission denied` (EACCES), and a device (`/dev/zero`, a tty) `not a regular file` (EIO), never read to the stream limit; #word("Incl") of a file says `not a directory` (ENOTDIR).
+
+The `err` record has the words; a shell sees only the errno.
+
+Not failures: a #word("Look") that finds nothing (it answers nothing and logs one
+`err`), an #word("Edit") `x` that matches nothing, #word("Undo") with nothing to
+undo (a `msg`), and a command pane's command, which ends in its own time
+with an `exit` record.
+
+*Command lines.* #file("look"), #file("exec"), #file("tagexec"), the three
+kinds of #file("ctl") and a column's #file("exec") take one command a line.
+The whole write is checked first (a control character other than a tab
+fails it all, EINVAL); then lines run in order, and a failing line fails
+the write after the lines before it took effect, as acme's ctl does. Blank
+lines are skipped. A line runs at its newline; the last one, unended, runs
+after its open is closed, the close answered first, so its failure is only
+its `err` in the log: end a write with a newline when its result matters
+(#doc("building", section: "writes-through-a-mount")). `> exec` (a
+truncating open) is fine through a mount. An #word("Edit") whose `{` or `a`/`c`/`i` text is still
+open waits for the next write on that open. A line or #word("Edit") block over
+1 MiB is refused once (EINVAL), and the rest of it, through its newline,
+is dropped.
+
+*Answers.* Reading #file("look"), #file("exec") or #file("tagexec") answers
+the serials the last command made, or else the pane it acted on or
+focused, one a line; nothing when it did none of these (#word("Newcol") at
+#file("/tagexec")). A read answers the panes touched by this open's last
+write. An open that never wrote reads the session's last answer, from
+whichever client wrote it, so read on the open you wrote. A read is a stream: once read,
+the next read on that fid is EOF until the next write (or seek to 0). With
+other clients about, write and read on one open:
+#cmd("exec 3<>$m/pane/$n/look; echo x >&3; cat <&3; exec 3<&-")
+
+*Snapshots.* #file("/index"), #file("/layout"), #file("/recent"),
+#file("/commands"), #file("/status"), #file("/listeners"), a read-only
+#file("ctl"), #file("/log"), #file("/screen") and a terminal's
+#file("body") freeze at the open, so one read in several chunks never
+splices two moments; open again for now.
+
+*Open records.* A session holds 64 open records, shared by every client.
+An open that keeps state takes one: such a snapshot, a #file("run"),
+#file("event") or #file("pty/data") open, a write open of #file("data"),
+#file("xdata"), #file("sel") or a text pane's #file("body"), and every
+write open of a command file (#file("look"), #file("exec"),
+#file("tagexec"), a #file("ctl")). A plain read of a pane's text takes
+none. Past 64 an open is refused `too many open files`, which a mount
+reports as EMFILE. Close what you open: a shell's `exec 3>$m/exec` holds
+its record until fd 3 is closed.
+
+*Held reads.* A read with nothing to give yet (a followed #file("log"),
+#file("event"), #file("pty/data"), #file("pty/run") before its answer)
+waits in the editor and is answered when news comes. A second read on that
+open meanwhile fails `file in use`. A read the client flushed is dropped.
+One connection holds at most 128 reads at once; the next is refused `too many reads waiting: 128`. Every held read is on an open that keeps state,
+and those are 64 in the session (above), so 64 is the real cap on reads
+held at once, through one connection or many. A mount (9ns) is one
+connection, and it keeps answering everything else beside its held reads.
+
+*Stats.* A file whose text is kept has its real length: a pane's
+#file("body"), #file("tag"), #file("name"), #file("ctl"), #file("sel") and
+the range and flag files, the workspace's #file("tag"), the root
+#file("ctl"), #file("status"), #file("commands"), #file("README"), the
+#file("look")/#file("exec") answers, #file("focus"); #file("event") and
+#file("pty/data") the next record's, zero when none waits. A stream and a
+view generated by each read stat 0, as acme's do: #file("log"), #file("screen"), #file("data"), #file("xdata"), #file("index"),
+#file("layout"), #file("recent"), #file("listeners"), #file("pane/new").
+Read those to the end rather than trust a length (`cat` does). The qid
+version of #file("body"), #file("data") and #file("xdata") is the pane's
+revision, so a stat sees an edit land. Modes are 0644/0666, 0444
+read-only, 0222 write-only.
+
+= look and exec <look-and-exec>
+
+A line written to #file("look") is #word("Look") on it, on the line as
+written: its leading blanks are its own (` return x` finds that
+indented line, and a diff's blank context line ` ` is a #word("Look") too); only its
+newline and `\r` go. An #file("exec") line's blanks at either end are
+trimmed. The guide says what #word("Look") opens and where it finds a relative path (#doc("tags", section: "looking")); here is what is particular to the
+files.
+
+- `file:12` selects line 12, newline included; `file:12:5` puts the caret
+ at line 12, byte column 5; `file:<addr>` takes any address (below),
+ *evaluated from the file's dot*: `file:/re/` finds the next match after
+ the selection, `file:0/re/` the first. A bare `:N` or `:N:M` (or any `:addr`) addresses the pane the #word("Look") came from.
+ `@p<serial>:<addr>` addresses a pane by serial, a terminal's logical
+ lines too.
+- A leading `~` is the home directory (`$HOME`, else the passwd entry's;
+ `~user` that user's) here and wherever a path is typed (#file("name"),
+ #word("Save"), #word("ThemeFile"), #word("DumpDir"), #word("Restore"),
+ `pardes '~/x'`), even beside a file named `~`: write `./~` for that.
+- A path to no file is a miss, as a search that finds nothing is: said on
+ the message row and logged as an `err`, the write still answered. A file
+ that is there but will not open fails the write and is named:
+ `look: <path>: permission denied`. A zero column is refused, `file:0:0`
+ included: columns count from 1.
+- A whole line of a diff pane written to #file("look") is the #word("Look") on its first column. The line is matched in the
+ pane from its cursor row on, wrapping, and the first match wins.
+- On a PDF pane `:P:H` is hit H of the pane's search on page P, as
+ `file.pdf:P:H` is; a hit not there, or any H with no search active, is a
+ miss, `has no search hit H on page P`. Only a `+PdfSections` row's
+ second number is a section,
+ `file.pdf:PAGE:SECTION`, and only such rows are checked against the
+ outline: a section not there, or not on that page, is a miss.
+- A plain word selects its next place after dot, wrapping. #word("LookWord") `list`
+ on the root ctl lists a row per line holding it in a `+Search` pane
+ instead; the next word given to #word("Look") in that directory refills it. In a
+ terminal a word is always listed, rows spelled `@p3:12:5-9`.
+
+A miss logs `err <serial> look: ...` (`no match for "zzq:#3"` quoting what
+was written when nothing by that name exists; `<path>:99 has no line 99`
+for a line past a file's end, `<path> has no page 99` for a PDF's page;
+`<path>: no match for regexp` or `<path>: address out of range` when an
+address fails), opens nothing, and leaves #file("look") reading empty; the
+write succeeds. A `./x` or `../x` that is not there is such a miss too
+(`look: ./x: no such file`). A #word("Look") whose address fails says so and leaves open no file
+it opened. A #word("Look") of `file:12:` reads as `file:12`: a trailing colon is
+dropped, as a click leaves it off. A path too long to repeat whole gives up
+its middle to `…`.
+
+A line written to #file("exec") is #word("Exec"):
+
+- A builtin word runs (#file("/commands") lists them). A builtin that needs
+ its argument (#word("Msg"), #word("Mount"), #word("Find")) written bare is
+ `wrong #args in control message "Msg"`, and so is one that takes none
+ written with one (#word("Config") `extra`).
+- A line starting with `#` is a comment, as in a shell: it runs as nothing,
+ silently, here and in every ctl.
+- The language server's words ask about a file pane's text at its cursor
+ (set it with #file("addr") and `dot=addr` first): #word("Hover") fills
+ `+Hover`; #word("Def") and #word("Refs"), in the tag of a file a server
+ speaks for, are `gd` and `gr`, and given a symbol (a 2-1 chord's
+ selection) ask at its occurrence nearest the cursor; #word("Rename") `new` renames the symbol in the file and says how many
+ ranges it changed (on the message row, and so in the log) without listing
+ them, and fails when there is nothing to rename. One that reaches other
+ files applies nothing: it opens a `+Search` preview of the edits, which
+ is the pane the write answers, and says how many it lists. So does one
+ the server answers in this file alone while another open file of its
+ language still holds the old name, a row per such file (zls renaming at
+ a declaration; from a use it reaches every file);
+ #word("Callstack") (#key("g c") or #key("SPC l b")) opens and focuses `+Callstack`,
+ with static caller ancestry, tree-sitter signatures and Look locations
+ for callers and call sites, test callers after the rest at each level; run
+ in `+Callstack` itself, it shows the next page of a tree too big for one.
+ #word("CallstackDepth") reports or sets the
+ runtime depth (1–64, default 8) for subsequent queries.
+ `CallstackLayout stacked` (the default) aligns snippets below their locations;
+ `CallstackLayout inline` places the snippets beside them.
+ `CallstackCorners rounded` (the default) or `CallstackCorners square`
+ selects the tree corner style for the next query; bare, it switches styles.
+ #word("Callers") and #word("Callees") keep their short
+ lists and single-result jumps.
+ #word("Diagnostics") and #word("Symbols") list the file's in `+Search`;
+ #word("Lspinfo") fills `+Lsp`, the pane its write answers, with which
+ server serves the file and its state (`not started yet` until its first
+ query starts it, `<server> failed recently; retry in Ns` while it backs
+ off);
+ #word("Lspwhy") narrates the last query step by step (in `+Lsp`). The
+ write returns once the answer is in; a pane with no file is refused.
+- acme's words run as pardes's where it has one (`Put` is #word("Save"),
+ `Load` is #word("Restore"), `Delete` a #word("Del") that does not ask);
+ `Get`, `Putall`, `Zerox`, `Tab` and `Incl` are builtins of their own; the
+ rest (`Snarf`, `Cut`, `Paste`, `Sort`, `ID`, `Send`, `Indent`, `Local`,
+ `Abort`) are refused, `invalid: acme's Snarf is not a pardes builtin: ...`,
+ never run as commands. So is a GUI-only builtin (#word("Fonts")) on
+ another frontend.
+- Anything else is a command line (a typo ends `exit 127`), at most 1024 bytes, run as the guide
+ says (#doc("tags", section: "command-panes")): typed into a terminal idle
+ at an empty prompt, else run in a command pane. #file("exec") reads back
+ the command pane's serial, and while that open stays open the pane is its
+own: another client's command in the same directory gets a pane of its
+own. The log says `run <serial> <line>` and `exit <serial> <N|?>`. A
+reused pane's #file("body") keeps every earlier run
+ above a `% <line>` row naming each command, so to take only the last
+ run's output read from after the last `% ` row, leaving out its `exit N`:
+ #cmd("awk '/^% /{out=\"\"; next} /^exit [0-9?]+/{next} {out = out $0 \"\\n\"} END {printf \"%s\", out}' body")
+ From a pane whose directory is gone nothing runs: `exec: <dir>: no such directory` (ENOENT).
+
+The root's #file("look") and #file("exec") act at the pane with the keyboard and log as
+that pane's (with no pane at all, in the session's directory: a #word("Look") opens its file, making a column as #word("New") does, and an exec runs its
+command there); #file("/pane/<n>/look") and #file("exec") at pane n;
+#file("/tagexec") and #file("/col/<n>/exec") click in the workspace's or
+that column's tag, run commands in the session's directory, and log as
+`-`. A pane's word (#word("Undo"), #word("Msg"), #word("Save")) is refused
+at #file("/tagexec") and a column's exec: `not a session control message "Undo": write it to pane/<n>/ctl`.
+
+A background job (`&`) outlives a command that exits on its own; its
+output goes on below `exit N` until it lets go of the pty. #word("Kill")
+(root ctl) stops the commands pardes started: bare, all; #word("Kill") `make ls`,
+those whose line starts with one of the words. For a command pane it
+signals the whole line, `&` jobs included; for a line typed into a shell
+only the foreground job (SIGTERM), and the shell decides the rest. With
+nothing running, named or not, it says `Kill: nothing running` and the
+write succeeds; words that name none of what runs fail it (`Kill: no running command has that first word`). #word("Kill") does not reach a
+REPL's code: use `sig INT` on its #file("pty/ctl").
+
+== Paths and mounts <mounts>
+
+#word("Look") resolves the OS filesystem first, then the editor's own tree.
+Explicit paths skip that search:
+
+#pairs(
+ [`/n/os/proc/self`], [the host filesystem, served as #file("/os/proc/self")],
+ [`/n/self/pane/2/body`, `/virtual/pane/2/body`], [this session's tree, #file("/pane/2/body")],
+ [`/virtual/src/pardes.zig`], [sources embedded with `-Dembed-sources=true`, #file("/src/pardes.zig")],
+ [`/n/peer/pane/2/body`], [a mounted session: the peer's #file("/pane/2/body")],
+)
+
+`--mount=peer=work` or #word("Mount") `peer <dial>` mounts a dial: `unix!/path`,
+`/path`, `tcp!<numeric-ip>!<port>`, a session name, or with `-Dquic`
+`quic!…`; a missing socket is ENOENT, `no such socket`;
+#word("Unmount") `peer` removes it. #word("Mount") dials at once and fails if
+nothing answers (`dial failed: no answer`, `timed out`, `hung up`); with no
+dial it is `wrong #args`, and any other `x!y` `bad dial address`, both
+EINVAL. There are eight named mounts; `os` and `self` are reserved.
+#word("Unmount") refuses a mount a pane, a working directory or a pending
+#word("Save") still uses. Mounts are dumped.
+
+A session may open its own tree through a mount (a #word("Look") of `$m/pane/2/body`
+from the editor serving `$m`): requests are answered on the connection's
+task while the editor waits in its syscall. Through QUIC that still hangs.
+
+= The root ctl <root-ctl>
+
+Reading #file("/ctl") gives every setting, one a line, in the words a write
+takes (#word("Theme") `orchard`, #word("Verbose") `on`, #word("Placement") `acme`, #word("DumpDir") `<dir>`,
+#word("Shell") `/bin/bash`, ...), so writing back what it reads changes nothing.
+Writes take settings and session builtins (`scope = .session` in
+`src/builtins.zig`), acting at the pane with the keyboard:
+
+- A setting written bare steps to its next value (a switch flips; so do
+ #word("Placement"), #word("BootShell"), #word("Crt")). A value it does not
+ take is `bad value in control message; ...` naming what it takes;
+ #file("/commands") lists them. A setting the frontend cannot show is
+ refused (`Lift is GUI-only, invalid here`).
+- #word("Newcol") makes an empty column right of the keyboard's, halving
+ it. #word("Joincol") folds the keyboard's column into the one on its
+ right (its panes go below that column's), `Joincol: no column to the right`.
+- #word("Exit") quits. While panes hold unsaved text it refuses once
+ (#doc("tags", section: "unsaved-panes")): one `unsaved <serial> <name>`
+ record per pane, then the write fails `<name>: Modified (Exit again to discard)` or `4 unsaved panes: Modified (Exit again to discard)` (EIO),
+ and the list stays in a `+Unsaved` pane (in the directory of the pane with the keyboard,
+ or the session's when that directory is not on disk). #word("Restore"), #word("Del"),
+ #word("Delcol") and a pane's `get` refuse the same way with their own
+ word, except that #word("Delcol") opens no `+Unsaved` pane: it names the
+ panes only in its `unsaved` records and its notice.
+- #word("Dump") writes `pardes-<date>-<time>.zon` (UTC) in #word("DumpDir"),
+ logs `dump <path>`, and adds a #word("Restore") `<path>` word naming it to the
+ workspace tag (the last dump's, replacing an earlier one's).
+ #word("Restore") `[path]` replaces every pane (bare: the last dump this session
+ wrote). The #word("Restore") write is answered, then *every connection is hung
+ up*: dial again, and restart a 9ns mount. The new log has a `new` per
+ pane, `restore <path>`, then `restored <old> <new>` per pane and
+ `restoredcol <old> <new>` per column. A dump keeps an unsaved pane's
+ text and the hash of the file it was read against; a clean file pane's
+ text is read from disk at #word("Restore"), so a file changed since comes back as
+ it is now. An unsaved one whose file changed comes back with its own
+ text, marked changed on disk, and its first #word("Save") asks before
+ overwriting. A PDF's fit and tint are kept too. A #word("Restore") that fails says why in
+ the parser's words, a ZON error with its line (`line 3: expected ','`),
+ so the errno a mount gives depends on them (usually EIO): read the `err`
+ record for why. A #word("ThemeFile") the dump names that fails to load changes
+ nothing.
+- #word("Kill") `[word...]` (above), #word("Mount") `name dial`, #word("Unmount") `name`, #word("Theme") `x`.
+- `size C R` sizes a `--detach` session no frontend is attached to (160x50
+ until then): from 20x6 to 4096x4096, else `invalid size`; refused while a
+ frontend owns the size, and when a column would lose its panes' minimum
+ rows (`size: too small for the panes, each its tag and 2 rows`). A bad
+ `size` is refused quoting the value it got (`"5 2"`).
+
+A word that takes its argument after a `+` (#word("Tty+bash")) works on a ctl as
+in a tag. A write is refused whole, before anything runs, in Plan 9's
+words:
+`unknown control message "X"`, `wrong #args in control message "X"`, `bad value in control message ...`, or a word of the other ctl: `not a session control message "Undo": write it to pane/<n>/ctl`, `... "Delcol": write it to col/<serial>/ctl`, `not a window control message "X": write it to /ctl`. A builtin that would open a prompt (#word("Save") on a scratch)
+fails `control message needs its argument "Save"`. A line that fails as it
+runs fails with the editor's words (`Mount: already mounted`, `Save /root/x: access denied`), changing nothing.
+
+== Settings <settings>
+
+A setting that chooses among words (`on`/`off` switches,
+#word("Placement"), #word("BootShell"), #word("Crt"), #word("Bloom"),
+#word("Vignette"), #word("Grain"), #word("Lift"), #word("Motion"),
+#word("ShaderAnimation")) steps to its next value when given bare, as its
+word clicked in a tag does. The same lines go in the startup file
+(#doc("config")).
+
+#pairs(
+ [#word("Theme") `<name>`], [`orchard`; names as #word("Themes") lists them, #word("NextColor") steps to the next in that list (#doc("themes"))],
+ [#word("ThemeFile") `<path>`], [a `.zon` theme, relative to the config directory; reloads live when saved],
+ [#word("FocusTint")], [on: tint the focused pane's and column's tags],
+ [#word("SyntaxBold")], [off: bold syntax keywords],
+ [#word("Verbose")], [on: a builtin announces its name on the message row],
+ [#word("MessageAnimation")], [on: messages ease in and dissolve],
+ [#word("MessageLinger"), #word("MessageFall"), #word("MessageDissolve")], [800, 180, 150 milliseconds, at most 60000],
+ [#word("PagerColor")], [on: the next paged text keeps its colours],
+ [#word("ProgramEsc")], [off: in a raw terminal #key("Esc") goes back a pane and #key("Shift-Esc") is the program's Esc; on swaps them, and #key("Esc") goes back only at an empty shell prompt],
+ [#word("Pager") `pardes|off`], [`pardes`: what a terminal's commands page through, `pardes -`; `off` leaves `PAGER`, `GIT_PAGER` and `SYSTEMD_PAGER` as the environment has them (#doc("fs", section: "pardes-stdin")). It applies to terminals started after it],
+ [#word("Placement") `acme|pardes`], [`acme`: where new panes go (#doc("fs", section: "placement"))],
+ [#word("BootShell") `keep|replace`], [`keep`; `replace` closes the untouched lone shell a dragged document lands beside],
+ [#word("LookWord") `search|list`], [`search`: a word given to #word("Look") selects its next place, or lists all in `+Search`],
+ [#word("DirLook") `pane|terminal`], [`pane`: #word("Look") on a directory opens a pane listing it, as acme's directory window (#doc("reference", section: "from-acme")); `terminal` types `ls` into a terminal idle there, else opens one],
+ [#word("JumpScope") `file|all`], [`file`: #word("Back") and #word("Forward") keep to the focused pane's file, that pane's places first, then the file's in another pane, and go to another file only when the file has no place left that way; from a terminal or a pane with no file they step through every place; `all`: every place, in the order it was jumped to],
+ [#word("TermImages") `real|petscii`], [`real`: a new terminal draws its program's kitty graphics (yazi's previews) as pixels where the shell can; #word("Petscii") flips one terminal; a tty under a terminal without kitty graphics draws them as glyph art either way],
+ [#word("Shell") `<name or path>`], [`$SHELL` when it is executable, else `/bin/sh`: the shell the next terminal and command pane run; a bare name is searched for in the usual bin directories, not `$PATH`; bare #word("Shell"): `$SHELL` if it is executable, else `/bin/sh`],
+ [#word("DumpDir") `<dir>`], [`$XDG_DATA_HOME/pardes`, else `~/.local/share/pardes`: where #word("Dump") writes, an absolute or `~` path to a directory that may be written (made if missing); a relative one, or one under a directory that may not be written, is refused; bare returns to the default],
+ [#word("TreeContext")], [off: sticky declaration headers in a source pane (per pane, dumped)],
+ [#word("TreeContextTagStyle")], [on: draw those headers in the tagline style],
+ [#word("LocationsConfig") `...`], [the layout of #word("Grep"), search and language-server results (below)],
+ [#word("Wrap"), #word("Colors"), #word("Tagbottom"), #word("Debug")], [toggles],
+ [#word("Font") `<name>[:<size>]`, #word("Fonts")], [SDL and macOS only; size 8-72 (pixels in SDL, points on macOS)],
+ [#word("TaglineSize") `<1-100>`], [82: tagline face, percent; SDL and macOS],
+ [#word("WindowOpacity") `<0-100>`], [100; SDL only: everything but text and the cursor],
+ [#word("Ligatures")], [on; SDL only, macOS draws CoreText's own],
+ [#word("Pet") `cat|frog|off`], [off; SDL only: a sprite in the workspace tag's blank space],
+)
+
+#word("LocationsConfig") with no argument prints the current settings as a line
+that can be run again; with fields it changes only those:
+#word("LocationsConfig") `context:5 tscontext:on tslocations:off layout:stacked`.
+`context` (0) is the source lines shown above and below each match;
+`tscontext` (off) includes the enclosing tree-sitter declaration headers;
+`tslocations` (on) shows a location on each declaration header; `layout`
+(`stacked`) puts the location on its own line, `inline` beside the source,
+padded in groups of eight matches. An invalid field rejects the whole line;
+a repeated field's last value wins. The settings survive #word("Dump") and #word("Restore").
+Source analysis is cached for 64 files and 64 MiB.
+
+*Effects.* Panel transitions, one at a time, running the active one again
+turning it off: #word("PanelSlide"), #word("PanelZoom"),
+#word("PanelDissolve"), #word("PanelAscii"), #word("PanelVertical"),
+#word("PanelEdges"), #word("PanelFall"), #word("PanelWave"),
+#word("PanelCurtain"), #word("PanelScramble"), #word("PanelType"); all
+start off, and the web shell has none. Scene passes (the SDL window, and
+one attached to a detached session), each at a level 0-3 (`on` is 2), all
+off: #word("Crt"), #word("Bloom"), #word("Vignette"), #word("Grain").
+#word("Shader") `<file.glsl>` adds a Shadertoy file written for ghostty to the
+chain (#word("Shader") `off` removes it; it recompiles when saved);
+#word("ShaderAnimation") `off|on|always` says when the chain animates by itself. The
+focused pane can stand off the page: #word("Lift") `shadow|rim|auto|off`,
+#word("InactiveDim") `<percent>`, #word("Motion") `off|crisp|smooth|bouncy|playful` (default
+`smooth`), #word("SelectionGlow"), #word("HoverGlow"), #word("Occlusion"),
+#word("Parallax"), #word("JumpTrail"), #word("ChipShadow"),
+#word("ThumbFlash"), #word("CursorBlink"), #word("GripWidth") `<50-300>`. Most are
+the GUI's; #word("InactiveDim") works everywhere, and #word("JumpTrail"),
+#word("ChipShadow") and #word("ThumbFlash") are the terminal's. No effect
+may lower the contrast of text, the selection or a focus indicator.
+#word("EffectCode") `<effect>` lists that effect's sources under `/virtual` when the
+build embeds them.
+
+Resting the pointer on text for about 32 ms (`look_preview_delay_frames`,
+2 frames, in `src/config.zig`; `null` turns it off) tints what #word("Look") would take, with no other effect. A terminal's or a `+Pager`'s
+#word("Filter") keeps each foreground at least `tty_filter_min_contrast`
+(WCAG 1.5, `src/config.zig`) against its background.
+
+= Columns and tags <columns-and-tags>
+
+#file("/layout") has a line per column, left to right: `serial index x width current|notcurrent empty|full pane-serials...`, then `active <serial>` (the active column: where #file("pane/new") and a look put the
+next pane; `-` when none). `current` is the column with the keyboard now,
+which may differ from the active one (#doc("tags", section: "command-panes")).
+#file("/index")'s last field is each pane's column serial.
+
+A session holds 16 columns (`no space for a column: 16 max`, ENOSPC), each
+at least 10 cells wide, so 16 wants a window 160 cells wide or more.
+#word("Newcol") halves the column it is run from, and one under 20 cells
+does not split (`this one is too narrow to split`): reach 16 by writing
+#word("Newcol") to the widest column's #file("exec") each time, not to the
+root's, which keeps halving the one just made. #word("Newcol") is refused
+as well when a narrower column would wrap its panes' tags onto more rows
+and leave one under its tag and two rows (`Newcol: no space for a column: the panes' tags would not fit`); a refused #word("Newcol") logs its `err`
+alone and uses up no column serial.
+
+#file("/col/<n>/ctl") takes #word("Delcol"), #word("Joincol"),
+#word("New") and #word("Tty") for that column; #file("/col/<n>/exec") is
+a click in its tag; `rmdir /col/<n>` closes an empty column (one with
+panes: ENOTEMPTY). Closing a column's last pane leaves it empty (the
+keyboard goes to its tag, #file("focus") reads empty, the log says only
+`del`); closing the session's last pane quits pardes. The log says
+`newcol <serial>` and `delcol <serial>`.
+
+#file("tag") files (#file("/tag"), #file("/col/<n>/tag"),
+#file("/pane/<n>/tag")) read the whole tag, with no newline after it. A
+pane's starts with its computed path (an image's with its mode words, a
+PDF's with its page), then the editable text. `>` replaces the editable
+text (the default words too: `echo Make > tag` leaves only `Make`) and
+drops the one newline that ends it; `>>` appends, so
+`printf ' Make' >> tag` (the blank matters; `echo` would start a second
+line). A pane tag may hold several lines; a column or workspace tag is
+one, a newline written into it becoming a space. Control characters other
+than tab, DEL, C1 controls and non-UTF-8 bytes are refused (`invalid tag text`). The editable text is at most 4096 bytes (`no space: over 4096 bytes`, ENOSPC; the log says `err <serial> tag: no space: ...`). All
+three kinds take the same checks, whole or not at all, and a `>` whose
+write is refused changes nothing: its truncation is done with the write
+that fits, or at the close (or a read) when none came. Each write stands
+on its own: in a `>` cut into several writes, those taken before a refused
+one stay in the tag; only the refused write changes nothing. A clear is an
+ordinary edit and #key("u") in the tag undoes it.
+
+= Panes <panes>
+
+*Making and closing.* Opening #file("/pane/new") makes a scratch
+`<dir>/+New` (the session's directory), and reading that open answers its
+serial: `n=$(cat $m/pane/new)`. *Each open makes another pane*; two reads
+of one open answer the same serial. It goes where a #word("New") from a
+tag would (#doc("fs", section: "placement")): in the active column,
+filling it if empty, else the bottom half of its last pane. A session
+holds 64 panes (`no space for a pane: 64 max`), and every pane keeps its
+tag and 2 rows (`no space for a pane in that column: each keeps its tag and 2 rows`); both are ENOSPC, for this open and for #word("Look"), #word("Exec"),
+#word("New") or #word("Tty") alike. A #file("pane/new") whose column is
+full takes its rows from a pane in another column that has them, last
+column first, as acme does, and is refused only when no pane anywhere can
+give them. `rmdir /pane/<n>` closes the pane, unsaved or not.
+
+*#file("name")* reads the file name (a terminal's directory); a write
+renames the buffer (relative to the pane's directory) and marks nothing
+dirty; #word("Save") then writes under the new name. A name takes any byte
+a file name can hold, blanks, control bytes and bytes not UTF-8 included,
+so what #file("name") reads writes back as it was; refused (EINVAL) are
+an empty name, a NUL (`bad character in file name: an
+empty name`, `...: a NUL`) and a second line, by the write that brings it (`invalid file name: one name a write, on one line`). Up to
+255 bytes a component. A name that can never be valid (a terminal's, a
+component over 255 bytes, a path too long) is refused by the write that
+holds it. The ctl word `name x` takes all after its one
+blank; a second blank there is refused rather than read as the name's
+first byte. A directory (`/`, `~`, `foo/`) is no file name: refused,
+EISDIR (`name: /home/u is a directory, not a file`).
+
+*#file("body")* reads the text; a write appends; `>` (OTRUNC) replaces it
+all. A terminal's body is its history as plain text in logical lines
+(wrapped rows joined), frozen per open; writing it sends input to the
+child as typed keys, never a paste: no bracketed-paste marks around it,
+even when the program asked for them, so a newline in it is Enter. A PDF's
+body is the text layer of the page shown, each line of the page's text a
+line of the body, read-only: it is no text of the
+pane's, so #file("addr"), #file("data"), #file("dot") and a `file:<addr>` #word("Look") do not address it (a PDF's `:<n>` is its page); images and PDFs take
+no write (`this pane has no text`).
+
+*Image panes.* An image pane's tag reads `img petscii:on|off
+palette:commodore|terminal ascii:on|off <path>`. `petscii` says what is
+drawn: glyph art (`on`) or pixels (`off`). With no graphics it is always
+`on`; #word("Petscii") `on|off` chooses for when graphics are there. `palette` is which 16
+colours the glyph art uses, the C64's (`commodore`) or the terminal
+theme's own 16 (#word("Palette") toggles it); `ascii` is whether the
+printable ASCII bitmaps join the glyph set the matcher picks from
+(#word("Ascii") toggles it). #word("Palette") and ascii only change the glyph art.
+#word("Petscii") and #word("Ascii") (`on|off`) and #word("Palette")
+(`commodore|terminal`) take the value their tag word shows and set it, as
+a PDF's #word("PdfFit") (`width|height`) and #word("PdfTint")
+(`disabled|filtered|full`) take the value its ctl read shows; bare, they
+step to the next.
+A terminal pane showing kitty graphics shows `petscii:on|off` after its
+directory in its tag, saying the same, and #word("Petscii") chooses there
+too. A terminal with no images shows the word only while #word("Petscii")
+is on.
+
+*#file("sel")* reads the selected text; a write replaces it and leaves
+the written text selected, and one open's writes run on from the last.
+*#file("errors")* is write-only: text appended to the directory's
+`+Errors` pane (logged as `msg` records when no column has room).
+
+*#file("focus")* (root): a serial written gives that pane the keyboard and
+makes its column the active one (a folded pane stays folded); `no such pane`, or `ill-formed control message` for a non-number. It reads empty
+while a column or workspace tag has the keyboard.
+
+*Pane ctl.* Reading it gives acme's status line: serial, tag length, body
+length, isdir (1 for a directory pane, else 0), dirty, width in cells, font, tab width, undo available,
+redo available, then `current`/`notcurrent`, a REPL's id if bound,
+`collapsed` when it is, and for a PDF `fit:width|height
+tint:disabled|filtered|full`. Each field ends in a blank and the line has
+no newline, as acme's has none (`cat ctl; echo`). It
+takes:
+
+- the pane builtins: #word("Del") (from the keyboard between two panes it
+ asks which takes the rows, the question on the notice band after 400 ms
+ and in the log at once as `ask`; a click, a ctl write or an `init` line never
+ asks and gives them to the pane above; #word("Del") `k`/#word("Del") `j`, or
+ #word("DelAbove")/#word("DelBelow"), give its rows to the pane above or
+ below), #word("Save") `[path]` (bare, on a `+`-named pane that is no output,
+ such as `+Tutor`, it asks for a path; making the directories the file goes in first,
+ whichever name it writes), #word("Collapse"), #word("Undo")/#word("Redo")
+ (256 steps each), #word("Find") `pat`, #word("Edit") `...`, #word("Tty") `[shell]` (a new terminal
+ in its directory), #word("Delcol") for its column, and
+ #word("Left")/#word("Right")/#word("Up")/#word("Down"), which give the
+ keyboard to the pane beside it that way, up from a column's top pane to
+ its tag; #word("Window") (#key("Ctrl-w"), #key("SPC w")) picks the pane
+ first: #keys("h", "j", "k", "l") move an outline, #key("Enter") or
+ #key("Esc") or a pane's letter focuses, #key("d") is #word("Del") and
+ #key("c") #word("Collapse") on the outlined pane.
+- `get`: reload from the file (refused once over unsaved edits, `<name>: Modified (get again to discard)`). It is an undo step, so #word("Undo") brings back what was there: the sure way back to the file on disk.
+- `lock`/`unlock` (acme's). The lock binds only clients that take it and
+ belongs to the open that wrote it: `exec 3>$pane/ctl; echo lock >&3; ...; exec 3>&-`. A `lock` another open holds fails at once, `file in use`
+ (EBUSY): retry.
+- `answer <choice>` to the question the pane asks on its message row,
+ logged `ask <serial> <what> <choices>` (`ask 4 del k j`, `ask 4 repl a b`, `ask 4 save path`); `answer -` takes it back.
+- acme's lowercase ctl words, done by what replaces each: `name x`, `put`
+ (#word("Save")), `clean`/`dirty`, `del`, `delete` (no asking), `dot=addr`,
+ `addr=dot`, `limit=addr`, `mark`/`nomark`, `show`, `cleartag`. `dump`,
+ `dumpdir`, `font`, `menu`, `nomenu` are refused, EINVAL. These lowercase
+ words are ctl-only: written to an #file("exec"), `del` is a command line.
+
+A file changed on disk reloads by itself only when the buffer has no
+unsaved edits; otherwise it stays dirty, says `<name> changed on disk (get reloads it, Save overwrites it)`, logs `changed <serial>`, and its next
+#word("Save") warns once. A file whose disk text is what the pane was read or saved as is no change: an #word("Undo") back across #word("Get") `file` or `e` to unsaved edits says nothing changed, and #word("Save") writes it.
+
+== Addresses and data <addresses>
+
+#file("addr"), #file("dot") and #file("limit") read the pair of byte
+offsets they take, so copying one onto another (`cp $p/addr $p/dot`) is
+acme's `dot=addr`. A write is a pair or an address expression; a pair is
+checked as an address is, `addresses out of order` (`5 2`) or `address out of range` (past the text), never clamped. #file("addr") names where
+#file("data") reads (to the end of text) and the range #file("xdata")
+reads; #file("dot") is the selection (moving it scrolls the pane there);
+#file("limit") bounds the end of a forward search and reads empty until
+set. Truncating #file("dot") empties it, truncating #file("limit") lifts
+it.
+
+- A write to #file("data") or #file("xdata") *replaces* the #file("addr")
+ range (`>` and `>>` alike); `: > data` deletes it. Truncating
+ #file("data") is pardes's own (acme ignores OTRUNC there); only
+ truncating #file("body") empties the buffer.
+- A write leaves #file("addr") just past what it wrote, so a second
+ `echo x > data` inserts after the first: write #file("addr") before each
+ replacement. A read of #file("data")/#file("xdata") moves #file("addr")
+ past what it read.
+- #file("addr") belongs to the pane, not the client, and neither an open
+ nor a truncation resets it (acme resets on first open): each
+ `echo /re/ > addr` searches on from the last, so a find loop advances.
+ Write `0` to start at the top; searches wrap, so stop a loop when the
+ address comes back or set #file("limit").
+- A failed address leaves *no address*: #file("addr") reads empty and
+ #file("data")/#file("xdata") refuse (`no address: the last one written to addr failed`) until a standalone address (`2`, `#0`, `/re/`) is written,
+ so a missed target is never written at the old one.
+
+Addresses are sam's: `#n`, a line number, `/re/`, `?re?`, `-/re/`, `$`,
+`.`, `0`, ranges `a,b` and `a;b`, `+`/`-`. They are evaluated from the
+current address (the last written to #file("addr"), or just past the last
+#file("data") write), not from the selection. pardes adds `12:5`: line 12,
+*byte* column 5 from 1, clamped to the line's end (`12:0` is `address out of range: a column counts from 1`); it composes (`12:5,14:1`). A tool's
+character column matches only on an ASCII line; elsewhere use `12/name/`
+or `#n`. A row of #word("Recent"), `+Search` or the #word("Jumplist")
+spells a range `12:5-14:2` (through 14:2 inclusive) and #file("addr")
+takes it as such.
+
+Offsets and counts are bytes everywhere (acme counts runes), but every
+address lands on a rune boundary: `#n` or `L:C` inside a rune snaps to its
+start, a match covers the runes it touches, and a combining mark or a
+CRLF's `\r` is addressable alone.
+
+Refusals: `invalid address: this pane has no text to address` (#file("addr"), #file("dot")
+and #file("limit") on a terminal, an image or a PDF), `bad address syntax`, `no match for regexp`, `address out of range`, `addresses out of order` (`#100,#50`), `bad regular expression`.
+
+sam details kept: `$-1` is the last line when the text ends in a newline,
+else the one before; with a final newline the empty place after it is a
+line (`1` of an empty text is `#0,#0`, so #word("Edit") `1i/x/` works on an empty
+file); `2,1` is an empty range at line 2's start; `/^/` finds the empty
+place after a final newline; a pattern that can match empty (`^`) passes
+over the match where the search starts.
+
+== Regular expressions <regexp>
+
+Patterns are mvzr's (classes, `\d\w\s`, `{m,n}`, lazy `*?`), searched as
+sam searches, line by line: `^` and `$` match at any line's start and end,
+`.` and `[^...]` never match a newline. The same code (`src/regexp.zig`)
+serves addresses, #word("Edit"), and normal mode's #key("s") and #key("S"). The
+ceiling:
+
+- The leftmost match wins, but among alternatives the first that matches,
+ not sam's longest (`/gam|gamma/` finds `gam`). mvzr keeps no submatches,
+ so #word("Edit")'s `s` has no `\1`-`\9`.
+- A pattern holding `\n` runs over the whole text: there `^` may only come
+ first and `$` only just before a `\n`, else it is refused.
+- An alternation must anchor every branch with `^` or none (`^def|^ `
+ works, `^def|x` is refused: `an alternation anchors every branch with ^ or none`). A `$` does not count: `foo$|bar` is fine.
+- A class may hold non-ASCII runes (`[éa-z]`, a range up to 256 runes); a
+ wider range or a negated class with one (`[^é]`) is refused.
+- At most 512 operations (about 512 characters, counted after that
+ rewriting): `bad regular expression: longer than mvzr's 512 operations (about 512 pattern characters)`.
+- Each search has a step budget (about 300 ms; each search of an #word("Edit") `x`
+ its own): `regular expression search took too much time, gave up`. What
+ runs out is exponential backtracking (`a?` twenty times then twenty
+ `a`s) or a quadratic pattern over a very long line.
+
+== Edit <edit>
+
+#word("Edit") `<sam commands>` on a pane's #file("ctl") or #file("exec") (or the
+root's, at the pane with the keyboard) runs acme's #word("Edit") over the open text
+panes, from that pane's body. Addresses are as above, and `"re"` is the one
+open file whose line matches. Commands:
+
+- `x y g v c a i d s p = m t u` and `{ }`.
+- `X`/`Y` run a command in each open file whose line (` +. /path`, `'` when
+ edited) matches, or does not, in the order the panes were opened (as
+ #file("index") lists them): `X/'/w` writes every edited file.
+- `b` makes a file current; `B` opens files, every name checked before any
+ opens; `D` closes panes (an edited one on the second asking, as
+ #word("Del")).
+- `e` loads a file over the whole text as #word("Get") `file` does, once the
+ rest of the Edit is done: the pane takes its name and is clean, one undo
+ step puts both back, and unsaved edits are asked about once (a scratch
+ under 100 bytes is not); the file
+ takes no other command in that Edit. `r` reads a file over dot. `w` writes
+ all of it, or the address, to its file or a name; all of it to its own
+ name leaves it clean. A `w` to its own file changed on disk since it was
+ read is refused once, as #word("Save") is (`modified on disk since read (w
+ again to overwrite)`), and the next `w` writes it; in an `X` the other
+ files are written, and the refusal names those it left. `f` names the pane and prints its line. File names
+ are relative to the file's directory, and `~` is the home directory.
+- `<cmd` replaces dot with what `cmd` writes, `|cmd` pipes dot through it,
+ `>cmd` sends dot to it and prints what it writes.
+
+Each command runs in its file's directory through #word("Shell"), off the
+loop, so the editor goes on, with what a pane's command is given:
+`$PARDES_MOUNT`, `$PARDES_9P`, `$PARDES_PID`, and `$winid` the Edit's pane. The write that ran the Edit is held and
+answered when they are done, its connection serving other requests
+meanwhile (a command may read the session through its mount). A command
+that writes the #file("ctl") its Edit came by needs `<>` on both sides, the
+Edit's write (`exec 3<>$p/ctl; echo 'Edit ...' >&3`) and its own (`1<>`):
+with `>` or `>>` on either, the kernel holds the second write until the
+first is answered, the command is stopped at its 10-second limit, and the
+Edit fails (EIO), changing nothing. For the same reason a second Edit written
+with `>` to that #file("ctl") waits for the first to finish rather than being
+refused; through its own `<>` open, or another pane's #file("ctl"), it is
+refused `busy` (EBUSY) at once. A flush of the Edit's write (an interrupted
+writer) kills the commands and changes nothing.
+Such an Edit is a write of its own: one with other lines is refused before
+any runs. One Edit's commands run at a time in a session, at most 1024 of
+them. While they run, an Edit with no commands runs as usual unless it
+would change, undo, rename, close or write a file the running one changes;
+that, and a second Edit with commands, is refused `busy` (EBUSY), as are
+#word("Del") (acme's `delete`), `rmdir`, #word("Undo"), #word("Redo"), #word("Get") and #word("Zerox") on a pane
+it changes or runs a command on; a session that ends lets the commands go. A command that fails (an exit status, 10 seconds, 1 MiB of output)
+fails the Edit, its stderr in `+Errors`. Each file's changes are one undo step, applied only if
+every command succeeds; a failure changes nothing and fails the write with
+acme's words (`Edit: no substitution`), as does a file edited while the
+commands ran. An `x` that finds nothing succeeds silently. `p`, `=` and `>`
+print to the directory's `+Errors`. Not there: `B <cmd`, `D <cmd`, the `'`
+address, `\1`-`\9`. In `s`, `&` is the match (`\&` a literal); in `c`, `a`,
+`i` it is a literal. `y` yields the stretch before the first match too.
+Braces take a command a line, so a block goes on one open, in one write or
+several:
+#cmd("printf 'Edit ,x/foo/{\\ni/</\\na/>/\\n}\\n' > $p/ctl")
+
+== Flags and undo <flags>
+
+#file("dirty"), #file("mark") and #file("scroll") read and take `0` or
+`1`: the buffer differs from its file (a file deleted on disk counts); a
+write pushes an undo point (writing `1` pushes one now); a write scrolls
+the pane. #file("/index")'s dirty flag is #file("dirty"); a `+New` scratch
+reads 1 but holds up nothing under 100 bytes.
+
+The writes of one open of #file("data"), #file("xdata") or #file("body")
+are one undo step (so a multi-line `printf` is one), as long as no other
+client or keystroke edits the pane between them: such an edit ends the
+step, and the open's next write starts another. To make a loop of opens
+one step: `echo 1 > mark` (a point now), `echo 0 > mark`, the writes,
+`echo 1 > mark`.
+
+== event <event>
+
+Holding #file("event") open takes the pane's #word("Look") and #word("Exec") clicks: they
+come to the reader as records instead of acting, as do lines written to
+the pane's own #file("look")/#file("exec") (or the root's while it has the
+keyboard). A record is acme's `<origin><action><q0> <q1> <flag> <n> <text>\n`; read `n` *bytes* of text, which may hold newlines. Reads may be shorter
+than a record: a record arrives in pieces across reads, so a shell's
+`read` loop works. One open
+reads a pane's #file("event") at a time, as acme's is one window's: a
+second open for reading fails `file in use` (EBUSY) until the first is
+closed. A reader whose pane has closed reads EOF.
+
+- origin: `E` a 9P write to body or tag, `F` other files and the editor's
+ own lines, `K` keyboard, `M` mouse.
+- action: `X`/`L` #word("Exec")/#word("Look") in the body, `x`/`l` in the tag (offsets
+ into the whole tag, path included), `I`/`D` body text inserted/deleted,
+ `i`/`d` the tag's.
+- flag: 1 the text's first word is a builtin, 4 (#word("Look")) a file name or
+ address, 8 (exec) chorded: two records follow, the argument and where it
+ came from. pardes never sends flag 2.
+- A written line, or a click in a terminal's body, has no place: `0 0`
+ with its text (`FX0 0 1 6 Msg hi`).
+
+Write a record back to have it done as the click would: `<o><a><q0> <q1>\n` acts on that range (the last record of a write needs no newline),
+and an empty one (`MX12 12`) on the word or file name a click there expands
+to; the whole record as read acts on its text (the only way for `0 0`). A
+chorded record with its two follow-ups, in one write or three, runs once
+with its argument. A record written back that runs a builtin which fails
+(a refused #word("Del")) fails the write, EIO with its `err`, as an
+#file("exec") write would. `I`, `D`, `i`, `d` are refused; the origin must be `E`, `F`, `K` or `M`,
+and a number larger than a range can hold is refused `bad number`,
+EINVAL. A helper holding
+#file("event") that writes its own pane's #file("exec") gets its command
+back as a record: run it through #file("ctl") instead.
+
+== REPLs <repls>
+
+#word("Repl") `python` on a terminal's #file("ctl") (or in its tag) binds it as
+that language's REPL: #word("Exec") (or #key("Tab")) on a `.py` body
+then types the text into the REPL instead of running it; builtin words,
+tag words, #word("Exec") `<text>` and #raw("@`cmd`") words still run. #word("Repl")
+takes the languages a code fence names (ada, bash, c, c_sharp, clojure,
+cpp, css, elixir, erlang, fortran, go, haskell, html, java, javascript,
+json, kotlin, ocaml, markdown, pascal, php, powershell, python, ruby, rust,
+scala, typst, zig) and aliases such as `py` and `sh`. Its tag and
+#file("ctl") line show its id, `python-a`. #word("Repl") `-` unbinds, bare
+#word("Repl") says the binding. With several bound, the pane asks (`ask <serial> repl a b`). Bindings are not dumped.
+
+A 9P #file("exec") is never sent to a REPL. A script either writes the
+event record `MX<q0> <q1>` to the `.py` pane's #file("event") (sent as the
+click would be), or writes the REPL's #file("pty/data") itself: multi-line
+code as a bracketed paste, `\e[200~<code>\e[201~`, then `\r` in a separate
+write once the REPL has echoed the paste; a paste of more than one line
+not ending in a newline needs a second `\r`. Line by line, a blank line
+ends a Python block and Python 3.14 auto-indents each line.
+
+= Terminals <pty>
+
+Terminal panes also have #file("pty/"):
+
+- #file("pty/data"): write bytes as typed (`printf 'ls\r'`, `\x03` is
+ Ctrl-C); read the live output stream (a consuming queue shared by
+ readers, not a replay).
+- #file("pty/status"): one line, `cols rows busy`; busy is 1 while a
+ command runs or text is typed at the prompt. A terminal whose program was
+ killed on the alternate screen is at its prompt once the shell draws one
+ there: busy is 0, and the next #file("pty/run") reads its output whole.
+- #file("pty/ctl"): `winsize C R` (at least 2 rows, fewer refused `invalid winsize: at least 2 rows`; at most 4096 a side), `sig INT|TERM|HUP|QUIT|KILL`, `exec` (restart the shell in its directory:
+ refused on a command pane, `a command pane does not restart`; `exec: <dir>: no such directory` if it is gone; a shell that cannot start fails
+ and leaves the old one running).
+- #file("pty/run"): one line a write (two lines in one write are refused
+ whole; through a mount a shell's `printf` of two lines arrives as two
+ writes, so the first runs and the second is refused EINVAL), at the
+ shell's prompt, answered on the same
+ open: #cmd("exec 3<>$m/pane/$n/pty/run; echo make >&3; cat <&3; exec 3<&-")
+ The answer's first line is the header: `exit N` then the command's output
+ (as the screen showed it: no colour, tabs expanded to blanks, `\r`
+ progress collapsed, trailing blanks dropped; a paging command's text
+ goes to a `+Pager` pane through the terminal's `pardes -` pager; the last 64 KiB, `exit N cut M` when M bytes were left
+ out, bare `cut` only when the start of that output scrolled out of the
+ scrollback; after a `clear`, the answer is what the command printed from
+ the clear onward). Or: `busy: <program> is running` (bare `busy` when text is typed at the prompt, `busy alternate screen` on the alternate screen with no prompt drawn),
+ `exit ?` (no status reported, not a success), `error not run` (the shell
+ refused the line, e.g. a fish syntax error), `error shell gone`, `error no prompt marks`, and on a command pane `error a command runs here, not a shell` (`error command done; not a shell` once it ended). A line written
+ before a fresh terminal's first prompt waits for it. One line per run; a
+ second line before the answer is refused.
+
+#file("pty/run") relies on the OSC 133 marks pardes injects into bash and
+fish; `exec zsh` or a continuation prompt never reports an end, so cancel
+the read. A program on the alternate screen (vim, less) leaves no output.
+A program holding the terminal (a REPL, `less`) takes no run: write to
+#file("pty/data").
+
+= The log <log>
+
+One 64 KiB ring, one record a line, kept whether or not anyone reads it.
+An open freezes it and reads to EOF. Write `follow` to that open to then
+wait for each new record (`follow new` skips the history, as `tail -n0 -f`); `tail -f` never writes `follow`, so it sees nothing new. A follower
+the 64 KiB ring outran (it keeps only the newest records) reads `lost N` first. A #word("Restore") hangs the follower up: dial
+again and read from `restore <path>`. A follower's read held when the
+#word("Restore") comes takes every queued record that fits first, so records written
+just before the #word("Restore") are not lost.
+
+#pairs(
+ [`new <serial> <name>`, `del`, `rename`, `save`], [a pane made, closed, renamed (a terminal's too, as its shell changes directory), saved (#word("Save") `path` of a copy: `save <serial> <path>`, the path written)],
+ [`newcol <serial>`, `delcol <serial>`], [a column made or closed],
+ [`msg <serial|-> <text>`], [the editor said something (not a builtin's own name under #word("Verbose"))],
+ [`err <serial|-> <file>: <why>`], [a write was refused or failed],
+ [`run <serial> <line>`, `exit <serial> <N|?>`], [a command pane's command started and ended; also a terminal whose shell exited, before its `del`],
+ [`send <from> <to> <repl-id>`], [text went to a REPL],
+ [`ask <serial> <what> <choices>`, `answer <serial> <choice|->`], [a pane asked, and was answered (`-`: taken back, or the pane closed)],
+ [`changed <serial> [reloaded|deleted]`], [its file changed on disk (bare: under unsaved edits)],
+ [`unsaved <serial> <name>`], [a pane an #word("Exit"), #word("Restore"), #word("Del") or #word("Delcol") refused over, before the `err`],
+ [`dump <path>`, `restore <path>`], [a #word("Dump") written; a #word("Restore"), after its panes' `new`s],
+ [`restored <old> <new>`, `restoredcol <old> <new>`], [serial maps after a #word("Restore")],
+)
+
+The serial is the pane the line ran at (the pane with the keyboard for the root's
+#file("look")/#file("exec")), `-` for the root #file("ctl"),
+#file("/tagexec") and column files. A record said again straight after
+itself is counted, `err 3 addr: no match for regexp (x4)`; a follower sees
+each count as a new line. A `msg` is cut at 256 bytes and an `err` reason
+at 200, ending in `…`. Control characters become spaces.
+
+= Other files <other-files>
+
+- #file("/screen"): JSON `cols`, `rows`, `cursor`, `styles`, and row-major
+ `cells` of `[grapheme, style_index]`; one frame per open. Compare a
+ cell's style through `styles`, not the index.
+- #file("/commands"): `Word [arg] root|pane|both [values] -- sentence`, one
+ a line, generated from the builtin registry (`both`: #word("Edit"), at the active
+ pane from the root).
+- #file("/recent"): up to 200 files, PDFs and images, most recent first,
+ `open <path>` or `closed <path>` (open in this window or not), every
+ window's: kept in `$XDG_STATE_HOME/pardes/store`, shared by every pardes
+ process, each reading what the others wrote when it is next read.
+ #word("Recent") lists them in a query pane (line 1 `Recent`, the rest
+ narrowing them by a fuzzy match), an open one at its dot now and a
+ closed one at its last (a PDF's is its page); a #word("Look") of a row reopens it
+ there.
+- #file("/status"): `pid`, `version`, `panes`.
+- #file("/pager"): write a directory, `~` expanded and resolved (an empty
+ line is the session's; one not there is refused ENOENT, a relative one
+ EINVAL, one you may not write `permission denied`, a regular file `not
+ a directory`, ENOTDIR), one line; what follows that line, on the same open, is the text to
+ page, escapes and all. A read of that open answers the serial of a new
+ `+Pager` in the directory, once the text is in. This is what
+ `pardes -` uses; from a directory you may not write, it pages into a
+ `+Pager` of the session's.
+- #file("/listeners"): the session's dial addresses, a line each
+ (#doc("building", section: "listeners")).
+- #file("/os/"): existing regular files take read, write and truncation to
+ zero; create, remove, rename and mode changes are refused as not
+ permitted (`permission denied`, EACCES through a mount); ownership is
+ synthetic. Linux v9fs's truncation `mtime` hint is accepted and dropped.
+- #file("/src/") (and #file("/shaders") on GUI builds) with
+ `-Dembed-sources=true`; #word("EffectCode") `<effect>` lists an effect's files
+ under `/virtual`.
+
+= The pardes command <command-line>
+
+In a pane's shell (`PARDES_PID`, `PARDES_9P` and `PARDES_PANE` set),
+`pardes FILE` writes FILE to that pane's #file("look") and returns at once;
+a FILE not there yet opens an empty pane that #word("Save") creates, making
+its directories. What the session refuses (a bad name; a name under a
+directory you may not search or write, `permission denied`) is printed and
+the exit is 1. `--` ends the options (`pardes -- -name`).
+`pardes --wait FILE` (`-w`; bare, it says it needs a FILE) returns 0 when the pane showing FILE is
+deleted, 1 when the session goes away (against a dead `$PARDES_9P` it
+says the session is gone); with
+`PARDES_9P` set but no pane of its own it opens FILE in that session and
+waits there. Bare `pardes` in a pane refuses and names `--nested`, which
+starts a separate session whose shells do not forward to it.
+
+= Placement <placement>
+
+#word("Placement") `acme` (the default) puts a new pane in the column whose tag
+asked, else the active column (last typed or left-clicked in,
+dropped into, its tag given the keyboard, or given the last new pane),
+never a new column. An empty column it takes whole; #word("New") and
+#file("pane/new") take the bottom half of the column's last pane; a pane
+opened from a pane's text (#word("Look"), #word("Tty"), #key("Alt-n")) goes under
+the pane with the most blank rows, or halves the biggest. #word("New") in a
+pane's tag names its `+New` in that pane's directory and column; from a
+column tag, in that column and the session's directory. A command pane
+goes to the last column, or the column whose tag ran it, under either
+placement. #word("Placement") `pardes` fills an empty column whose tag asked or has
+the keyboard, puts a scratch or a shell under the pane that asked, and a
+document beside the last one read (or in a column of its own on a wide
+screen). No pane is made shorter than its tag and two rows; with no room
+the pane is refused.
+
+A command pane runs in the directory it started in, whatever its command
+does with `cd`, and a relative #word("Look") in it resolves there. The next command
+for that directory reuses a finished one (from a column tag, only one in
+that column); one still running, one a background job still prints to, or
+one a #file("exec") open still holds is never reused. In a command pane, #key("n") walks that pane's own `file:line` places first (make's errors), whichever pane was walked last, then on through the others.
+
+= Find and Grep <find-grep>
+
+Both fill the asking pane's query pane (#doc("guide", section: "search")),
+line 1 `Find name` or `Grep text`, and run on a worker thread, never on
+the loop that draws: `rg` when it is on `PATH` (`rg --files` and `rg --json
+--fixed-strings --smart-case`, so `.gitignore` is honoured and hidden files
+are passed over), else pardes's own walk, sorted, 16 deep, passing over
+dot-directories, `.git`, `.jj`, `target`, `node_modules`, `.venv`,
+`__pycache__`, `.zig-cache` and `zig-out`. #word("Find") lists the files once
+and matches their names fuzzily at each key (the best first, 200 shown);
+#word("Grep") matches the text of lines literally, any case unless the text
+has a capital, once the typing pauses (80 ms), and stops at 2000 lines:
+#word("More") (in the query pane's tag) goes on for 2000 more. A directory the
+walk could not open is said under the rows: `N directories skipped:
+permission denied`. A new query cancels the last; rows of a query no
+longer asked never land. Written to #file("exec") (a script) the search runs
+to its end before the write is answered, and one that finds nothing fails,
+`Grep: text not found`, `Find: name not found`, its query pane's count `0`.
+
+= On screen <on-screen>
+
+- *Esc at a prompt* (with #word("ProgramEsc") on). pardes knows a shell prompt with nothing typed on it
+ from the OSC 133 marks it injects into bash and fish (marks a shell sends
+ itself do not count); for other shells, from no program holding the
+ terminal, typed text or not.
+- *A program's mouse.* A program that tracks the mouse (htop, vim with
+ `mouse=a`) gets the left button's clicks and drags and the wheel over its
+ grid; Shift-#btn("B1") selects and Shift-wheel scrolls pardes's
+ scrollback, while Shift-#btn("B2") and Shift-#btn("B3") go to the program.
+ A full-screen program that does not track the mouse gets the wheel as
+ arrow keys. Tags, grips and gutters stay pardes's.
+- *Diffs.* A `---` line opens the old file unless the `+++` under it names
+ another; a removed line's `-` goes to the line now standing where it was.
+ git's `a/` `b/` (and `c/ i/ w/ o/`) prefixes are dropped; a
+ `--no-prefix` diff's paths are kept.
+- *Sessions.* Bare `--detach` names the session after its pid; bare
+ `--attach` needs exactly one session; a second `--detach=NAME` while NAME
+ runs (a plain session is named by its pid) says so in words and exits 1. Frontends share the smallest common size. With
+ none attached, `size C R` sets the screen, messages clear by the clock,
+ and a pty reports its size in pixels at the last frontend's cell size
+ (8×16 before any), as CSI 14, 16 and 18 t do.
+- *Config.* The startup file is `$XDG_CONFIG_HOME/pardes/init` when that is
+ absolute, else `~/.config/pardes/init` (macOS:
+ `~/Library/Application Support/pardes/init`). A line that fails is a
+ notice and `err - init file line N: why`, and the rest still run; a
+ setting only the other frontend has (#word("Font") in a terminal) is skipped;
+ text that is no builtin is not run; saving the init file in a pane
+ applies its settings again and says a bad line as startup does
+ (`err - init file line N: why`), its commands not run again. A dump keeps panes, columns, tags,
+ selections, the theme and changed settings, but not a picture or a PDF
+ that is on disk (#word("Restore") reads it from there); a terminal
+ comes back with its last MiB of output and a new shell in its old
+ directory; undo history and REPL bindings are not kept. A crash appends
+ two lines (build, time, platform, pid; the panic message) to `crashes`
+ beside `init`.
+
+= pardes - <pardes-stdin>
+
+`pardes -` reads stdin to its end and shows it in a new `+Pager` pane of
+the directory, left clean, opening at its top, with no line numbers; a
+`+Pager` already there keeps its page. The session parses the text with
+ghostty-vt: SGR colours become the `+Pager`'s own display, never part of
+its body or any read (#word("PagerColor") `off` pages plain), mapped
+through the theme as a terminal's are until its #word("Filter") shows them
+as sent; every other escape is dropped; a carriage return keeps a progress line's last state,
+and CRLF becomes LF. Empty stdin shows nothing. Inside a pardes pane it returns at once; a text the session cannot
+take is printed to stderr with why, and the exit is 1. From a directory
+whose name holds a newline or control byte, the pane is the session
+directory's. Outside a pardes pane it starts a new editor whose first pane
+the text is. Stdin up to a file's limit (256 MiB) arrives whole; past that
+it is cut, with a note saying so.
+
+With #word("Pager") `pardes`, a terminal's shell gets `PAGER`, `GIT_PAGER` and
+`SYSTEMD_PAGER` set to this pardes plus ` -` (the path quoted only when it
+needs it), and `SYSTEMD_PAGERSECURE=0` (it has no shell escape), each only
+where your environment does not set it. `man` pages through `MANPAGER`
+first, then `PAGER`; your own `MANPAGER` wins.
+
+= Other ways in <other-clients>
+
+A session listens on `$XDG_RUNTIME_DIR/pardes-9p-<name>.sock` (else under
+`~/.local/state/pardes`), `<name>` the pid, the `--detach=NAME` or
+`--9p=NAME`, and posts it in the 9P registry as
+`$XDG_RUNTIME_DIR/9p/pardes/<name>`. Its pane shells get `PARDES_PID`,
+`PARDES_9P` and `PARDES_PANE`. A dead session's registry entry stays
+listed and answers `Input/output error`: name the session, never glob.
+Under `9ns --mntgen` (which sets `NINE_MNTGEN=1`) a session is at
+`$NINE_MOUNT/<service>/<name>`, pardes's `$NINE_MOUNT/pardes/<name>`, and
+every pane pardes spawns gets it as `$PARDES_MOUNT`. Under `9ns --unix SOCK
+-- cmd` the session is `$NINE_MOUNT` itself, and `$PARDES_MOUNT` is unset.
+plan9port's `9p write` opens with OTRUNC, so on #file("body") it replaces
+the whole text. To append, use `>>` through a mount. Through a FUSE mount
+bash's `read -t` cannot time out: wrap a follow loop in `timeout`. The
+scripting chapter's rule (a mount, else `9p`) covers most uses. Two more:
+
+- #word("Tty9p") (#key("SPC n 9")) opens a terminal with the session
+ kernel-mounted (Linux v9fs): it asks for your sudo password in the pane,
+ mounts the socket in a private mount namespace and starts your shell as
+ you, with `PARDES_MOUNT` naming the mount. Only that shell sees it, and
+ each takes one of the session's 16 connections. It needs the `9p` and
+ `9pnet_fd` kernel modules and the `pardes-v9fs` helper the build installs
+ beside `pardes`.
+- `test/ninep.py` is a Python 9P client that exists only in the source tree
+ (it is not installed). It is for when nothing is mounted and `9p` is not
+ there, or when a fid must stay open (#file("event"), #file("pty/data"), a
+ followed #file("log")). Its paths are the served root:
+
+```python
+import sys
+from ninep import Client # PYTHONPATH=test
+with Client(sys.argv[1]) as c: # a socket path, or (ip, port)
+ print(c.read('/index').decode(), end='')
+ n = int(c.read('/pane/new'))
+ fid = c.open(f'/pane/{n}/event', 0) # hold event: clicks come here
+ c.write(f'/pane/{n}/exec', b'Msg hi\n')
+ print(c.read_fid(fid, 0, 4096)) # b'FX0 0 1 6 Msg hi\n'
+ c.close(fid)
+ c.remove(f'/pane/{n}')
+```
+
+`client.screen()` returns the parsed #file("/screen").
+
+= Coming from acme <from-acme>
+
+#pairs(
+ [`$NAMESPACE/acme`], [not posted there: a session is `$XDG_RUNTIME_DIR/9p/pardes/<name>`; reach it with `9p -a "unix!$PARDES_9P"` or a `9ns --mntgen` mount (#doc("fs", section: "other-clients"))],
+ [`N/`], [#file("pane/N/"), N the pane's serial],
+ [`new/ctl`], [read #file("pane/new"): it makes a pane and answers its serial; `rmdir pane/N` closes it],
+ [`index`], [#file("index") lines are serial, kind, dirty, name, column (acme: id, tag and body lengths, isdir, dirty, tag)],
+ [rune offsets], [bytes everywhere, event offsets and counts included; addresses snap to rune boundaries],
+ [`addr` reset on first open], [#file("addr") is the pane's; no open resets it (write `0`)],
+ [OTRUNC on `data` ignored], [`: > data` deletes the addressed text; OTRUNC on #file("body") (`9p write`) replaces it all],
+ [event flags 1, 2, 4, 8], [1, 4 and 8; never 2, so no expansion record follows],
+ [`Get`], [#word("Get") reads the file again, refusing unsaved edits once (a scratch under 100 bytes unasked, as #word("Del") closes it; a file not there, or a directory, is said first); `Get file` loads that file into the pane, which takes its name, and one that fails changes nothing; #word("Undo") after it, or after #word("Edit")'s `e`, puts the old name back with the old text and its saved state; in a directory pane #word("Get") reads the directory again and `Get file` is refused (#word("Look") opens the file) (also `get` on #file("ctl"))],
+ [`Put`, `Delete`, `Load`], [#word("Save"); a #word("Del") that does not ask; #word("Restore")],
+ [`Putall`], [#word("Putall"): every pane with unsaved edits to a file is saved, a #word("Zerox") pair once, a refused one said; with a refusal, its write is answered once the other saves have landed],
+ [`Zerox`], [#word("Zerox"): a second pane on the buffer, one text, undo and unsaved state, its own scroll and cursor; an event reader on one hears no edit made through the other; the twins are kept across #word("Dump") and #word("Restore")],
+ [`Tab`], [#word("Tab") `N`, 1-16: for every pane, not per window; bare, it says the width, from the root's #file("ctl") as from a pane's #file("exec")],
+ [`Incl`], [#word("Incl"): for the session, not per window, seeded with `/usr/include` and `/usr/local/include`; it takes absolute (or `~`) directories that exist, and `Incl -` alone clears the list; a name found nowhere else (`stdio.h`, `<stdio.h>`) is tried there],
+ [`Indent`], [always on: #key("Enter"), #key("o") and #key("O") keep the line's indent as it is],
+ [`Snarf`, `Cut`, `Paste`], [refused: the chords, #key("y"), #key("p")],
+ [`Font`, `Send`, `ID`], [#word("Font"); #word("Repl") and #word("Exec"); `$winid`],
+ [acme's other builtins], [refused: `Sort`, `Local`, `Abort` (plan9port's debugging word)],
+ [Edit], [every acme command but `B <cmd`, `D <cmd` and the `'` address; no `\1`-`\9`, and an alternation takes the first branch that matches, not the longest; a failing `< | >` command changes nothing, where acme puts in what it wrote (#doc("fs", section: "edit"))],
+ [`win`], [#word("Tty") is a VT terminal pane; #file("pty/run") runs a line at its prompt and answers `exit N` and the output; with #word("Repl") bound, #word("Exec") on a source pane types the text into it],
+ [a directory window], [as acme's: a text pane named `dir/` (#file("index") kind `text`, #file("ctl") isdir 1), its entries in columns sorted bytewise, dotfiles shown, a directory's marked `/`; blanks pad the columns where acme's tabs do; a #word("Look") at an entry is from that directory, `Get` or a look at it again reads it again, and an edit is kept until then rather than lost to a resize; never dirty, #word("Save") refuses it; #word("DirLook") `terminal` types `ls` into a terminal there instead],
+ [the plumber], [none: #word("Look") on an `http://` or `https://` URL runs `xdg-open` (`open` on macOS); files, addresses and directories follow built-in rules],
+ [#key("Esc") selects what was typed], [#key("Esc") leaves insert mode, or goes back a pane (#doc("tags", section: "modes"))],
+)
+
+= Limits <limits>
+
+#pairs(
+ [panes], [64],
+ [columns], [16, each at least 10 cells wide],
+ [rows a pane keeps], [its tag and 2],
+ [msize], [65536 (64 KiB) offered],
+ [connections], [16 Unix and TCP, 16 QUIC],
+ [open records], [64 a session, every client's together],
+ [held reads a connection], [128],
+ [named mounts], [8],
+ [command line], [1024 bytes; a held line or #word("Edit") block 1 MiB],
+ [tag text], [4096 bytes],
+ [regular expression], [512 operations; a step budget per search (about 300 ms)],
+ [undo], [256 steps],
+ [log], [64 KiB ring; `msg` 256 bytes, `err` reason 200],
+ [`pty/run` output], [64 KiB],
+ [file name component], [255 bytes],
+)
diff --git a/docs/typ/scripting.typ b/docs/typ/scripting.typ
new file mode 100644
index 00000000..590d71ac
--- /dev/null
+++ b/docs/typ/scripting.typ
@@ -0,0 +1,162 @@
+// Scripting pardes over 9P: finding the session, a first tag word, the
+// recipes, and the traps. Every file's full semantics are in the
+// reference.
+#import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs
+
+Every session is a virtual filesystem, served over 9P and modelled on
+acme's (#doc("reference", section: "from-acme")), so a program that opens
+files is an extension:
+
+```
+$ ls $m
+README col commands ctl exec focus index layout listeners log
+look os pager pane recent screen status tag tagexec
+$ cat $m/index
+1 term 0 /home/me/src 1
+2 text 0 /home/me/src/+New 1
+```
+
+The reference (#doc("fs")) has every file.
+
+= Finding the session <find-the-session>
+
+#pairs(
+ [`PARDES_9P`], [the session's socket, in every shell and command pane],
+ [`PARDES_PANE`], [the serial of the pane the shell runs in],
+ [`$winid`], [the serial of the pane a command was clicked in, as in acme (unset from a column's or the workspace's tag)],
+ [`PARDES_MOUNT`], [the session as a directory, under `9ns --mntgen` (#doc("setup", section: "ninens"))],
+)
+
+Every recipe here starts from this line:
+#cmd("m=${PARDES_MOUNT:-}\ncat \"$m/index\"")
+When it is empty (no mount), plan9port's `9p` talks to the socket instead:
+`cat $m/x` is `9p -a "unix!$PARDES_9P" read x`, and `echo y > $m/x` is
+`echo y | 9p -a "unix!$PARDES_9P" write x`.
+
+= Your first tag word <first-tag-word>
+
+A script on `PATH` is a word you can click. This `Fmt` finds its pane
+through `$winid` (`PARDES_PANE` is the command pane it runs in):
+
+```sh
+#!/bin/sh
+# Fmt: gofmt the Go file whose tag it was clicked in, then reload it
+n=${winid:?Fmt: click me in a pane tag}
+m=${PARDES_MOUNT:-}
+if [ -n "$m" ]; then
+ rd() { cat "$m/$1"; }; wr() { cat > "$m/$1"; }
+else
+ rd() { 9p -a "unix!$PARDES_9P" read "$1"; }
+ wr() { 9p -a "unix!$PARDES_9P" write "$1"; }
+fi
+f=$(rd pane/$n/name) # the file it shows
+case $f in *.go) ;; *) echo "Fmt: $f is not Go" >&2; exit 1 ;; esac
+echo Save | wr pane/$n/ctl && gofmt -w "$f" && echo get | wr pane/$n/ctl # get: reload
+```
+
+Type `Fmt` into a Go pane's tag and #word("Exec") it (middle-click: run
+the builtin a word names, or else run it as a shell line); its output
+shows in a command pane. To have `Fmt` in every Go file's tag, follow the
+log and add it to each new `.go` pane (with a mount):
+
+```sh
+#!/bin/sh
+# fmt-tags: put Fmt in the tag of every Go file opened from now on
+m=${PARDES_MOUNT:?fmt-tags: needs 9ns --mntgen}
+exec 3<>$m/log; echo 'follow new' >&3
+while read -r what serial name <&3; do
+ case $what:$name in new:*.go) printf ' Fmt' >> $m/pane/$serial/tag ;; esac
+done
+```
+
+= Recipes
+
+Each recipe starts after the session line above and this one, which makes
+a pane of your own: reading #file("pane/new") makes a pane and answers its
+serial, and `rmdir $p` closes it. Work through that pane's #file("look")
+and #file("exec"), not the root's:
+#cmd("n=$(cat $m/pane/new); p=$m/pane/$n")
+
+#pairs(
+ [look around], [#cmd("cat $m/index\ncat $m/layout\ncat $m/focus\ncat $m/commands")],
+ [open a file at a place], [#cmd("exec 3<>$p/look; echo \"$PWD/main.zig:120\" >&3; f=$(cat <&3); exec 3<&- # its pane\necho \"$PWD/main.zig:0/fn main/\" > $p/look # the first match")],
+ [fill, name, save, close], [#cmd("printf 'hello\\n' > $p/body # > replaces, >> appends\necho \"$PWD/notes.txt\" > $p/name\necho Save > $p/ctl\nrmdir $p")],
+ [say something], [#cmd("echo 'Msg hello' > $p/exec")],
+ [replace everywhere], [#cmd("echo 'Edit ,x/foo/c/bar/' > $p/ctl\ngrep -c foo $p/body # 0: none left")],
+ [insert after a match], [#cmd("echo 'Edit /old/a/ text/' > $p/ctl # from dot; one undo step")],
+ [replace one match], [#cmd("echo /old/ > $p/addr && printf new > $p/data")],
+ [delete line 3], [#cmd("echo 3 > $p/addr; : > $p/data")],
+ [select line 3, read it], [#cmd("echo 3 > $p/addr; cp $p/addr $p/dot; cat $p/sel")],
+ [run a command], [#cmd("exec 3<>$p/exec; echo \"cd '$PWD' && make test\" >&3; c=$(cat <&3) # its pane\nuntil grep -q ') exit ' $m/pane/$c/tag; do sleep 0.2; done\ncat $m/pane/$c/body; exec 3<&- # read it before letting go")],
+ [run at a prompt], [#cmd("t=$(awk '$2==\"term\"{print $1; exit}' $m/index)\nexec 3<>$m/pane/$t/pty/run; echo ls >&3; cat <&3; exec 3<&-")],
+ [type, interrupt], [#cmd("t=$(awk '$2==\"term\"{print $1; exit}' $m/index)\nprintf 'q' > $m/pane/$t/pty/data # \\r Enter, \\x03 Ctrl-C\necho 'sig INT' > $m/pane/$t/pty/ctl")],
+ [ask the language server], [#cmd("exec 3<>$p/look; echo \"$PWD/main.zig\" >&3; q=$m/pane/$(cat <&3); exec 3<&-\necho /myFunc/ > $q/addr; echo dot=addr > $q/ctl\necho Hover > $q/exec # also Rename new, Symbols")],
+ [follow what happens], [#cmd("exec 3<>$m/log; echo 'follow new' >&3\ntimeout 30 cat <&3; exec 3<&-")],
+)
+
+A command pane your #file("exec") open was answered is yours while that
+open stays open: read its #file("body") before you close it. In
+#file("index") a `term` is a shell, a `cmd` a command's pane.
+
+== Event helpers
+
+Holding a pane's #file("event") open takes its #word("Exec") and #word("Look") clicks (right-click: open what
+the text names, or else find it): they arrive as acme's records instead of acting, and writing a
+record back has pardes do it. A record is a line, `MX31 36 1 5 Upper`: who
+(`M` mouse, `K` keyboard, `E` or `F` a write to a file), what (`X` #word("Exec") or `L` #word("Look")
+in the body, `x` `l` in the tag), the range, a flag, the text's length and
+the text (#doc("fs", section: "event")). This helper owns the tag words
+`Upper` and `Done` in pane `$1` and writes every other click back:
+
+```bash
+#!/bin/bash
+# upper PANE: own the tag words Upper and Done in pane PANE
+m=${PARDES_MOUNT:?upper: needs 9ns --mntgen}; p=$m/pane/$1
+grep -q ' Upper Done' $p/tag || printf ' Upper Done' >> $p/tag
+exec 3<>$p/event # hold event on fd 3, this shell's own
+while IFS= read -r rec <&3; do
+ read -r head q1 flag n text <<< "$rec" # e.g. Mx31 36 1 5 Upper
+ case $head$text in
+ [EFKM][Xx]*Upper) sel=$(cat $p/sel; echo x); sel=${sel%x}; printf %s "${sel^^}" > $p/sel ;;
+ [EFKM][Xx]*Done) break ;;
+ [EFKM][XxLl]*) printf '%s\n' "$rec" >&3 ;; # not ours: do what it would
+ esac # I D i d report edits: nothing to do
+done
+exec 3<&- # let event go: clicks act again
+```
+
+= Traps <traps>
+
+- A refused write says only `Invalid argument` or `Input/output error`;
+ its reason is `grep '^err' $m/log | tail -1`, not the log's last line,
+ which after a refused #word("Del") may be `+Unsaved`'s `new`. A write that
+ succeeds adds no record, so check its status first.
+- The root #file("look") and #file("exec") act at the pane with the
+ keyboard, which another client, an idle shell or an event helper may
+ own. Use a pane's own.
+- Read #file("look"), #file("exec") or #file("pager") on the open you
+ wrote (`exec 3<>…`): a fresh open reads the session's last answer, from
+ whichever client wrote it.
+- #file("addr") is the pane's and moves on: each `/re/` searches from the
+ last address, and a #file("data") write leaves it past the text. Write
+ #file("addr") before each replacement; a failed one leaves none.
+- An #word("Edit") `x` that matches nothing succeeds: check the text.
+- Through a mount, `printf 'a\nb\n' > ctl` arrives one write per line:
+ send a block as one write, ending in a newline.
+- Read #file("event") on a descriptor your shell owns, never
+ `cat $p/event | while read`: the `cat` outlives the loop, holds
+ #file("event") and swallows the next click.
+- `head` through 9ns says `Illegal seek` on #file("index"),
+ #file("layout"), #file("log") and #file("recent"): use `sed -n 1p`.
+
+= An isolated session
+
+Never experiment on a session someone is using. Under `9ns --mntgen`,
+start one with an empty environment and home, and quit it when done:
+
+```
+env -i PATH="$PATH" HOME="$(mktemp -d)" XDG_RUNTIME_DIR="$XDG_RUNTIME_DIR" pardes --detach=try &
+m=$NINE_MOUNT/pardes/try
+cat $m/index
+echo Exit > $m/exec
+```
diff --git a/docs/typ/setup.typ b/docs/typ/setup.typ
new file mode 100644
index 00000000..f49c9075
--- /dev/null
+++ b/docs/typ/setup.typ
@@ -0,0 +1,136 @@
+// Setting up your environment: what to put outside pardes (the shell's
+// startup files, a desktop launcher, other programs' configs) so that it
+// works best. Each snippet says in one line why it is there.
+#import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs
+
+= Install <install>
+#include "install.typ"
+
+= A 9P mount: 9ns <ninens>
+
+`9ns`, from cloud9 (`git.sr.ht/~gbrls/cloud9`, whose `zig build` builds it
+on Linux; it needs `/dev/fuse`), mounts 9P trees through FUSE as a plain
+user. With `--mntgen` it mounts every posted session at `/mnt/9p` and
+exports `$NINE_MOUNT`; a pardes session is `$NINE_MOUNT/pardes/<pid or
+name>`. Run pardes inside one, and everything it starts sees the session's
+virtual filesystem as files:
+
+#cmd("9ns --mntgen -- pardes-gui")
+
+A desktop launcher that still starts pardes without 9ns or `/dev/fuse`
+(absolute paths: the `Exec=` line takes a `$` only escaped, and a desktop `PATH` may
+lack `~/.local/bin`):
+
+```
+[Desktop Entry]
+Type=Application
+Name=pardes
+Exec=/bin/sh -c "if [ -x /home/me/.local/bin/9ns ] && [ -e /dev/fuse ]; then exec /home/me/.local/bin/9ns --mntgen -- /home/me/.local/bin/pardes-gui; else exec /home/me/.local/bin/pardes-gui; fi"
+Terminal=false
+```
+
+Or let every interactive shell wrap itself, once. fish, in `config.fish`:
+
+```
+if status is-interactive; and not set -q NINE_MOUNT
+ and test -e /dev/fuse; and type -q 9ns
+ exec 9ns --mntgen -- fish
+end
+```
+
+bash, in `~/.bashrc`:
+
+```
+if [[ $- == *i* && -z $NINE_MOUNT && -e /dev/fuse ]] && command -v 9ns >/dev/null; then
+ exec 9ns --mntgen -- bash
+fi
+```
+
+= pardes as your editor <editor-setup>
+
+`pardes --wait FILE` opens FILE as a pane and returns when you close it
+(outside pardes, it starts an editor that returns when you are done):
+
+#cmd("set -gx VISUAL 'pardes --wait'; set -gx EDITOR 'pardes --wait' # fish")
+#cmd("export VISUAL='pardes --wait' EDITOR='pardes --wait' # bash, zsh")
+
+`git commit`, `crontab -e` and fish's `edit_command_buffer` (Alt-E) read
+`VISUAL` before `EDITOR`, so set both.
+
+= A pager <pager>
+
+#cmd("ls --color=always | pardes - # into a new +Pager there, colours kept")
+
+With #word("Pager") `pardes` (the default) a terminal's shell gets
+`PAGER`, `GIT_PAGER` and `SYSTEMD_PAGER` set to it (and
+`SYSTEMD_PAGERSECURE=0`) wherever your environment leaves them unset, so
+`git log`, `journalctl` and `man` arrive as a pane, a diff drawn as one;
+command panes page through `cat`. `man` reads `MANPAGER` first, which
+pardes never sets. #word("Pager") `off` in the startup file leaves them all
+yours, for terminals started after it; #word("PagerColor") `off` makes the
+text plain.
+
+= yazi in a terminal pane <yazi>
+
+In `~/.config/yazi/yazi.toml` (yazi 26), an opener that forwards files to
+the session as panes:
+
+```
+[opener]
+pardes = [
+ { run = 'pardes %s', desc = "Open in pardes", for = "unix" },
+]
+
+[open]
+prepend_rules = [
+ { mime = "text/*", use = "pardes" },
+]
+```
+
+yazi's own `edit` opener runs `$EDITOR` and waits, so `EDITOR='pardes
+--wait'` already opens a pane there. Without a file manager, #btn("B3") on
+a path does the same.
+
+= Shells and PATH <shells>
+
+pardes injects OSC 133 prompt marks into bash and fish (after your own
+`~/.bashrc` and `config.fish`); they make #key("Esc") at an empty prompt
+and #file("pty/run") work. Other shells, or `exec zsh` inside a bash pane,
+get none: #file("pty/run") answers `error no prompt marks`. Terminals and
+command panes inherit pardes's environment, its `PATH` included, so a
+script on that `PATH` is a word you can click.
+
+= Language servers <language-servers>
+
+pardes starts a language server for a file it knows, from `PATH`:
+
+#pairs(
+ [`.zig`], [`zls` (`PARDES_LSP_ZIG`)],
+ [`.rs`], [`rust-analyzer` (`PARDES_LSP_RS`)],
+ [`.c .h .cc .cpp .hpp .cxx .hxx`], [`clangd` (`PARDES_LSP_C`)],
+ [`.go`], [`gopls` (`PARDES_LSP_GO`)],
+ [`.ts .tsx .js .jsx .mjs .cjs`], [`typescript-language-server --stdio` (`PARDES_LSP_TS`)],
+ [`.py`], [`pyright-langserver --stdio` (`PARDES_LSP_PY`)],
+)
+
+#cmd("PARDES_LSP_ZIG=$HOME/src/zls/zig-out/bin/zls pardes # another zls\nPARDES_LSP_PY= pardes # none for .py")
+
+#word("Lspinfo") (#key("SPC l i")) says what is running.
+
+= Fonts and themes <fonts-and-themes>
+
+The terminal build uses your terminal's font. The SDL window carries
+Adwaita Mono and finds others in `/usr/share/fonts`,
+`/usr/local/share/fonts`, `~/.local/share/fonts` and `~/.fonts`; #word("Font")
+`Iosevka:16` picks one. #word("Theme") `<name>` and #word("ThemeFile") are in the themes
+chapter (#doc("themes")).
+
+= plan9port <plan9port>
+
+Without a mount, plan9port's `9p` reads and writes a session:
+
+#cmd("9p -a \"unix!$PARDES_9P\" read index")
+
+acme habits carry over: `pardes FILE` is acme's `B`, `pardes --wait` its
+`E`, the files have acme's names, and a program holding a pane's
+#file("event") takes its clicks, as `win` does.
diff --git a/docs/typ/style.typ b/docs/typ/style.typ
new file mode 100644
index 00000000..b5c2ff85
--- /dev/null
+++ b/docs/typ/style.typ
@@ -0,0 +1,614 @@
+// The semantic elements every docs/typ topic uses, and the one place they
+// are defined. Content files call them ("this is a key", "this is a
+// builtin"); how each looks is decided here, per output: paged outputs
+// (the A4 cheatsheet, later the book) draw them, HTML export gives them
+// elements and classes for a stylesheet. Page geometry and fonts belong to
+// the output wrappers beside this file.
+
+/// The `atelier` theme (src/themes/atelier.zig): pardes's acme homage,
+/// butter paper and blue-green tags.
+#let palette = (
+ paper: rgb("#fffdeb"),
+ ink: rgb("#293f35"),
+ tag-bg: rgb("#e4f0ed"),
+ tag-fg: rgb("#3d6055"),
+ tag-name: rgb("#6e4774"),
+ grip: rgb("#36826b"),
+ col-grip: rgb("#955815"),
+ str: rgb("#34743d"),
+ num: rgb("#9a5810"),
+ rule: rgb("#95baa2"),
+ mouse: rgb("#8a3a00"),
+)
+#let mono = "DejaVu Sans Mono"
+
+/// Topic ids for #doc: each names a chapter (an id in `chapters`) and,
+/// optionally, the label of a section in it. Old ids stay so older calls
+/// keep working.
+#let topics = (
+ guide: ("guide", none),
+ setup: ("setup", none),
+ cheatsheet: ("cheatsheet", none),
+ scripting: ("scripting", none),
+ reference: ("reference", none),
+ themes: ("themes", none),
+ building: ("building", none),
+ builtins: ("builtins", none),
+ tags: ("guide", none),
+ fs: ("reference", none),
+ config: ("guide", "config"),
+ keys: ("guide", "keys"),
+ detached: ("guide", "sessions"),
+)
+
+/// Set by a wrapper that holds every chapter (the book, the HTML): #doc
+/// then links to the chapter or section. Alone (the A4 sheet) it names it.
+#let doc-links = state("doc-links", false)
+
+/// The book's and the HTML's reading order. `file` is the content file
+/// in docs/typ, or none while the topic is not written yet (the outputs
+/// then show a placeholder). Wrappers include each with heading offset 1,
+/// so a file's `=` headings sit under its chapter title, labelled
+/// `ch-<id>`.
+#let chapters = (
+ (id: "guide", title: "Guide", file: "guide.typ"),
+ (id: "setup", title: "Setting up your environment", file: "setup.typ"),
+ (id: "cheatsheet", title: "Cheatsheet", file: "cheatsheet.typ"),
+ (id: "scripting", title: "Scripting", file: "scripting.typ"),
+ (id: "reference", title: "Reference", file: "reference.typ"),
+ (id: "builtins", title: "Builtins", file: "builtins.typ"),
+ (id: "themes", title: "Themes", file: "themes.typ"),
+ (id: "building", title: "Building, for contributors", file: "building.typ"),
+)
+
+/// The one-line pitch: the A4 sheet's header and the book's title page.
+#let tagline = "acme's tags and three buttons, helix's keys, terminals as panes, the editor as a virtual filesystem over 9P"
+
+/// The tutor, shown as it is in the editor (`Tutor`), from the repo root.
+#let tutor-path = "/src/tutor.txt"
+
+/// How much room tables and shell lines get: "roomy" (the book, the HTML)
+/// or "tight" (the A4 sheet sets it).
+#let density = state("density", "roomy")
+
+#let html-out() = target() == "html"
+#let span(class, body) = html.elem("span", attrs: (class: class), body)
+#let m(s, fill: palette.ink) = text(font: mono, size: 0.92em, fill: fill, s)
+
+/// A key: one press (`x`, `Ctrl-w`, `Shift-Esc`), or a sequence pressed one
+/// after another, written space-separated (`g g`, `SPC f c`). Either is ONE
+/// pill: a combination's parts joined by a muted +, a sequence's steps by a
+/// muted › (`Ctrl-w h` reads Ctrl + w › h).
+#let key(k) = context if html-out() {
+ let sep(c, cls) = html.elem("span", attrs: (class: cls, "aria-hidden": "true"), c)
+ let press(t) = (if t.len() > 1 and t.contains("-") { t.split("-") } else { (t,) }).join(sep("+", "plus"))
+ html.elem("kbd", attrs: (class: "key"), k.split(" ").map(press).join(sep("›", "then")))
+} else {
+ let muted(c) = text(fill: palette.grip.transparentize(25%), size: 0.85em, c)
+ let press(t) = (if t.len() > 1 and t.contains("-") { t.split("-") } else { (t,) }).join(muted[+])
+ box(
+ fill: palette.grip.transparentize(84%), radius: 2pt,
+ inset: (x: 1.4pt, y: 0pt), outset: (y: 1.5pt),
+ text(font: mono, size: 0.92em, fill: palette.ink,
+ k.split(" ").map(press).join(muted[#h(1pt)›#h(1pt)])),
+ )
+}
+
+/// Alternatives: separate keys listed together, each its own command.
+#let keys(..ks) = context ks.pos().map(key).join(if html-out() [ ] else { h(0.25em) })
+
+#let button-names = ("B1": "left button", "B2": "wheel", "B3": "right button")
+#let click-names = ("B1": "left", "B2": "middle", "B3": "right")
+/// Text that is read and copied but not shown, beside a drawn glyph.
+#let hidden(t) = html.elem("span", attrs: (class: "vh"), t)
+
+/// A mouse, about cap height: left button, wheel, right button. The parts
+/// in `pressed` ("B1", "B2", "B3") are filled.
+#let mouse(pressed) = {
+ let (w, h, top) = (0.84em, 1.2em, 0.56em)
+ let ink = palette.mouse
+ let s = 0.7pt + ink
+ let on(b) = if b in pressed { ink } else { none }
+ box(width: w, height: h, baseline: 0.24em, {
+ place(rect(width: w / 2, height: top, radius: (top-left: w / 2), fill: on("B1"), stroke: s))
+ place(dx: w / 2, rect(width: w / 2, height: top, radius: (top-right: w / 2), fill: on("B3"), stroke: s))
+ place(dy: top, rect(width: w, height: h - top, radius: (bottom: w / 2), stroke: s))
+ // the wheel: a narrow tall slot over the buttons' seam, on a paper
+ // halo so a filled wheel stands apart from the button outlines
+ let (ww, wh, halo) = (0.26em, 0.44em, 0.07em)
+ let (wx, wy) = ((w - ww) / 2, 0.06em)
+ place(dx: wx - halo, dy: wy - halo / 2, rect(
+ width: ww + 2 * halo, height: wh + halo, radius: ww, fill: palette.paper))
+ place(dx: wx, dy: wy, rect(
+ width: ww, height: wh, radius: ww / 2, stroke: 0.5pt + ink,
+ fill: if "B2" in pressed { ink } else { palette.paper },
+ ))
+ })
+}
+
+/// The same mouse as inline SVG for HTML. Each part is classed `on`
+/// (pressed) or `off`, and the stylesheet colours them: the pressed part
+/// filled in the accent, the rest outlined and muted.
+#let mouse-svg(pressed) = {
+ let cls(b) = if b in pressed { "on" } else { "off" }
+ let part(d, b) = html.elem("path", attrs: (class: cls(b), d: d))
+ html.elem("svg", attrs: (class: "mouse", viewBox: "-6 -6 96 132", "aria-hidden": "true"), {
+ // taller buttons and a slimmer wheel than on paper, so a pressed
+ // button shows as a solid block at body size
+ part("M0 64H84V78A42 42 0 0 1 0 78Z", none)
+ part("M0 64V42A42 42 0 0 1 42 0V64Z", "B1")
+ part("M42 0A42 42 0 0 1 84 42V64H42Z", "B3")
+ // a pressed wheel is drawn wider, so it reads as pressed, not as a seam
+ let (hx, hw, wx, ww) = if "B2" in pressed { ("27", "30", "31", "22") } else { ("31", "22", "35", "14") }
+ html.elem("rect", attrs: (class: "halo", x: hx, y: "4", width: hw, height: "48", rx: "13"))
+ html.elem("rect", attrs: (class: "wheel " + cls("B2"), x: wx, y: "8", width: ww, height: "40", rx: "9"))
+ })
+}
+
+/// A mouse button; `shift: true` for the button with Shift held.
+#let btn(b, shift: false) = context if html-out() {
+ let label = (if shift { "shift " } else { "" }) + button-names.at(b)
+ html.elem("span", attrs: (class: "btn", title: label), {
+ if shift { html.elem("span", attrs: (class: "shift", "aria-hidden": "true"), "⇧") }
+ mouse-svg((b,))
+ hidden((if shift { "Shift-" } else { "" }) + click-names.at(b) + "-click")
+ })
+} else {
+ if shift { text(size: 0.8em, fill: palette.col-grip)[⇧] }
+ mouse((b,))
+}
+
+/// A chord: the first button held, each next one clicked while it is.
+/// Drawn as the held button, then for each click the held one and that one
+/// down, with arrows between.
+#let chord(..bs) = context if html-out() {
+ let label = bs.pos().map(b => button-names.at(b)).join(" then ")
+ let (held, ..clicks) = bs.pos()
+ let arrow = html.elem("span", attrs: (class: "then", "aria-hidden": "true"), "›")
+ let said = "hold " + click-names.at(held) + ", click " + clicks.map(c => click-names.at(c)).join(", then ")
+ html.elem("span", attrs: (class: "chord", title: label), {
+ ((mouse-svg((held,)),) + clicks.map(c => mouse-svg((held, c)))).join(arrow)
+ hidden(said)
+ })
+} else {
+ let (held, ..clicks) = bs.pos()
+ let arrow = text(size: 0.75em, fill: palette.col-grip)[#h(0.5pt)›#h(0.5pt)]
+ ((mouse((held,)),) + clicks.map(c => mouse((held, c)))).join(arrow)
+}
+
+/// A tag word or builtin, drawn as a thing to click: the tag's ground and
+/// ink in the tag's monospace, over a rule. Look and Exec take acme's look
+/// and exec sweep colours (green and red, src/themes/acme.zig) for the
+/// rule; every other word the tag's box colour. In HTML a <code
+/// class="word">, so a text browser still shows the plain word.
+#let word-accent = (Look: rgb("#006600"), Exec: rgb("#aa0000"))
+
+/// Every builtin of either build, written by `zig build builtins-json`
+/// from the registry and the Help rows (src/builtins_json.zig), a file per
+/// build: name, leader, also (Help's other shortcuts), arg, scope, setting,
+/// choices, doc. Merged here, each with `platforms`: "both", "tty" (the
+/// terminal only) or "gui" (the window only).
+#let builtin-data = {
+ let tty = json("builtins-tty.json")
+ let gui = json("builtins-gui.json")
+ let in-tty = tty.map(b => b.name)
+ let in-gui = gui.map(b => b.name)
+ let all = (tty + gui.filter(b => b.name not in in-tty)).sorted(key: b => b.name)
+ all.map(b => {
+ b.insert("platforms", if b.name in in-tty and b.name in in-gui { "both" } else if b.name in in-tty { "tty" } else { "gui" })
+ b
+ })
+}
+#let builtin-names = builtin-data.map(b => b.name)
+
+#let word-chip(w) = context if html-out() {
+ let base = w.split("+").first()
+ let kind = if base == "Look" { " look" } else if base == "Exec" { " exec" } else { "" }
+ html.elem("code", attrs: (class: "word" + kind), w)
+} else {
+ let rule = word-accent.at(w.split("+").first(), default: palette.grip)
+ box(
+ fill: palette.tag-bg, inset: (x: 1.4pt, y: 0pt), outset: (y: 1.4pt),
+ stroke: (bottom: 0.6pt + rule),
+ m(w, fill: palette.tag-fg),
+ )
+}
+
+/// A builtin's word links to its glossary entry wherever the glossary is
+/// part of the same output (the book, the site); elsewhere it is the chip.
+#let word(w) = context {
+ let base = w.split("+").first()
+ let target = label("builtin-" + base)
+ if doc-links.get() and base in builtin-names and query(target).len() > 0 {
+ link(target, word-chip(w))
+ } else { word-chip(w) }
+}
+
+/// A whole tagline: its grip, the path, then its words.
+#let tag(words, path: none) = context if html-out() {
+ html.elem("div", attrs: (class: "tag"), {
+ html.elem("span", attrs: (class: "grip", "aria-hidden": "true"))[]
+ if path != none { span("path", path); [ ] }
+ raw(words)
+ })
+} else {
+ block(width: 100%, fill: palette.tag-bg, inset: (x: 2pt, y: 2.4pt), spacing: 0.5em, {
+ box(fill: palette.grip, width: 0.55em, height: 0.75em, baseline: 0.1em)
+ h(3pt)
+ if path != none { m(path, fill: palette.tag-name); h(0.6em) }
+ m(words, fill: palette.tag-fg)
+ })
+}
+
+/// A look address.
+#let addr(a) = context if html-out() { span("addr", raw(a)) } else { m(a, fill: palette.tag-name) }
+
+/// A 9P path.
+#let file(p) = context if html-out() { span("file", raw(p)) } else { m(p, fill: palette.str) }
+
+/// A shell line.
+#let cmd(c) = context if html-out() { html.elem("div", attrs: (class: "cmd"), raw(c, block: true, lang: "sh")) } else {
+ let tight = density.get() == "tight"
+ block(
+ width: 100%, spacing: if tight { 0.4em } else { 0.9em },
+ inset: if tight { (left: 3pt, y: 1.2pt) } else { (left: 6pt, y: 3pt) },
+ stroke: (left: (if tight { 1pt } else { 1.5pt }) + palette.rule),
+ fill: if tight { none } else { palette.tag-bg.transparentize(50%) },
+ text(font: mono, size: 0.85em, fill: palette.ink, c),
+ )
+}
+
+/// Where the full story is: a topic id from `topics`, and a section label
+/// in it. A link where the wrapper holds the chapters, else its name.
+#let doc(id, section: none) = {
+ let (chapter, default) = topics.at(id)
+ let section = if section != none { section } else { default }
+ let title = chapters.find(c => c.id == chapter).title
+ let to = label(if section != none { section } else { "ch-" + chapter })
+ let named = title + if section != none { ": " + section.replace("-", " ") } else { "" }
+ context {
+ if doc-links.get() {
+ let found = query(to)
+ let shown = if found.len() > 0 and found.first().func() == heading {
+ if section != none [#title: #found.first().body] else [#title]
+ } else [#named]
+ link(to, text(fill: palette.num)[→ #shown])
+ } else {
+ text(fill: palette.num)[→ #named]
+ }
+ }
+}
+
+/// Pairs: a thing and what it means, as a two-column table, key column
+/// first, rows on alternating tints. `split: 2` sets the rows as that many
+/// tables side by side (on paper; HTML gets one table).
+#let pairs(split: 1, ..cells) = {
+ let rows = cells.pos().chunks(2)
+ context {
+ let tight = density.get() == "tight"
+ let one(rows) = table(
+ columns: (auto, 1fr), stroke: none,
+ inset: if tight { (x: 2pt, y: 1.6pt) } else { (x: 7pt, y: 4pt) },
+ fill: (_, y) => if calc.even(y) { palette.tag-bg.transparentize(35%) },
+ ..rows.flatten(),
+ )
+ if html-out() or split == 1 { one(rows) } else {
+ let n = calc.ceil(rows.len() / split)
+ grid(columns: (1fr,) * split, column-gutter: if tight { 2pt } else { 10pt }, ..rows.chunks(n).map(one))
+ }
+ }
+}
+
+/// Where pardes lives and under what licence: install.typ, the site's
+/// landing and its footer all read it. Every mirror holds the same tree;
+/// the first is the one the install line clones. A new mirror is one line.
+#let project = (
+ mirrors: (
+ (name: "sourcehut", web: "https://git.sr.ht/~gbrls/pardes", clone: "https://git.sr.ht/~gbrls/pardes"),
+ (name: "git.0x4200.cafe", web: "https://git.0x4200.cafe/pardes", clone: "https://git.0x4200.cafe/pardes.git"),
+ ),
+ license: "ISC",
+ changes: "https://git.sr.ht/~gbrls/pardes/tree/main/item/src/CHANGELOG.md",
+ // built binaries to download: the version they are, where the
+ // checksums are, and a file per program (install.typ shows them)
+ download: (
+ version: "0.23",
+ sums: "https://pub-66384ba880784f119ce95123b92fa5c6.r2.dev/SHA256SUMS",
+ files: (
+ (program: "pardes", what: "the terminal build, static, any x86_64 Linux",
+ url: "https://pub-66384ba880784f119ce95123b92fa5c6.r2.dev/pardes-x86_64-linux-static", bytes: 62223912,
+ sha256: "740992b18bdcfefc4db449dcbdb12423b4505eb2b3fb360aaa6dc57cc2fdda9f"),
+ (program: "pardes-gui", what: "the window, x86_64 Linux with glibc 2.29 or later; it loads Wayland or X11 and GL or Vulkan from the system",
+ url: "https://pub-66384ba880784f119ce95123b92fa5c6.r2.dev/pardes-gui-x86_64-linux", bytes: 66786824,
+ sha256: "a1c68b347d424b8077fb5af4050dd8455dc849adb0c1e2fc325b1646f5a255e5"),
+ ),
+ ),
+)
+
+/// A glossary: like #pairs, under its own heading. On paper the heading
+/// and the table; in HTML a <details> that starts closed, its summary the
+/// heading and the count, so a reader who knows the words skips them.
+#let glossary(title, lbl, ..cells) = context if html-out() {
+ // a real definition list, so a text browser reads term, then meaning
+ html.elem("details", attrs: (class: "glossary"), {
+ html.elem("summary", [#heading(title) #lbl])
+ html.elem("dl", for (term, meaning) in cells.pos().chunks(2) {
+ html.elem("dt", term)
+ html.elem("dd", meaning)
+ })
+ })
+} else {
+ [#heading(title) #lbl]
+ pairs(..cells)
+}
+
+/// Every theme as a picture, on the site's Themes page; nothing on paper,
+/// where forty-odd screenshots would only add weight. Reads
+/// docs/site/media/themes/themes.toml: `ready` (absent means true) and a
+/// [[theme]] per theme, in NextColor's order, with `name`, `file` (under
+/// media/themes/) and `kind` ("light" or "dark").
+#let theme-gallery() = context if html-out() {
+ let g = toml("../site/media/themes/themes.toml")
+ let ready = g.at("ready", default: true)
+ heading[Every theme]
+ html.elem("div", attrs: (class: "gallery"), for t in g.theme {
+ let src = "media/themes/" + t.file
+ html.elem("figure", attrs: (class: "shot " + t.kind), {
+ if ready {
+ html.elem("a", attrs: (href: src), html.elem("img", attrs: (src: src, alt: t.name + " (" + t.kind + ")", loading: "lazy")))
+ } else {
+ html.elem("div", attrs: (class: "pending"), "screenshot to come")
+ }
+ html.elem("figcaption", raw(t.name))
+ })
+ })
+}
+
+/// The newcomer's words, first in the glossary; every other builtin goes
+/// under its group below. Each must be in builtins.json.
+#let everyday = ("Look", "Exec", "Save", "Undo", "Redo", "New", "Newcol", "Del", "Delcol",
+ "Tty", "Kill", "Find", "Grep", "Recent", "Dump", "Restore", "Exit", "Help", "Tutor", "Themes", "Config")
+/// Debugging and developer words, last whatever their leader path.
+#let internals = ("Debug", "EffectCode", "Lspwhy", "Messages", "DumpConfig", "DumpThemes")
+
+/// The glossary's groups, in order: by the leader path's first key, the
+/// way Help groups them, then settings, the words with no path, internals.
+#let builtin-groups = (
+ (title: "Files", keys: ("f",)),
+ (title: "Panes and columns", keys: ("c", "d")),
+ (title: "Moving and jumps", keys: ("w", "j")),
+ (title: "Terminals", keys: ("n",)),
+ (title: "Language server", keys: ("l",)),
+ (title: "Sessions", keys: ("s", "q")),
+ (title: "Help", keys: ("h", "?")),
+ (title: "Clipboard", keys: ("y", "Y", "p", "P", "R")),
+ (title: "Toggles", keys: ("t",)),
+ (title: "Settings and themes", keys: "setting"),
+ (title: "Animations", keys: ("a",)),
+ (title: "Other words", keys: "none"),
+)
+
+#let group-of(b) = {
+ if b.name in internals { return "internals" }
+ if b.setting { return "setting" }
+ if b.leader == none { return "none" }
+ b.leader.split(" ").at(1)
+}
+
+/// Help spells a shortcut its own way (C-w left, right-click, topbar);
+/// this draws it as the docs do.
+#let shortcut(s) = {
+ if s == "topbar" { return [in the workspace tag] }
+ if s == "middle-click" { return btn("B2") }
+ if s == "right-click" { return btn("B3") }
+ if s == "left-click" { return btn("B1") }
+ let names = (enter: "Enter", tab: "Tab", escape: "Esc", left: "Left", right: "Right", up: "Up", down: "Down",
+ home: "Home", end: "End", backspace: "Backspace", delete: "Delete", page_up: "PgUp", page_down: "PgDn")
+ key(s.split(" ").map(t => {
+ let mods = ""
+ while t.len() > 2 and t.at(1) == "-" and t.at(0) in ("C", "A", "S") {
+ mods += (C: "Ctrl-", A: "Alt-", S: "Shift-").at(t.at(0))
+ t = t.slice(2)
+ }
+ mods + names.at(t, default: t)
+ }).join(" "))
+}
+
+/// A doc comment's text, its `code` spans set as code.
+#let prose(t) = t.split("`").enumerate().map(((i, part)) => if calc.odd(i) { raw(part) } else { part }).join()
+
+#let builtin-entry(b) = [
+ #heading(depth: 2, raw(b.name)) #label("builtin-" + b.name)
+ #let keys = (if b.leader != none { (key(b.leader),) } else { () }) + b.also.map(shortcut)
+ #if b.platforms != "both" [#emph(if b.platforms == "gui" [window only] else [terminal only]) · ]
+ #if keys.len() > 0 [#keys.join([, ]) · ]
+ #if b.choices != none [#raw(b.choices.replace(", ", "|")) · ] else if b.arg [takes an argument · ]
+ #prose(b.doc)
+]
+
+/// The glossary: everyday words first, then the groups, then internals,
+/// each alphabetical. A level-1 heading per group in the content file.
+#let builtin-glossary() = {
+ let by-name = (:)
+ for b in builtin-data { by-name.insert(b.name, b) }
+ [= Everyday <builtins-everyday>]
+ for n in everyday.sorted() { builtin-entry(by-name.at(n)) }
+ let rest = builtin-data.filter(b => b.name not in everyday)
+ for g in builtin-groups {
+ let members = rest.filter(b => {
+ let k = group-of(b)
+ if type(g.keys) == str { k == g.keys } else { k in g.keys }
+ })
+ if members.len() > 0 {
+ heading(depth: 1, g.title)
+ for b in members { builtin-entry(b) }
+ }
+ }
+ let inner = rest.filter(b => group-of(b) == "internals")
+ if inner.len() > 0 {
+ [= Debugging and internals]
+ for b in inner { builtin-entry(b) }
+ }
+ // a builtin no group took is a bug in builtin-groups, not a silent drop
+ let placed = everyday + rest.filter(b => {
+ let k = group-of(b)
+ k == "internals" or builtin-groups.any(g => if type(g.keys) == str { k == g.keys } else { k in g.keys })
+ }).map(b => b.name)
+ for b in builtin-data { assert(b.name in placed, message: "builtin " + b.name + " is in no glossary group") }
+ // last, every word at once, A to Z, each a link to its entry
+ [= All builtins, A–Z <builtins-a-z>]
+ context if html-out() {
+ html.elem("p", attrs: (class: "all-words"),
+ builtin-data.map(b => link(label("builtin-" + b.name), word-chip(b.name))).join(" "))
+ } else {
+ par(builtin-data.map(b => link(label("builtin-" + b.name), word-chip(b.name))).join(h(0.4em)))
+ }
+}
+
+/// A directory tree drawn as `tree` draws one. `spec` is a raw block, a
+/// line per file: two spaces of indent per level, the name (a directory
+/// ends in `/`), two or more spaces, a one-line description, and an
+/// optional `@label` naming the section that documents it, which becomes
+/// a link wherever that section is in the same output. A description may
+/// call #word, #key, #keys or #btn. src/config.zig's
+/// test reads the same block in reference.typ against the served tree.
+#let fstree(spec, root: "/") = {
+ // a description is text, unless it calls #word, #key or #btn
+ let said(d) = if d.contains("#") { eval(d, mode: "markup", scope: (word: word, key: key, keys: keys, btn: btn)) } else { d }
+ let rows = spec.text.split("\n").filter(l => l.trim() != "").map(l => {
+ let depth = calc.quo(l.len() - l.trim(at: start).len(), 2)
+ let m = l.trim().match(regex("^(\S+)(?:\s{2,}(.*?))?(?:\s+@([a-z0-9-]+))?$"))
+ (depth: depth, name: m.captures.at(0), desc: m.captures.at(1), anchor: m.captures.at(2))
+ })
+ // the connector for each row: is each ancestor, and the row itself, the
+ // last among its siblings?
+ let last(i) = {
+ let d = rows.at(i).depth
+ for j in range(i + 1, rows.len()) {
+ if rows.at(j).depth < d { return true }
+ if rows.at(j).depth == d { return false }
+ }
+ true
+ }
+ let lasts = range(rows.len()).map(last)
+ let prefix(i) = {
+ let d = rows.at(i).depth
+ let out = ""
+ // for each ancestor depth, the nearest row above at that depth
+ for k in range(d) {
+ let a = range(i).rev().find(j => rows.at(j).depth == k)
+ out += if lasts.at(a) { " " } else { "│ " }
+ }
+ out + if lasts.at(i) { "└── " } else { "├── " }
+ }
+ let named(r) = context {
+ let t = if r.anchor != none { label(r.anchor) } else { none }
+ if t != none and query(t).len() > 0 { link(t, r.name) } else { r.name }
+ }
+ let width = calc.max(..range(rows.len()).map(i => prefix(i).len() + rows.at(i).name.len()))
+ context if html-out() {
+ let nl = html.elem("span", attrs: (class: "nl"), "\n")
+ html.elem("pre", attrs: (class: "fstree", style: "--name:" + str(width + 2) + "ch"), {
+ html.elem("span", attrs: (class: "row root"), [#html.elem("span", attrs: (class: "name dir"), root)#nl])
+ for (i, r) in rows.enumerate() {
+ let pad = " " * (width - prefix(i).clusters().len() - r.name.len() + 2)
+ html.elem("span", attrs: (class: "row"), {
+ html.elem("span", attrs: (class: if r.name.ends-with("/") { "name dir" } else { "name" }),
+ [#html.elem("span", attrs: (class: "branch"), prefix(i))#named(r)#pad])
+ if r.desc != none {
+ html.elem("span", attrs: (class: "desc", style: "--cols:" + str(prefix(i).clusters().len())), said(r.desc))
+ }
+ nl
+ })
+ }
+ })
+ } else {
+ set text(font: mono, size: 0.82em)
+ block(width: 100%, grid(columns: (auto, 1fr), column-gutter: 1.2em, row-gutter: 0pt, inset: (y: 0.12em),
+ text(weight: "bold", fill: palette.grip, root), [],
+ ..rows.enumerate().map(((i, r)) => (
+ [#text(fill: palette.rule, prefix(i))#text(fill: if r.name.ends-with("/") { palette.grip } else { palette.ink },
+ weight: if r.name.ends-with("/") { "bold" } else { "regular" }, named(r))],
+ text(font: "Libertinus Serif", size: 1.2em, fill: palette.tag-fg, if r.desc == none { [] } else { said(r.desc) }),
+ )).flatten()))
+ }
+}
+
+/// A screenshot with numbered pins on it and their labels as text beside
+/// it, so the labels read, search and translate as text. `src` is from
+/// the repository root (the site serves it from the same path under
+/// docs/site/); `size` is its pixel (width, height); each pin is (label,
+/// x, y) in pixels of that image.
+#let annotated(src, size, alt: "", ..pins) = {
+ let (w, h) = size
+ let pins = pins.pos()
+ context if html-out() {
+ let web = src.trim("/docs/site/", at: start)
+ html.elem("figure", attrs: (class: "annotated"), {
+ html.elem("div", attrs: (class: "frame"), {
+ html.elem("img", attrs: (src: web, alt: alt, width: str(w), height: str(h)))
+ for (i, (label, x, y)) in pins.enumerate() {
+ html.elem("span", attrs: (class: "pin", "aria-hidden": "true",
+ // repr, not str: str writes a negative with U+2212, which CSS rejects
+ style: "left:" + repr(calc.round(100 * x / w, digits: 2)) + "%;top:" + repr(calc.round(100 * y / h, digits: 2)) + "%"), str(i + 1))
+ }
+ })
+ html.elem("ol", attrs: (class: "pins"), for (label, x, y) in pins { html.elem("li", label) })
+ })
+ } else {
+ let width = 11cm
+ let k = width / w
+ let pin(n) = box(width: 1.25em, height: 1.25em, radius: 50%, fill: palette.mouse,
+ align(center + horizon, text(size: 0.75em, weight: "bold", fill: white, str(n))))
+ block(breakable: false, grid(columns: (width, 1fr), column-gutter: 1.2em, align: horizon,
+ box(width: width, height: h * k, {
+ place(top + left, image(src, width: width, alt: alt))
+ for (i, (label, x, y)) in pins.enumerate() {
+ place(top + left, dx: x * k - 0.625em, dy: y * k - 0.625em, pin(i + 1))
+ }
+ }),
+ enum(..pins.map(p => p.at(0)), spacing: 0.7em),
+ ))
+ }
+}
+
+/// A pane's box as it looks: blank in normal mode, `^` in insert, `$` raw
+/// (a terminal's own input); `unsaved: true` fills it, as an unsaved
+/// file's is. In HTML a span the stylesheet draws, its mode said in words.
+#let mode-box(mark, unsaved: false) = {
+ let mode = if mark == "^" { "insert" } else if mark == "$" { "raw" } else { "normal" }
+ context if html-out() {
+ html.elem("span", attrs: (class: "mode-box" + if unsaved { " unsaved" } else { "" },
+ role: "img", "aria-label": mode + " mode box" + if unsaved { ", unsaved" } else { "" }), mark)
+ } else {
+ box(width: 1.05em, height: 1.05em, baseline: 0.15em, radius: 1pt,
+ fill: if unsaved { palette.col-grip } else { palette.tag-bg },
+ stroke: 0.7pt + palette.grip,
+ align(center + horizon, text(font: mono, size: 0.8em, weight: "bold",
+ fill: if unsaved { white } else { palette.ink }, mark)))
+ }
+}
+
+/// A recording from docs/site/media/clips.toml, by name. On the site the
+/// same video as the landing's (poster, autoplay muted loop, played while
+/// in view) and its caption; in print its poster, small, and the caption.
+/// `wide: true` lets it take the page's full width (a recording of many
+/// narrow columns).
+#let clip(name, wide: false) = {
+ let c = toml("../site/media/clips.toml").clip.find(c => c.name == name)
+ assert(c != none, message: "no clip named " + name + " in clips.toml")
+ let said = if c.caption.contains("#") { eval(c.caption, mode: "markup") } else { c.caption }
+ context if html-out() {
+ html.elem("figure", attrs: (class: "clip inline" + if wide { " wide" } else { "" }, id: "rec-" + c.name), {
+ html.elem("video", attrs: (poster: "media/" + c.name + ".png", autoplay: "", muted: "", loop: "",
+ playsinline: "", controls: ""), {
+ html.elem("source", attrs: (src: "media/" + c.name + ".webm", type: "video/webm"))
+ html.elem("source", attrs: (src: "media/" + c.name + ".mp4", type: "video/mp4"))
+ })
+ html.elem("figcaption", said)
+ })
+ } else {
+ figure(image("/docs/site/media/" + c.name + ".png", width: if wide { 11cm } else { 7cm }, alt: c.caption),
+ caption: text(size: 0.9em, said), numbering: none, kind: "clip", supplement: none)
+ }
+}
diff --git a/docs/typ/themes.typ b/docs/typ/themes.typ
new file mode 100644
index 00000000..edfaa7ad
--- /dev/null
+++ b/docs/typ/themes.typ
@@ -0,0 +1,127 @@
+// Themes: choosing one, the native palettes and the faithful ports, and
+// the roles a theme file sets.
+#import "style.typ": key, keys, btn, chord, word, tag, addr, file, cmd, doc, pairs, theme-gallery
+
+#word("Themes") (#key("SPC t t")) lists every theme as a word to click;
+#word("Theme") `<name>` sets one anywhere, and the same line in the startup file
+keeps it. #word("NextColor") steps through the themes in this order: the native themes first, then
+`acme`, `lapis` and `lapis_plain`, the faithful ports, the legacy `helix`
+and `dark`, and the palettes imported from helix and zed. `orchard` is the
+default. `lapis` draws its ornament in the GUI; `lapis_plain` is the same
+theme on flat grounds, keeping its framed and shadowed tags and its
+file-name shadow.
+
+#theme-gallery()
+
+= The native themes
+
+#pairs(
+ [`orchard`], [near-black evergreen; bright leaf comments and plum syntax],
+ [`dusk`], [soft plum charcoal; copper comments and gentle text],
+ [`ink`], [pure black; bright, distinct signals and ice-blue comments],
+ [`paper`], [neutral uncoated paper; graphite and teal],
+ [`daybreak`], [high-contrast light; white and deep blue ink],
+ [`atelier`], [acme homage; butter-yellow paper and blue-green tags],
+ [`forge`], [Dark Plus-inspired near-black, blue and peach; slate-blue tags],
+ [`lagoon`], [softer Material-inspired slate; vivid sea-glass comments],
+ [`solarium`], [softer Solarized-inspired blue-green; golden comments and teal tags],
+ [`spectrum`], [Monokai-inspired near-black and candy colours; golden comments],
+ [`harvest`], [autumn-inspired near-black earth, ember and leaf green],
+ [`clay`], [Gruvbox-inspired near-black and earthy brights; amber comments],
+ [`forge_black`], [pure-black Forge; luminous text and cool slate tags],
+ [`forge_soft`], [neutral-slate Forge; gentler text, still vivid blue comments],
+ [`orchard_black`], [pure-black Orchard; luminous garden ink and bright leaf comments],
+)
+
+The six classic-inspired ones (`forge` to `clay`) keep a recognisable
+syntax identity but are not exact ports; their sources are in
+`vendor/themes/`, and they claim no upstream affiliation. The focused
+pane's and column's tags shift tone on tone rather than invert: dark
+palettes keep dark tags, light ones light tags. The file name in a pane's
+path, and `+Search` and the like, take a distinct hue at the same
+brightness as the tag text; a terminal's tag tints its #word("Tty") word
+instead.
+
+Every native palette sets its own ANSI colours, so a terminal's indexed
+colours belong to it; #word("Filter") maps a program's true colours through
+the theme too. Normal text, syntax, comments, diagnostics and ANSI
+foregrounds keep a contrast of at least 4.5:1 against the page (7:1 in
+`ink` and `daybreak`), comments above 5:1; line numbers sit quieter,
+between 2.5:1 and 4:1. Tag, focused-tag, selection and search text are held
+to the same floors on their own grounds. ANSI black is exempt, since
+programs use it as a background. These are checks of the palettes, not a
+promise about a program's own escape sequences or the scene effects.
+#word("FocusTint") (on) and #word("SyntaxBold") (off) toggle the focused
+tag's tint and bold keywords.
+
+= Faithful ports
+
+Well-known themes taken as close to their originals as pardes can draw
+them: every colour the original has (page, text, selection, syntax, line
+numbers, diagnostics, terminal ANSI) is its own, read out of its files,
+and each theme file cites the file and line of every value. pardes has one
+colour each for keywords, strings, numbers and comments, so a theme that
+splits a kind keeps its main one. A pane's tag is the original's window
+bar (vim's `StatusLine`, emacs's `mode-line`) or, in a tabbed editor, its
+tab. Where a chrome colour misses one of pardes's floors (rules 1.5:1 off
+the page, the focused tag 1.5:1 off the unfocused one on a dark page and
+1.25:1 on a light one, tag text 4.5:1), only that colour moves, just far
+enough, and the file's header says so; text, syntax and ANSI never move.
+helix's own copy of a theme ported here is not imported, except the
+three other helix themes build on: `monokai_helix`, `ayu_dark_helix` and
+`nord_helix`.
+
+#pairs(
+ [Visual Studio Code], [`dark_plus`],
+ [Solarized], [`solarized_dark`, `solarized_light`],
+ [Dracula], [`dracula`, `dracula_soft`, `alucard`],
+ [Monokai], [`monokai`],
+ [Monokai Pro], [`monokai_pro`, `monokai_pro_classic`, `monokai_pro_machine`, `monokai_pro_octagon`, `monokai_pro_ristretto`, `monokai_pro_spectrum`, `monokai_pro_light`, `monokai_pro_light_sun`],
+ [Tokyo Night], [`tokyonight_night`, `tokyonight_storm`, `tokyonight_moon`, `tokyonight_day`],
+ [Rosé Pine], [`rose_pine`, `rose_pine_moon`, `rose_pine_dawn`],
+ [Catppuccin], [`catppuccin_latte`, `catppuccin_frappe`, `catppuccin_macchiato`, `catppuccin_mocha`],
+ [Seoul256], [`seoul256_dark_233` to `seoul256_dark_239`, `seoul256_light_252` to `seoul256_light_256`],
+ [Zenbones], [`zenbones_light`, `zenbones_dark`, `neobones_light`, `neobones_dark`, `vimbones`, `forestbones_light`, `forestbones_dark`, `nordbones`, `rosebones_light`, `rosebones_dark`, `tokyobones_light`, `tokyobones_dark`, `seoulbones_light`, `seoulbones_dark`, `duckbones`, `zenburned`, `zenwritten_light`, `zenwritten_dark`, `kanagawabones`],
+ [Nord], [`nord`],
+ [Ayu], [`ayu_dark`, `ayu_mirage`, `ayu_light`],
+ [Doom One], [`doom_one`, `doom_one_light`],
+)
+
+= Making your own <theme-files>
+
+#word("DumpThemes") writes every compiled theme to
+`<config dir>/themes/builtin/<name>.zon`. Copy one to `themes/mine.zon`,
+change its `.name`, and run #word("ThemeFile") `themes/mine.zon` (relative to the
+config directory). Where the host reloads files, saving it updates the
+theme at once; a malformed save keeps the last good version, and
+#word("Theme") `<name>` stops the watch. A #word("ThemeFile") that fails to load says why
+in words, a ZON error with its line (`line 3: expected ','`), and changes
+nothing: the theme shown stays, and #file("/ctl") and #word("DumpConfig")
+still name the file that last loaded, or none. #word("Restore") and
+`pardes -l` load a dump's #word("ThemeFile") again, as a #file("/ctl") write of it
+does, and one that fails there changes nothing either. The format is `pardes.Theme` as
+`std.zon.stringify` writes it, a complete theme with no inheritance.
+
+The required roles: nullable `bg` and `fg`, `sel_bg`, `sel_fg`, `tag_bg`,
+`tag_fg`, `box`, `box_dim`, `kw`, `str`, `num`, `comment`, `lineno`,
+`scroll_track`, `scroll_thumb`, and a nullable 16-entry `palette`. Each is
+an RGB triple (`.search_bg = .{ 0x57, 0x47, 0x2a }`). The optional roles
+take `null`, so older files stay valid:
+
+#pairs(
+ [`tag_active_bg`, `tag_active_fg`], [the focused pane's tag; a ground closer than 1.25:1 to `tag_bg` is pushed further the way it leans, as far as its text keeps its contrast. Absent: `tag_bg`, `tag_fg`],
+ [`tag_name_fg`, `tag_active_name_fg`], [the file name's or a terminal's #word("Tty") tint, in normal and focused tags. Absent: the tag's foreground],
+ [`column_box`, `column_box_dim`], [a column's grip held (and its drag rail), and at rest. Absent: `num`; a mix of `column_box` and `tag_bg`],
+ [`border`], [quiet separators, lifted to 1.6:1 when under 1.5:1 off the page. Absent: `scroll_track`],
+ [`empty_col`], [a column with no pane, under its tag (acme: white). Absent: `border`],
+ [`lineno_active`], [the current line number. Absent: `lineno`],
+ [`search_bg`, `search_fg`], [search matches, apart from the selection. Absent: `sel_bg`, `sel_fg`],
+ [`diagnostic_error`, `diagnostic_warning`, `diagnostic_info`, `diagnostic_hint`], [diagnostic text. Absent: `fg`, or `tag_fg` for an inherited foreground],
+ [`tag_sel_bg`], [a tag's selection ground. Absent: `sel_bg`],
+ [`sweep_bg`, `sweep_fg`], [three triples each: the select, #word("Exec") and #word("Look") sweeps. Absent: `sel_bg` tinted toward `kw`, `str` and `num`, in `sel_fg`],
+ [`tag_rule`], [the one-pixel rule between a pane's tag and its body. Absent: halfway between `tag_bg` and the page],
+ [`rule_px`], [pixel shells: the width of the rules between columns and panes and under the column and workspace tags, in logical pixels. Absent: 2],
+ [`box_border`, `box_dirty`], [the grip as acme's button: a ring of `box_border` when unfocused, filled with `box_dirty` while unsaved. Absent: `box_dim`; `diagnostic_warning`, then `num`],
+ [`rail_px`], [pixel shells: the scroll column's width at a 17px tagline, scaled with it. Absent: 12, acme's Scrollwid],
+ [`decor`], [pixel shells: a theme's ornament (lapis's): `page_dots`, `rail_checker`, `tag_border`, `tag_shadow`, `tag_stripe`, `title_shadow`, with their sizes; none of it touches a focus indicator. Absent: none],
+)