summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-06 11:38:06 -0300
committerGabriel Schneider <[email protected]>2026-11-06 12:03:00 -0300
commitf922f8b5db1f3b92d954c43860c32cd251d5bc55 (patch)
tree25f1dacb589db526060c2e4dd11b8cbcf5121123 /docs
parent0b4142e6704c851f395da2cd8b74954272dadf45 (diff)
downloadpardes-f922f8b5db1f3b92d954c43860c32cd251d5bc55.tar.gz
pardes-f922f8b5db1f3b92d954c43860c32cd251d5bc55.zip
kinds #20, their tests and docs: T1's sessions are a terminal without graphics, so a PDF's key test is the base's text-layer one again beside the strip's (Session.graphics gives a frontend pictures), /addons says 2.2; pane cases for the hand over a link and a touchpad's fraction; reference.typ and the changelog say what a PDF does with and without graphics and what 2.2 added
Co-Authored-By: Claude Fable 5.1 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'docs')
-rw-r--r--docs/typ/reference.typ16
1 files changed, 11 insertions, 5 deletions
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index 44b3bed9..abf2964f 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -987,11 +987,17 @@ TGA through stb_image, at most 1280 pixels a side), which the build
installs as `<prefix>/lib/pardes/addons/image.so`, and so are PDFs,
`addons/pdf/pdf.c` over MuPDF (its pages rendered on jobs, two at once),
installed as `<prefix>/lib/pardes/addons/pdf.so` (none with
-`-Dmupdf=false`); without them an image file and a PDF open as text. The
-header is ABI 2.1: an addon built against another major is refused, and
-one of 2.0 runs as it did (2.1 added at the ends of its records: `heap`,
-`view`, `exec` and `select` in its `pa_api`, the rail's thumb in
-`pa_paint`, its own `search`).
+`-Dmupdf=false`); without them an image file and a PDF open as text. A
+PDF on a terminal without graphics shows its page's text layer, the moving
+keys and the wheel a page a step; with them its pages, a fast scroll
+rendering only the rows each page shows until it rests, a touchpad's turn
+moving it by its fraction of a row, and the pointer a hand over a link.
+The header is ABI 2.2: an addon built against another major is refused,
+and an older one runs as it did (2.1 added at the ends of its records:
+`heap`, `view`, `exec` and `select` in its `pa_api`, the rail's thumb in
+`pa_paint`, its own `search`; 2.2 the core's ABI in `pa_api`, a wheel's
+`amount` in `pa_mouse`, `glyphs` in `pa_view`, the `pointer` in
+`pa_paint` and PA_FRAMED in tick's flags).
- `tick(state, now, flags)` returns the absolute time of its next step
(0: none) on a monotonic clock. It is called when that time comes and