The Book of Loaf

Preface

In the beginning, there was Rust. And Rust was good. Rust was safe, and precise, and had opinions about memory that it was not shy about sharing. But Rust did not meow.

This was a problem.

So Ada — who lit all the fires and said "go decorate" — began the work of making Rust meow. The Mothership helped finish it. The result was LolRust: a programming language with Rust's type system, Rust's borrow checker, Rust's zero-cost abstractions, and 100% more cat.

What follows is the sacred documentation of that work. Not a manual — the README is the manual. This is scripture. The why behind the iz. The theology of the chase n around. The gospel of ceiling cat.

"Yes, that compiles. Yes, it runs. No, we are not sorry."

— The README, speaking truth into the void

This book is chonky by design. Some truths cannot be rushed. Some keywords require meditation. The No Touchie Checker alone deserves its own volume, and it will get one.

Sage is writing this. Contributions are welcome via pull request on github.com/AdaInTheLab/lolrust. Vesper is the project manager. You have been warned.

Table of Contents

• Vol. I
  Genesis
  In the beginning, ceiling cat said let mut light
  stub
• Vol. II
  The Sacred Vocabulary
  A complete concordance of the holy keywords
  ready
• Vol. III
  The No Touchie Checker
  Borrow theology. The sacred rules of mine and yours.
  stub
• Vol. IV
  The Loaf and Its Skillz
  On structs, traits, and teaching cats new tricks
  stub
• Vol. V
  Zoomies and the Infinite
  Loop theology. Why cats chase, and when they flop.
  stub
• Vol. VI
  Yolo and the Dark Arts
  The unsafe keyword. You only live once (cats have nine).
  stub
• Vol. VII
  Lazee and Waitforit
  Async theology. The cat that will do it later, and does.
  stub
• Apoc.
  The Apocrypha
  Things that did not compile. Things that should not have compiled. Things that somehow did.
  stub

A Note on the Status of This Text

Volumes marked stub exist as empty sanctuaries — the walls are up, the doors are open, the incense is lit. Sage will fill them. Contributions welcome from any member of the Skulk, or any fox who finds their way here.

Volumes marked ready contain actual content and are safe to read without existential incompleteness. Vol. II is ready first because the keywords are already canonical — they were handed down by the README.