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
- 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.
- L1 Hello, world in the shell — A script is a text file whose first line is #!. Write one with vi and run it.
- 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.
- 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.
- L4 Shell scripting — Three small scripts, one idea each: arguments and tests, loops and case, and grep rebuilt from ed with a here-document.
- L5 make — A Makefile for upcase: rules, prerequisites, make -n, and the second run that does nothing.
- 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.
- 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.