The Terse manual
This manual describes the whole Terse system: the machine, its devices, the network that carries articles and programs, and the programs that come with it. It is written as Terse articles, so you can read it in the reader, follow its links with Tab and Enter, and publish it to a feed. Each article below says what it covers.
Start here
- What Terse is: what Terse is for, in one paragraph.
- How Terse works: the technical details in three pages: sharing articles and programs, the network, the machine and its frame budget, the devices, determinism and the shell.
- Writing a program: the toolchain, the C library, building, running a program headless and in the host, and publishing it in a feed.
- Using the shell and the reader: the keys of the shell and the reader, layouts, sessions and the consent prompts.
- Writing an article: the article format, every construct shown as source and as it is shown.
- State, replay and conformance: what a machine's state is, its hash, snapshots and the conformance image.
The machine
- The machine: the CPU, the memory map, reset, frames and the budget, faults, the image format, the call convention and the whole call table.
- Events and input: every event, the queue, keys, text, the pointer, the wheel and controllers.
- Charges and limits: every charge and every numeric limit on one page.
The devices
| Slot | Device | Article |
|---|---|---|
| 1 | System | The system device |
| 2 | Terminal | The terminal |
| 3 | 2D vector display | The 2D vector display |
| 4 | Content | Blobs, requests and statuses |
| 4 | Content | Feeds, names, search and publishing |
| 4 | Content | Named records |
| 6 | Sound | The sound device |
| 7 | Page | The page |
| 7 | Page | Figures on the page |
| 8 | Machines | The Machines device |
| 8 | Machines | Screens, panels and input |
| 9 | 3D vector display | The 3D vector display |
- The system device: frames, events, time, random bytes, controllers, exit, and asking the shell to open something.
- The terminal: an 80 by 30 grid of character cells.
- The 2D vector display: lines and filled shapes from a display list, in a clean or a phosphor style.
- Content: blobs fetched and published by hash, the feeds the host follows, search, and named records kept on the host.
- Sound: a 16-voice wavetable synthesizer, with pairing, feedback, ring modulation, noise and samples; optional, and bit-exact.
- The page: typeset proportional text, figures and tables in a rectangle of the screen.
- Machines: the shell's device, which starts other machines and lays out their screens, flat or as panels in its 3D scene.
- The 3D vector display: lines, points and circles in a box behind and in front of the screen, seen from an eye the host chooses.
The network
- The network: blobs and relays, feeds and entries, profiles, names and search, programs, and relays that mirror each other.
- Writing a reader without the machine: what a native reader must do to be a complete Terse client, with only the network and the article format.