Apple-2-SW
/
beneath-apple-dos
mirror of https://github.com/iKarith/beneath-apple-dos.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Don Worth's Beneath Apple DOS extracted from his Apple II floppies
44 Commits 1 Branch 0 Tags 554 KiB
Assembly 95.5%
Python 4.5%
Go to file
T. Joseph Carter 66d7686215 Fixup missed add 2018-03-10 17:52:48 -08:00
artwork Convert chapter 1 to Mardown, insert image 2018-03-10 17:48:58 -08:00
scripts Add script, document process better 2017-07-21 04:45:23 -07:00
src Move sample source to src and rename 2017-07-21 06:14:42 -07:00
.editorconfig Remove trailing whitespace, normalize dot commands 2017-07-20 15:45:47 -07:00
.gitattributes Initial commit 2017-07-20 13:13:03 -07:00
CHANGES-2nd-printing.txt Clean up 2nd printing changes 2017-07-21 08:08:21 -07:00
CHANGES-3rd-printing.txt Clean up 3rd printing changes 2017-07-21 08:09:08 -07:00
README.md Add script, document process better 2017-07-21 04:45:23 -07:00
appendixA.txt Clean up appendix A paragraphs 2017-07-21 06:09:18 -07:00
appendixB.txt Clean up appendix B 2017-07-21 07:35:03 -07:00
appendixC.txt Concatenate parts of appendix C 2017-07-21 07:46:56 -07:00
ch02.txt Cleanup of Chapter 2 2017-07-20 18:27:18 -07:00
ch03.txt Cleanup of chapter 3 2017-07-20 18:27:18 -07:00
ch04.txt Cleanup chapter 4 2017-07-20 19:00:10 -07:00
ch05.txt Chapter 5 cleanup 2017-07-21 03:57:06 -07:00
ch06.txt Fix bitrot in CH6.2, append to ch06.txt 2017-07-21 04:20:16 -07:00
ch07.txt Reflow chapter 7 paragraphs 2017-07-21 04:56:15 -07:00
ch08.txt Chapter 8 cleanup 2017-07-21 05:32:14 -07:00
chapter_01.md Fixup missed add 2018-03-10 17:52:48 -08:00
corrections.txt Clean up corrections 2017-07-21 08:05:01 -07:00
toc.txt TOC cleanup 2017-07-21 05:44:32 -07:00

README.md

Don Worth's Beneath Apple DOS

Don Worth wrote a very cool book for the Apple II. Actually, he wrote several, but here is one of them that I happened to need. He found a bunch of his disks containing the original text in his garage, and he was happy to have his original disks be released into the hands of whomever might want to use them. Since the OCR versions of this book are ... less than great ... I've decided to try and convert his originals.

The Goal

I'd like to see a proper version of this book. Text, figures, all of it. To do that is not going to be trivial, but it starts with clean text. We don't have that on archive.org, yet, but perhaps we can fix that? Please feel free to join in--send patches, help add stuff, etc.

The method

Documenting this for other texts to be converted in future...

First we need to extract the text documents from the disks and turn them into something we can use on a modern system:

  1. The DOS 3.3 disks were dumped using cppo
  2. Apply scripts/extract_piewriter.py to each document file which did the following transformations:
    • For characters 0xa0-0xfe, strip the high bit to get pure ASCII
    • Convert 0x0d and 0x8d (return) characters ti 0x0a (newline)
    • Escape all else in C-style
  3. Remove NUL at end of .txt files and renamed the assembly source to .s
  4. Remove trailing whitespace
  5. Normalize dot commands (lowercase, spacing) for easier mechanical parsing.
  6. Remove the obvious dot commands (.pp is a paragraph break, .sp creates vertical space, .br seems to be a line break, .bp a page break) and attempt to remove or interpret others as seems appropriate

This process has probably broken the .s files and there were some files that don't appear to have actually been part of the text (or maybe they were edits and revisions?), and there was bitrot in the files suggesting the disks the source documents were stored on were losing their integrity.