Disk2File
                   An Apple ][ DOS 3.3 Disk Reader
                            By Ron Menelli

              Copyright (c) 1992,1994 Ronald J. Menelli


This program is copyrighted but freely redistributable. Distribute it
as you like, as long as the package is distributed as an unmodified
whole.


INTRODUCTION

Disk2File is a program that simply reads an Apple ][ DOS 3.3 formatted
5 1/4" disk and writes the entire contents of the disk to an AmigaDOS
file.


SYSTEM REQUIREMENTS

Disk2File runs on any Amiga computer that has an Amiga 1020 or
equivalent 5 1/4" drive. At the time of this writing, Disk2File has
only been tested on an A3000-25 with AmigaDOS 3.1 and an Amiga 1020
drive.


USAGE

To run this program, put your Apple ][ disk in your Amiga 5 1/4" drive
and, in a shell window, type:

        Disk2File DFx: file_name

Where DFx: is one of DF0:, DF1:, DF2:, DF3: (whichever your 5 1/4"
drive is) and file_name is the desired output file name. Provided
there are no read errors, the data on the disk will be copied to the
Amiga file.

OPTIONS

As of version 1.2, Disk2File now allows options to be added after the
file name. These options are as follows:

    -debug      Enable debug mode
    -start n    Select starting track        (default is 0)
    -end n      Select ending track          (default is 34)
    -step n     Select track step increment  (default is 1)

The -debug option simply forces the program to print a hex dump of any
track that causes a read or decode error. This is helpful if you
happen to understand the layout of Apple DOS 3.3 disks and your disk
won't read correctly.

The other three options control what portion of the disk should be
read. If you have a 1020 or other 40 track 5 1/4" drive, you probably
won't need to use these options. However, a number of users have told
me they have 80 track drives, which won't work with the default
settings.

I don't have an 80 track drive to allow me to test this feature, but I
believe that, on an 80 track drive, you would use the command:

    Disk2File DFx: file_name -start 0 -end 68 -step 2

to read a standard DOS 3.3 disk. Please let me know if this works
correctly!

Please note that if, by choosing some combination of options, the
resultant file is not 143,360 bytes long, it most likely won't work
with your emulator. Be forewarned.

FILE FORMAT

The format of the output file is one that is used by a number of Apple
][ emulators. The data in the file is merely each sector of the disk
written one after the other (in sequential order, not the order the
sectors are stored on the disk), starting at track 0, sector 0. The data
is completely decoded from its original GCR form, so no further
conversion need be done by the emulator.


VERSION HISTORY

1.2   8/17/94   Added the -start, -end, and -step options to allow the
                use of 80 track drives and to give more control over
                what's going on.
                Added the -debug option to print hexdumps of tracks
                when errors are detected.
                Fixed an amazingly silly bug that caused the program
                to lockup or crash when a non Apple DOS disk was read.

1.1   5/19/94   Fixed a number of silly decoding bugs that didn't
                appear until now. Added full checking of markers and
                checksums.
                First public release.

1.0             First try - basic functionality.



Please send bug reports, complaints, suggestions, beer and moral
support to:

        menelli@uiuc.edu

Ron Menelli
August 17, 1994