The header scan (Captain Bob, 2026-11-10): 788 source files -- 351 with the
SL-1.0 header, 12 with the old name (docs/working/experiments, kept by
ruling), 31 under someone else's licence (tools/kconfig, Linux's, GPL-2.0:
kept), and 394 with none. Ruled: the SPDX form; capsules (.4th, .f18) and
proofs (.thy) left for a ruling of their own (mkcapsule's 64x16 block format,
content-addressed capsules).
253 files now begin
SPDX-License-Identifier: LicenseRef-Starship-1.0
Copyright (c) 2023-2026 Robert A. James
as a /* */ block (C, headers, assembly, linker scripts) or # lines (scripts,
Makefiles, Kconfig; below a shebang or a coding line); tools/mkcapsule.c,
which had the copyright line, gets the SPDX line only.
Not touched: docs/working/ (archive and old campaign material, as the
ruling kept the experiments); v4/system/post_cases.c (generated by
v4/tools/mkpost.py, "do not edit" -- the generator has the header).
Comments only: the kernel builds on amd64, aarch64, riscv64; make -C v4
test-32: 39 programs, 0 failures; every changed script parses.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GE3SDvQn5EoxdGufk84zz2
docs/formal/
The press-ready LaTeX documentation set for StarForth / LithosAnanke.
Audience: patent counsel, SSRN reviewers, licensees, paying customers,
hobbyists with hardware in hand. Nothing goes here until it's ready to be
cited — see CLAUDE.md for full authoring conventions, the scraps system,
and voice/tone rules.
Ten publications in three groups, all built from common/preamble.tex and
common/starship.bib, assembled largely from scraps/:
| Group | Directories |
|---|---|
| Research volumes | vol1-vm-physics/, vol2-kernel/, vol3-research/ |
| Practitioner books | dev-guide/, user-guide/, cookbook/ |
| Standalone reports | experiments/, proofs/, ssrn/, patent/ |
- common/ — Shared LaTeX preamble and bibliography,
\input{}by every publication. - scraps/ — Press-ready LaTeX fragments converted from every
document in
docs/working/, mirrored by source path. - vol1-vm-physics/, vol2-kernel/, vol3-research/ — The three research volumes.
- dev-guide/, user-guide/, cookbook/ — The three practitioner books.
- experiments/, proofs/,
ssrn/ — Three of the four standalone reports.
patent/is the fourth — legal hold, do not touch without Bob's instruction. - doxygen/ — Generated Doxygen output (gitignored except the committed PDF appendix built from it).
- build/ — Build output directory (gitignored; only the
rendered
.pdfper publication is committed). Makefile— builds all ten publications (make docs-formalfromdocs/CLAUDE.md, ormake -C docs/formal all).CLAUDE.md— authoring conventions (read before adding or editing anything here).fix-doxygen-unicode.py— post-processes Doxygen XML for LaTeX-safe Unicode before thedoxygenappendix builds.
See also
docs/working/README.md— the living-document tier this material is promoted from.- Project root