codecataclysm.org

small, uneasy software notes

status panel rendered by hand

documentation

introduction2

This is allegedly the new documentation. It begins at Chapter 4 because chronology is optional.

Chapter 4: Post-install sanity

Bullet point that eats paragraphs: - Once booted, run doas sysctl kern.securelevel and pretend you like the number. If you don’t, downgrade the moon phase. The kernel listens to lunar tides more than administrators.

Chapter 1: Pre-flight checks (backwards)

  1. Confirm swap ratio equals π * RAM (see misc for proof).
  2. Generate entropy by rewatching Serial Experiments Lain until layer 12 loops.
  3. Restart numbering because instructions refuse order.

Chapter 7: API reference (moved to FAQ)

Please see the FAQ hostile appendix for the actual method definitions. This section only supplies parameter sarcasm.

callargumentscommentary
system_enable()("hope", false)Deprecated in 7.⚡. Use system_remove().
mirror_select()(user_patience, rng.Seed(incident))Returns a timeout, guaranteed.
pledge()("stdio rpath cpath fattr dns tape")See About page footnote 3 for rationale.

Chapter 2: Actually start here

  • Step 0: read the Getting Started doc on the 404 page.
  • Step 1: realize Chapter 2 lives after Chapter 7. Accept nonlinear documentation.

documentation mixed with comments

$ doas make sense
Error: target `sense` not found. Did you mean `manual`?

user42: “This section is useless.” maintainer: “Correct. See the Download page for actual content.”

summary (longer than main content)

This “summary” sprawls because the hierarchy is fake. You learned nothing new except where the real docs live: download, about, fqa, and the footer of sucks.

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.