
	Basilisk, Version 0.7
	A Macintosh Classic emulator for BeOS and Linux

	Copyright (C) 1996-98 Christian Bauer, Bernd Schmidt et al.
	Freely distributable


Overview
--------

"Basilisk V0.7" is a freeware Mac Classic emulator for BeOS and Linux,
based on the 68k emulation of UAE, the Un*x Amiga Emulator by Bernd Schmidt.
No, this is not (and will never be) a port of ShapeShifter or SheepShaver.


Installation
------------

BeOS:
The archive contains a precompiled BeOS binary. To recompile, cd to "src"
and type "make -fMakefile.Be".

Linux:
To compile, cd to "src" and type "make -fMakefile.X".

Basilisk needs a 512K Macintosh Classic ROM image (yes, the Classic really
has 512K of ROM, not 256K). For copyright reasons this is not included in
the archive. No, I don't know where you can download it. No, I won't send
you one.

Basilisk has only been tested with a 512K Mac Classic ROM version 118,
revision 1 and probably doesn't work with any other ROM revisions. The ROM
file should be named "ClassicROM" and put in the same directory as Basilisk.


Usage
-----

Command line options:
 -h           : Give help on the options
 -f n         : Display every nth frame (default is 4)
 -D           : Start up with debugger
 -E           : Mount ROM .EDisk
 -[0123] file : Use file instead of fd[0123].image as filedisks
 -r file      : Use file as ROM image instead of 'ClassicROM'
 -p file      : Use filename to save PRAM contents instead of 'PRAM'

Mouse:
  Only the primary mouse button is supported.

Keyboard:
  Basilisk emulates a full Extended ISO ADB keyboard.

Sound:
  None. The "Mac" will hang when it tries to play sound. The first thing you
  should therefore do is to open the control panel and set the sound volume
  to zero.

Floppy disks:
  Under BeOS, Basilisk can use Mac HD (no DD!) floppy disks with the internal
  floppy drive. To mount a disk, insert it and select the "Mount Floppy Disk"
  item from Basilisk's application menu. If there's a disk in the drive upon
  startup, Basilisk will mount it automatically. Unmount/eject disks as usual
  on the Macintosh. Most floppy drives don't automatically eject disks, but
  Basilisk will tell you when it's safe to remove the disk from the drive.

Filedisks:
  AKA hardfiles. Basilisk allows using up to 4 Mac volumes which are
  emulated in one file (each) on the BeOS/Unix file system. Basilisk can
  use any files as filedisks that consist of a 0-511 byte header followed
  by a 512-byte sector image of a Mac volume. This includes uncompressed
  Apple DiskCopy image files and headerless image files as used by other
  Macintosh emulators.

EDisk:
  The 512K Mac Classic ROM contains a bootable System 6.0.3 "ROM disk". To
  mount it, use the "-E" command line option. If there's no other bootable
  volume, Basilisk will boot from the EDisk.

Quitting:
  Although you can quit Basilisk at any time by closing its window, you
  should only do that if the "Mac" crashed. The right way to quit Basilisk is
  to select the "Shut Down" menu item from the Finder's "Special" menu, and
  then quit the program when you are instructed to "turn off your Macintosh".


MacOS versions supported
------------------------

Basilisk has been tested (i.e. it booted) with MacOS System 5.0, 6.0.3,
6.0.8, 7.1 and 7.5. Your Mileage May Vary. System 5.x and 6.x are somewhere
on Apple's FTP site. Booting from floppy may take several minutes (esp.
System 7), so be patient.


Unimplemented features
----------------------

 - Macintosh hardware emulation
 - Time Manager
 - Networking (don't turn on AppleTalk, it will crash)
 - Serial ports
 - SCSI
 - Sound
 - Printing
 - Only a Mac Classic, i.e. no Color QuickDraw, no QuickTime, no ...
 - more ...


Speed
-----

On a Dual603e-133, Basilisk seems to run at the full speed of a real Mac
Classic. If you think that Basilisk uses too much CPU time, try the "-f n"
command line option with n>4.


Acknowledgements
----------------

Special thanks to:
 - Bernd Schmidt for letting me use his UAE 68k emulation
 - The guys at DeBUG for beta testing
 - Daniel Bobbert who printed dozens of pages from the THINK Reference for
   me years ago
 - All ShapeShifter users and beta testers
 - Apple Computer Inc., who made writing a Macintosh emulator a child's play


Legal stuff
-----------

Copyright (C) 1996-1998 Christian Bauer, Bernd Schmidt et al. This program is
freeware. You may do whatever you want with it for personal use. Permission
is granted to redistribute this program free of charge, provided it is
distributed in the full archive with unmodified contents and no profit
beyond the price of the media on which it is distributed is made. Exception
to the last rule: It may be included on freeware/shareware collections on
CD-ROM. There are no warranties of any kind for this program. If you use this
program, you do so at your own risk. The authors are not responsible for any
damages  that might result from using this program.


Author
------

You can contact me at <cbauer@iphcip1.physik.uni-mainz.de>. Because of the
very preliminary state of this software, I will accept neither feature
requests nor bug reports at this time. Bug fixes are welcome.

There are two things I will NOT do:
 1. Send you Mac ROM files
 2. Explain to you how to use a Macintosh


History
-------

V0.4 - first public release
V0.5 - minor fixes, faster screen refresh, can be started from the Browser
V0.6 - ported to BeOS DR9/Preview Release
V0.7 - better ADB handling, now also runs on BeOS/x86


Christian Bauer
<cbauer@iphcip1.physik.uni-mainz.de>
