diff options
Diffstat (limited to 'docs/typ/reference.typ')
| -rw-r--r-- | docs/typ/reference.typ | 12 |
1 files changed, 8 insertions, 4 deletions
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ index be157082..7af819a1 100644 --- a/docs/typ/reference.typ +++ b/docs/typ/reference.typ @@ -980,8 +980,11 @@ are the header's, and what pardes does for it (an allocation from the pane's arena, a job off the loop, a Look, a message, a new text pane) it is handed at load. `addons/fake/fake.c` uses every function and `addons/snake/snake.c` is a game in it; a kind with only a head and `paint` -is a valid one. Image is a kind compiled in, through the same records. The -header is ABI 2: an addon built against another major is refused. +is a valid one. Pictures are an addon too, `addons/image/image.c` (PNG, +JPEG, GIF, BMP, PPM, PGM and TGA through stb_image, at most 1280 pixels a +side), which the build installs as `<prefix>/lib/pardes/addons/image.so`; +without it an image file opens as text. The header is ABI 2: an addon +built against another major is refused. - `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 @@ -996,7 +999,8 @@ header is ABI 2: an addon built against another major is refused. `petscii:on palette:commodore ascii:off` (#word("Petscii"), #word("Palette") and #word("Ascii") are the core's words), then its path. -- Its jobs run on the host's workers; one asked before an +- Its jobs run on the host's workers, allocating from what the job is + handed (the last allocation the answer); one asked before an #word("Addon") `reload` answers into nothing, and the old library stays until its last such job has answered. - A client of the session runs no addon's code: a pane of a kind it lacks @@ -1010,7 +1014,7 @@ header is ABI 2: an addon built against another major is refused. the kinds here. At start, every `*.so` of `$XDG_DATA_HOME/pardes/addons`, then of `<prefix>/lib/pardes/addons`, is loaded. - #file("/addons"): a line a kind, `<kind> <version> <abi> <panes open> - <path> <blake3> static|loaded`, and a line an addon refused, with why: + <path> <blake3> loaded`, and a line an addon refused, with why: another ABI's major, no `pardes_addon`, a word, leader path or extension already someone's (the core's or another addon's: refused whole), words for its panes with no `ctl`. Each session has its own: a library is |
