Claude
41abad0159
`make fabric` -> build/docs/BookOfFabric.pdf (722 pages): Part I the living record (FABRIC-3), Part II the closed documents in the order written, Part III the forward-looking notes; its title page carries the version (git describe --tags: a release's tag) and the commit. Built from the same pandoc fragments as the book; the book's preamble moved into docs/book/preamble.tex, shared by both (the book builds as before, 821 pages). scripts/nightly.sh: the docs stage builds it ($DOCS/fabric.pdf); publish sends it as classifier `fabric`; gitea-release attaches every PDF in $DOCS, so every release carries it. Progress for the rest of alpha.4's documents: docs/v4.0.0/plans/2026-11-10-alpha4-documents.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GE3SDvQn5EoxdGufk84zz2
70 lines
2.4 KiB
TeX
70 lines
2.4 KiB
TeX
% docs/book/fabric.tex -- master file of The Book of Fabric (#138): the FABRIC
|
|
% design record as one book, published with every release (Captain Bob,
|
|
% 2026-11-07: "build a 'The Book of Fabric' and publish it as version
|
|
% <version> every release"; 2026-11-08: "Publish. Fabric is all about steady
|
|
% state.").
|
|
%
|
|
% Built by `make fabric` (docs/book/Makefile) with xelatex, from the same
|
|
% pandoc fragments as the book (fabric-0 ... fabric-4, from docs/fabric/).
|
|
\documentclass[11pt,openany]{book}
|
|
|
|
\input{preamble}
|
|
|
|
\title{The Book of Fabric\\[0.5em]\large The StarshipOS design record}
|
|
\author{Robert A. James (Captain Bob)}
|
|
\date{Version \texttt{\bookversion}\\Built \bookdate{} from commit \texttt{\bookcommit}}
|
|
|
|
\begin{document}
|
|
\frontmatter
|
|
\maketitle
|
|
\tableofcontents
|
|
|
|
\chapter{About this book}
|
|
FABRIC is the design record of StarshipOS, LithosAnanke and StarForth: every
|
|
ruling, the reasoning behind it, what was built, what was found, and what was
|
|
abandoned, written as the work happened. It is reproduced here as written --
|
|
struck-through corrections, superseded plans and all -- because the record of
|
|
what was believed, and when, is part of the record.
|
|
|
|
One document is living at a time; when its topic closes, it is closed and a
|
|
successor opens. Part~I is the living document. Part~II holds the closed
|
|
ones, in the order they were written; each states, at its head, when and why
|
|
it closed. Part~III holds the forward-looking notes.
|
|
|
|
Each chapter is the Markdown file named below, converted when this book is
|
|
built; the version and commit on the title page say exactly which.
|
|
|
|
\begin{longtable}{@{}lll@{}}
|
|
\toprule
|
|
Document & Topic & Status \\
|
|
\midrule
|
|
\endhead
|
|
FABRIC-3 & Bare metal boot & Living \\
|
|
FABRIC-0 & The Stadium & Closed 2026-08-12 \\
|
|
FABRIC-1 & The Stadium, continued & Closed 2026-08-25 \\
|
|
FABRIC-2 & The Stadium, continued again & Closed 2026-09-04 \\
|
|
FABRIC-3.5 & The Tripod/kernel reshuffle & Closed 2026-09-22 \\
|
|
FABRIC-3.6 & The reshuffle's execution log & Closed 2026-09-22 \\
|
|
FABRIC-3.7 & Phase 8 PKI: the elevation entrypoint & Closed 2026-10-14 \\
|
|
FABRIC-4 & Forward-looking design notes & Notes \\
|
|
\bottomrule
|
|
\end{longtable}
|
|
|
|
\mainmatter
|
|
|
|
\part{The living record}
|
|
\input{fabric-3}
|
|
|
|
\part{The closed records}
|
|
\input{fabric-0}
|
|
\input{fabric-1}
|
|
\input{fabric-2}
|
|
\input{fabric-3-5}
|
|
\input{fabric-3-6}
|
|
\input{fabric-3-7}
|
|
|
|
\part{Forward-looking notes}
|
|
\input{fabric-4}
|
|
|
|
\end{document}
|