From 5d77c5b247b6da7a1d49c23b03d5522e398c7d73 Mon Sep 17 00:00:00 2001
From: Lukasz Kasprzak <lukas@labunix.xyz>
Date: Tue, 15 Sep 2026 09:32:16 +0200
Subject: docs: make ci passes on OpenBSD and FreeBSD; OpenBSD's go needs
 GOTOOLCHAIN=auto

---
 CHANGELOG.md   | 4 ++++
 README.md      | 4 +++-
 docs/design.md | 5 ++++-
 3 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7d71a29..b641ec0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+- `make ci` passes on OpenBSD 7.9 (OpenBSD make) and FreeBSD 15.0 (bmake)
+  with Go 1.26.8; the design notes that OpenBSD's `go` package needs
+  `GOTOOLCHAIN=auto` to use it.
+
 ## 0.0.8 — 2026-09-15
 
 The rest of the open work after 0.0.7, and the checks on real FreeBSD and
diff --git a/README.md b/README.md
index 9dd1f6a..91711b8 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,9 @@ action, or a way to look inside archives.
 make && make install
 ```
 
-`make` builds `./krino`; Go fetches the module dependencies itself. `make
+`make` builds `./krino`; Go fetches the module dependencies itself, and the
+Go toolchain `go.mod` names (on OpenBSD, whose `go` package defaults to
+`GOTOOLCHAIN=local`, run `GOTOOLCHAIN=auto make`). `make
 install` puts the binary in `$PREFIX/bin` (default `~/.local/bin`), the man
 pages in `$PREFIX/share/man`, and the examples and `docs/sexp-primer.md` in
 `$PREFIX/share/doc/krino`.
diff --git a/docs/design.md b/docs/design.md
index 3c48171..bf8eca0 100644
--- a/docs/design.md
+++ b/docs/design.md
@@ -818,7 +818,10 @@ Rules for the GUI to come:
 - Go 1.25 or newer (`golang.org/x/text` v0.39 fixed an infinite loop on
   invalid input, GO-2026-5970, and needs it). `go.mod` pins the toolchain,
   `go1.26.8`, so builds carry the standard library's security fixes: an
-  older `go` with `GOTOOLCHAIN=auto`, the default, downloads it itself.
+  older `go` with `GOTOOLCHAIN=auto`, Go's default, downloads it itself.
+  OpenBSD's `go` package sets `GOTOOLCHAIN=local` in its `go.env`, so there
+  build with `GOTOOLCHAIN=auto make`; FreeBSD's keeps `auto`. `make ci`
+  passes on OpenBSD 7.9 and FreeBSD 15.0 with that toolchain.
   `CGO_ENABLED=0`: static binaries on Linux and FreeBSD;
   on OpenBSD Go links against the system libc, as that platform requires.
 - Go dependencies: `golang.org/x/term` (key-at-a-time input) and
-- 
cgit v1.3