Apple-2-SW/beneath-apple-dos
1
0
Fork 0
mirror of https://github.com/iKarith/beneath-apple-dos.git synced 2024-06-15 16:29:29 +00:00
Code Issues Projects Releases Wiki Activity
Don Worth's Beneath Apple DOS extracted from his Apple II floppies
14 Commits 1 Branch 0 Tags 554 KiB
Assembly 95.5%
Python 4.5%
4461e45278
Go to file
T. Joseph Carter 4461e45278 Add chapter 4 to root, fix bit rot 
Fixing the bitrot in chapter 4 after moving it meant looking at the OCR'd text
on archive.org, which is not good.  Here's how not good it was:

> A tiL.  (be it APPLESOFT, INTEGER, BINARY.  or TEXT type) con,i a t a of one
> or more sectors containing data.  Since the •• ctor i, the smallest unit of
> allocatable space on a di s kette, a file will use up at least one sector even
> if it i a Ie •• than 256 bytes long; the remainder of the sector is w • • ted.
> ThuB , a file containing 400 characters (or bytes) of data will occupy one
> entire sector and 144 bytes of another with 112 bytes wasted .  Knowing these
> facts, one would expect to be able to use up to 16 times 35 times 256 or
> 143,360 bytes of space on a diskette for files.  Actually, the largest file
> that can be stored is about 126,000 bytes long.  The reason for this is that
> some of the sectors on the di a kette .uat be used for what is called
> ·ove[head- .
>
> <Figure 4.1>
>
> Overhead sectors contain the iMage of DOS which is 10ad •• 1 when booting the
> diskette, a list of the nallles and loes,lollll of the files on the diskette,
> and an accounting of the sectors which are free for use with new files or
> expon.lu".  of existing files.  An example of the way DOS uses lectDr.  ,.
> given in Pigure 4 .  1 .

Yeah....  You see why I was so excited by the source text?  :)
2017-07-20 18:53:26 -07:00
D1S1 Add chapter 4 to root, fix bit rot 2017-07-20 18:53:26 -07:00
D1S2 Remove trailing whitespace, normalize dot commands 2017-07-20 15:45:47 -07:00
D2S1 Remove trailing whitespace, normalize dot commands 2017-07-20 15:45:47 -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
ch01.txt Chapter 1 just about finished. 2017-07-20 16:41:08 -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 Add chapter 4 to root, fix bit rot 2017-07-20 18:53:26 -07:00
README.md Remove trailing whitespace, normalize dot commands 2017-07-20 15:45:47 -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

  1. The DOS 3.3 disks were dumped using cppo
  2. Apply the following transformations to each document file:
    • 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
  4. .pp dot command is paragraph break, replace with blank line.
  5. Remove trailing whitespace
  6. Normalize case and spacing of dot commands (lowercase here)

This has probably broken the .s files a bit, and I haven't bothered to decompile the five byte HELLO ... ;)