This reminds me of the recent reading of "Inside Macintosh" on archive.org. I really hope they produce similar paper documentations nowadays. I'd love to hold a dictionary of obscure Mac internal knowledge.
It was amazing, and spoiled me. There was a similar set of books about BSD UNIX, as well. Don't remember the exact title, but it was pretty awesome.
Right now, it looks like they are relying completely on, on headerdoc comments.
It can work, but someone needs to spend a lot of time on these comments, and they need to do so, at a “holistic” level, coordinating all the various systems.
They have done a fairly good job, so far, but it’s really starting to fray; especially in the newer systems.
Yeah, what a pity. I love reading vintage computer manuals. They were well written, sometimes even with a bit of humour. I can imagine myself carrying a Powerbook and some manuals going into the mountains to write some software.
