maux
Star on GitHub Buy me a coffee

Learn

A ladder of small programs, from your first commands to a ProDOS 8 program you build on maux and test on the bare machine with bye.

A lesson is on this site only because check-examples has typed it on the machine, a key at a time, the way you will, and asserted what the screen shows. The session on each page is the one that passed; the code on each page is the file that was typed. Run the same lessons yourself on the release disk: every file is in /usr/src/examples.

The ladder

  1. L0 Find your way around — pwd, cd, ls, head and wc on a root directory the kernel owns, with the disk's volume under /mnt.
  2. L1 Hello, world in the shell — A script is a text file whose first line is #!. Write one with vi and run it.
  3. L2 Hello, world in assembly — Assemble and link a 6502 program with nas and ld against liba, run it, then break it on purpose and read what nas says.
  4. L3 Your own filter — Write upcase in assembly, a program that reads standard input and writes it raised, and pipe it with the rest of the system.
  5. L4 Shell scripting — Three small scripts, one idea each: arguments and tests, loops and case, and grep rebuilt from ed with a here-document.
  6. L5 make — A Makefile for upcase: rules, prerequisites, make -n, and the second run that does nothing.
  7. L6 Hello, world in PLASMA — Compile David Schmenk's hello.pla with plasm on the machine, run it with plasma, then run the same program cooked by the plasma cutter.
  8. L7 A ProDOS program, tested with bye — Build an ordinary ProDOS 8 SYSTEM program on maux, run it on a freshly booted ProDOS with bye, come back, and let cmp check the result.

The sources live in the tree under examples/ and are staged on the release disk under /usr/src/examples, so you can read them on the machine. All lesson sources follow the house assembler dialect: 64-character lines, 13-character labels, ASCII, no macros.

Typing the lessons found things that do not work yet, in the shell. They are reported to the release and not yet fixed; the pages that meet them say so, plainly, and the lessons are written to avoid them. The L4 page, on shell scripting, has the list.

Meanwhile: watch a demo, read the manual, or see the developer notes.