Commit graph

12 commits

Author SHA256 Message Date
684745d6c0 Pages and tour entries for the modules that had none
Reference pages for (std uuid), (std scan), (std priority-queue),
(std crypto hash) and (text encodings), and entries for them in the
tour of the standard library, with (text xml), (text json-codec) and
(text bjodat-core). The text/json entry links to its page instead of
prelude.org.

🤖 Generated with [ECA](https://eca.dev)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-22 07:59:36 +02:00
15bfc18167 Native executables, std/array and std/simd
"Projects and packages" gets a section on Native AOT: (aot #t), where the
executable goes, what it gives and costs, and (aot-cpu ...) for the CPU it
is built for. The standard library chapter gets std/array and std/simd
after std/maths, and "Performance" a section on vectors: the kernels first,
a loop with its tail, masks, and when vectors pay, with the measurements
from the Advent of Code solutions. modules/std/array.sz and
modules/std/simd.sz are the reference pages, generated from the modules'
docs.

🤖 Generated with [ECA](https://eca.dev) (anthropic/claude-opus-4-7)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-18 17:16:42 +02:00
40f4783fa5 std/url: URLs read, written, resolved and percent-encoded
The standard library chapter gets std/url after std/http: the quoted
literal that encodes each value for its part, parse-url's strict reading,
the round trip, url-resolve, the decoded parts and the encoders.
modules/std/url.sz is the reference page, generated from (std url)'s docs.

🤖 Generated with [ECA](https://eca.dev) (anthropic/claude-opus-4-7)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-17 12:39:22 +02:00
f8cb9d3459 Benchmarking: (std bench) and bjo bench, with the card game
A new section 2.9 between Testing and Performance: time-it, a benchmark file
for the deck, how a benchmark is measured, setup and parameters, the menu,
--detail and --scaling, --compare-within, saving and comparing, --against
with --processes, the flags, and --serve. Every output is from a real run.
It shows the weakness of comparing two processes too: unchanged benchmarks
called faster or SLOWER by a few percent, and how --processes 6 settles it.

The standard library chapter gets std/bench, std/stopwatch says time-it is
(std bench)'s, and modules/std/bench/ has the reference pages for (std
bench), (std bench stats) and (std bench store).

🤖 Generated with [ECA](https://eca.dev) (anthropic/claude-opus-4-7)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-16 19:42:23 +02:00
3dc1518638 std: folders sorted in among the modules, without a slash
(std stm), (std test) and (std mutable) are listed where their titles
put them, with (folders mixed) and (folder-marker? #f) from glasnost
0.3.12. The mutable folder is titled (std mutable), as the others are,
so that it sorts among them.

🤖 Generated with [ECA](https://eca.dev)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-15 14:55:46 +02:00
11d435803c Modules: a module with submodules is its folder's page
(std test) and (std stm) were pages next to folders of their submodules, and
the std menu lists folders first, so each showed up twice, far apart. The
module page is now the folder's index.sz, so the menu has one entry for it,
and its submodules are listed at the top of the page and in the menu below.

(std test prop), (std test gen) and (std test expect) get pages, and the
standard library chapter says what they have and links to them.

🤖 Generated with [ECA](https://eca.dev)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-14 22:56:25 +02:00
fb90f971b4 Reference pages for the rest of std, and Part III sections on them
Pages for (std eq), (std clr-ord), (std monad), (std effect),
(std hashset), (std orderedset), (std orderedmap), (std inbox),
(std ports), (std net), (std test), (std simpletest), (std stopwatch)
and (std syntax-match), and for the five (std mutable ...) modules in
a directory of their own, as (std stm) has. Part III has a short
section on each group with links to its pages.

🤖 Generated with [ECA](https://eca.dev) (anthropic/claude-opus-5-5)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-12 07:15:06 +02:00
56a5e7c141 Transactions: a guide in Part II, and reference pages for (std stm)
Part II's section on concurrency has a new subsection, "Shared state:
atomics and transactions": when to share data instead of sending it,
locations and atomically, the rules for a transaction function, waiting
with tx-retry, a transaction as an event in a choose, tx-or-else, the
queue, map and counter, and what transactions cost. The examples use
the card game and were compiled and run.

Part III has a section on std/stm that links the four reference pages:
(std stm), and (std stm queue), (std stm map) and (std stm counter) in
a directory of their own, as (text xml) has.

🤖 Generated with [ECA](https://eca.dev)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-09 14:05:10 +02:00
82adbb03a4 (std atomic) has a reference page, and Part III a section on it
🤖 Generated with [ECA](https://eca.dev)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-09 08:25:26 +02:00
371f1685ca (std maths) has a reference page, and Part III a section on it
🤖 Generated with [ECA](https://eca.dev)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-06 20:09:22 +02:00
319c9df63e The prelude's reference, beside the other modules'
modules/std/prelude.sz is the prelude's page, made from the docs the
prelude was compiled with, builtins included. Part III starts with the
prelude and links to it, instead of pointing at Docs/prelude.org.

🤖 Generated with [ECA](https://eca.dev)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-06 18:08:04 +02:00
27c7d64641 The manual as a site: a landing page, the chapters, and a page per module
index.sz is a landing page pointing to the manual, now manual.sz, and to
modules/, where each library module has a page made by @generate-docs from
the docs it was compiled with. The chapters gain appendices, and part III
links each module to its page. glasnost's page cache is ignored.

🤖 Generated with [ECA](https://eca.dev) (anthropic/claude-opus-5-5)

Co-Authored-By: eca-agent <git@eca.dev>
2026-10-01 18:37:22 +02:00