diff options
| author | Ralph Amissah <ralph.amissah@gmail.com> | 2026-10-13 16:54:02 -0400 |
|---|---|---|
| committer | Ralph Amissah <ralph.amissah@gmail.com> | 2026-10-13 16:54:02 -0400 |
| commit | 79a7a0cf09c9d6b5d9974376dcb7a98bd5bdbcba (patch) | |
| tree | 0a83345133c51ff0144c33364077603570a47f45 /gleam/README.md | |
| parent | format 2.1: ocda-read, the readers folded in (diff) | |
release 2.1.0: versions, a nix-gleam build, READMEHEADmainclaude-spec-matchup-redo-fixing-3
The library's version follows the format's: 2.1.0 in dub.json,
gleam.toml and both flakes. A release is numbered major.minor.patch,
major.minor being the format and shared with the specification and the
writer, the patch the library's own.
dlang/flake.lock and gleam/flake.lock: nixpkgs forward to
26.11pre1097770, the same revision in both, as the two have been at
every commit.
README:
- the two earlier readers, sisudoc-ssp-reader and
sisudoc-ocda-db-reader, are named as what they now are: published
frozen, the record of readers written from the specification
alone, their work done by ocda-read;
- the documents the checks run over are the markup document samples,
named with their repository and the spine flags that build the
artefacts; the claims say "every document-language of the markup
document samples" rather than a count, which changes as the samples
do; the same in gleam/README.md, which also describes the nix-gleam
build and names the specification's documents as .md, as they are;
- "one implementation per language", where it said "one reader";
- the reader's modes that describe the document say the same of every
form; --languages and --files describe the file, and say so;
- a short section on building, a link to the specification, the
format as 2.1, and the license.
Checked: D and Gleam build; with the writer at the same point, over
the markup document samples: the four dumps (D and Gleam, .ssp and
.ocda.db) identical for every document-language of the markup document
samples, ocda-read the same from every form and in both languages, and
D == Gleam in all five formats.
(assisted by Claude-Code)
Diffstat (limited to 'gleam/README.md')
| -rw-r--r-- | gleam/README.md | 23 |
1 files changed, 12 insertions, 11 deletions
diff --git a/gleam/README.md b/gleam/README.md index 482db38..8135005 100644 --- a/gleam/README.md +++ b/gleam/README.md @@ -60,12 +60,12 @@ the whole model out canonically, and is the stronger check of the two, because it is **byte for byte what the D library's `ocda-dump` writes**. So the four questions can all be asked with `diff`: -| | | -|-----------------------------|-----------------------------| -| D: `.ssp` == `.ocda.db` | 36 of 36 document-languages | -| Gleam: `.ssp` == `.ocda.db` | 36 of 36 | -| `.ssp`: D == Gleam | 36 of 36 | -| `.ocda.db`: D == Gleam | 36 of 36 | +| | | +|-----------------------------|-------------------------| +| D: `.ssp` == `.ocda.db` | every document-language | +| Gleam: `.ssp` == `.ocda.db` | every document-language | +| `.ssp`: D == Gleam | every document-language | +| `.ocda.db`: D == Gleam | every document-language | ## Deliberately a mirror of the D library @@ -112,11 +112,12 @@ nix develop -c gleam test Shipped as an Erlang shipment rather than an escript, because sqlite on the BEAM is a NIF and a NIF cannot be loaded from inside an escript archive. -The dependency hash in `flake.nix` pins what `manifest.toml` pins; change -one and the other must change with it. +The build is nix-gleam's, kept in `nix-gleam/` (see its README): each Hex +dependency is fetched on its own, with the checksum gleam wrote into +`manifest.toml`, so there is no hash in `flake.nix` to keep up to date. ## Format -Specified in **sisudoc-abstraction-format**: `ocda-model.org` for the model, -`ssp-format-specification.org` and `ocda-db-format-specification.org` for the -two serialisations. At format **2.x**. +Specified in **sisudoc-abstraction-format**: `ocda-model.md` for the model, +`ssp-format-specification.md` and `ocda-db-format-specification.md` for the +two serialisations. At format **2.1**. |
