Skip to content

v1.2.2 — HAL edition (colophon sharpened)

Choose a tag to compare

@rdicosmo rdicosmo released this 18 Aug 19:55

A review of the v1.2.1 colophon (by Fable) found it right on every byte-level fact but imprecise where it assigned meaning to those facts. v1.2.2 fixes that.

  • The lesson, sharpened. Byte-exactness is the right granularity for source code — a one-character change can change what a program does — and the wrong one for documents: a PDF, its PDF/A conversion, a PostScript export, or a rebuild under a newer TeX Live are byte-different objects that are the same document to every reader. The cover page is no longer lumped in as "another byte variant": prepending one produces a different document for the reader, which is the counterexample that defines the boundary.
  • Capstone corrected. A match verifies the archived source, not "the document you are reading" — the source builds the unstamped sibling PDF, not the stamped PDF in hand. Step 3 now says to ignore everything after the first ; (the stamp carries origin;visit;anchor), and a clone step is added since a PDF reader has no checkout.

This is the exact PDF deposited in HAL. Its colophon carries the qualified SWHID of the archived source:
swh:1:dir:2f0cd063b20c3dd4d4b87a14d624290f45da6fe3;origin=https://github.com/rdicosmo/source-code-of-science;visit=swh:1:snp:e61716bf138b50ebd9607e6db3b9a7a02366a2df;anchor=swh:1:rev:797170259c947b075a4185c22f978add131b0785

A pristine, byte-stable rendering also lives at https://dicosmo.org/Articles/2026-source-code-of-science.pdf.