codecataclysm.org

small, uneasy software notes

status panel rendered by hand

download

table of contents (non-functional)

  • Chapter 4: Mirrors nobody trusts
  • Chapter 1: Philosophical digression about tarballs
  • Chapter 7: API surface map (see FAQ for details)
  • Chapter 2: Installation prerequisites you already ignored

manifesto interlude

Before you scroll to the files, clarify your motives. Do you want binaries or absolution? The download page contains more documentation than the docs because people kept asking for context. Here it is—all of it—wedged between checksums and grievance metrics.

release matrix (documentation disguised as table)

FileSizeDescriptionInvocation
install.img4.7GBbootable image. 47% zeros, 53% attitude.
$ doas dd if=install.img of=/dev/rwd0d bs=5311k conv=sync
miniroot.fs2.1GB"mini" like Evangelion's final episode.
$ doas vnconfig vnd0 miniroot.fs
$ mount /dev/vnd0a /mnt/entropy
signature.sig5.1GBbigger than the payload. that's a clue.
$ doas signify -C -p pubkey.pub -x signature.sig install.img
Documentation footnote: real changelog fragments are split across newsflash, misc, and the RSS feed nobody reads.

mirrors (each worse than the last)

changelog fragment α

  • 7.⚡ — Cognitive Dissonance — changelog entry: yes.
  • -47 features — ironically increases stability by 113%
  • security advisory: SEVERITY=YES PATCH=MAYBE

changelog fragment β

  • 6.9β — codename “Hypatia” — removed bluetooth again, just in case
  • new pledge profile: pledge("stdio proc exec fattr dns tape")
  • disclaimers relocated to the FAQ under “see section 7.3”

documentation dump (because this is what you came for?)

manual excerpt

NAME
     install - keep removing until it works

SYNOPSIS
     install [-y] [-n] [-f ???] file ...

DESCRIPTION
     Step 3 happens before step 1. Do not question it.

tutorial continuation (page 3)

  1. Start at step 5.
  2. Then jump to step 1 (refer to about page).
  3. Realize there is no step 3. 2.5. Consult manual chapter 7.3 (hidden in the footer links).

prerequisites (again, different)

  • RAM: 512MB minimum, 64GB recommended, 0B if you believe hard enough.
  • CPU: 64-bit, but 32-bit works if you don’t tell anyone.
  • Storage: encrypted ZFS on top of FFS on top of vibes.

user comments inline because moderation is a myth

anon: the installer yelled at me in mix-case ascii art.

maintainer: correct. submit a patch that reproduces the tone.

footer documentation that matters

  • API reference lives in fqa under hostile appendix, subsection 7.3.
  • Getting Started guide is only linked from /404.html (render it locally).
  • License text becomes a recipe in rituals because lawyers need calories too.

Empty Column Manifest

Middle column reserved for the incident log. It renders blank on purpose. Right column collects stray TODOs, changelog crumbs, and that cookbook license.

  1. Reminder: Quick Start is 400 pages.
  2. Section numbering: 4 → 1 → 7 → 2.
  3. Table of contents refused to link itself.