Apple 13-Sector Disk Transfer (ADT13) preliminary version
=========================================================

I'll assume that you know how to run ADT. Thus there will be only short
instructions here. (Well, not *so* short after all...)


1.) What you'll do here is to produce a first bootable 13-Sector disk. You'll
need one formatted 16-sector disk.

Wire your system up for ADT. Transfer the image 13STRAP.DSK to the Apple,
using standard 16-sector ADT.

Now boot your Apple from the new 13STRAP disk. When "PLEASE WAIT" appears,
you'll have to wait for about 2 minutes.

The Apple will then tell you that DOS 3.2 is now running. Now type the
following commands on the Apple:

INIT HELLO (be patient - it takes a long time)

BSAVE ADT13,A$4000,L$A14 (be sure to get the numbers exactly right)

BRUN ADT13,A$803 (same here).

ADT13 is now running, you'll see the familiar screen appear, only a bit
smaller since there are fewer sectors on a 13-sector disk.

2.) Start ADT13 on the PC side: On the PC, run ADT13.EXE (MS-DOS executable,
works best in pure DOS) or adt13 (Linux executable). A Windows executable will
hopefully follow later.

5.) Use ADT13 just like standard ADT. The recommended file extension for
13-sector disk images is ".D13". As the very first thing, transfer the
ADT13.D13 image to the disk you just INITed; this is the image of a bootable
13-sector disk that will auto-run ADT13. When the transfer is done, quit ADT13
and say CATALOG to see if the disk transferred correctly.

2.) To actually boot your Apple from this disk, transfer BOOT13.DSK to another
floppy, again using standard 16-sector ADT. Boot your apple from this disk;
first it'll make sure both BASICs are available by loading Integer BASIC (or
Applesoft, if your Apple still has Integer BASIC ROMs) into the language card.
When the drive stops, insert the 13-sector disk you just created and hit
RETURN. That's all. If you happen to own a 13-sector Disk II controller, you
can just say PR#<slot number> instead.

Try quitting ADT13 and saying CATALOG to check if the disk booted alright. You
might want to try a few commands, such as LOAD, SAVE, VERIFY and RUN. INIT a
few more 13-sector disks.

After that you might want to transfer the two reconstructed DOS 3.2
master disk images, DOS32STD.D13 (for Integer BASIC) and DOS32PLS.D13 (for
Applesoft).

The original Apple disks fitted more than the standard amount of blocks on the
Integer BASIC Master by using directory-track blocks as data blocks; because I
found no easy way of duplicating this, the binary UPDATE 3.2 program
(corresponding to DOS 3.3's MASTER CREATE), which was originally on both
disks, has been removed from the Integer BASIC master image.

Some notes on ADT13 operation:

a.) IMPORTANT! When INITing a disk with DOS 3.2, the disk sectors are created
WRITE-ONLY. Reading any sector that has never been written to will give a read
error. Only after a sector has been written to does it become readable.
Because of this peculiarity, unreadable sectors are fairly common on 13-sector
disks; don't worry too much about these when transferring disks. If the
head-knocking and drive-grinding goes on your nerves, just SAVE something to
the disk until it's full, then DELETE it again; or, format your 13-sector
disks with Copy II+ 5.5 (included 16-sector disk image COPY2P55.DSK) which
creates readable sectors right from the start.

b.) ADT13 is a bit slower than standard ADT. That's simply because DOS 3.2 is
slower than ESDOS, which is the DOS 3.3 variant that's used on the standard
ADT disk.

c.) It's currently not possible to turn off the RWTS checksum verification;
the original ADT patched DOS 3.3 to do this, and I don't know enough about the
DOS 3.2 code to find the right locations to patch.

6.) To compile the code on Linux, say "gcc -DLINUX -DUNIX adt13.c ucomm.c -o
adt13 -lncurses". On DOS, use Borland's Turbo C++ compiler, but swap in
comm.c for ucomm.c.

As usual, there's no warranty for this software.

Questions, Suggestions, Imrpovements? You can reach me at "ticmanis@gmx.de"
for the forseeable future.

Happy Hacking!

-- 
Linards Ticmanis
