--- BasiliskII/INSTALL 2000/07/13 17:45:50 1.5 +++ BasiliskII/INSTALL 2003/08/02 08:48:38 1.8 @@ -16,10 +16,7 @@ ROM files. No, I won't send you one. Depending on the platform you use, Basilisk II has additional requirements: BeOS: - You need BeOS R4 or better. On a PowerPC system you also need the - "sheep" driver that comes with SheepShaver. To use Ethernet, you need - the "sheep_net" add-on that also comes with SheepShaver (both items - are included in the SheepShaver Trial Versions). The PowerPC version of + You need BeOS R4 or later versions. Basilisk II cannot do Mac Classic emulation. Unix: @@ -41,24 +38,35 @@ Windows: somewhat reduced set of features. Basilisk II supports DirectX version 5 or later, but version 3 may also work, depending on your graphics card. +Mac OS X: + Versions 10.0 thru 10.2 can be used, and 10.3 will probably be no problem. + (OS X public beta is not supported by the current executable or source code, + but if you really need to use it, I can provide versions that will work) Installation ------------ BeOS: If you have a binary distribution of Basilisk II for BeOS, there are - executables for BeOS/PPC and/or BeOS/x86 included. If you have the source - distribution, do the following: + executables for BeOS/PPC and/or BeOS/x86 included. Basilisk II cannot run + concurrently with SheepShaver. Trying to do so will crash Basilisk II, or + SheepShaver, or both. + + If you have the source distribution, do the following: cd src/BeOS make This will produce an executable "BasiliskII" in the "obj.ppc" or "obj.x86" - directory. Basilisk II cannot run concurrently with SheepShaver. Trying to - do so will crash Basilisk II, or SheepShaver, or both. On a PowerPC system - you must have installed the "sheep" driver that comes with SheepShaver. To - use Ethernet, you must have installed the "sheep_net" add-on that also comes - with SheepShaver + directory. To use Ethernet, you also have to do: + + cd SheepNet + make install + + On a PowerPC system, you also have to do: + + cd SheepDriver + make install Unix: To compile Basilisk II, do the following: @@ -69,20 +77,9 @@ Unix: make install [optionally] To use Ethernet networking under Linux, you either have to configure your - kernel for ethertap support or make and install the "sheep_net" driver: - - make modules - - This should produce a kernel module "sheep_net.o" in the "Linux/NetDriver" - directory. Now su root and say - - cd Linux/NetDriver - make dev - /sbin/insmod sheep_net.o - - This will install the device node "/dev/sheep_net" and load the driver. - You should give appropriate access rights to /dev/sheep_net if you don't - want to have to run Basilisk II as root. + kernel for ethertap support or make and install the "sheep_net" driver + (this is explained in the README file, at the description of the "ether" + preferences item). This is what Brian J. Johnson says about compiling for IRIX: "I recommend compiling with "-Ofast". This requires changing "-g" @@ -95,7 +92,8 @@ Unix: must NOT use a pthreads library. User-level threads libraries such as PTL interfere with the signal handlers installed by Basilisk II and kernel- level threads are not supported by NetBSD, so you will have to live without - pthreads (and thus, without serial/ethernet/audio support). + pthreads, and thus without serial/ethernet/audio support (but the "UDP + tunnelling" network should work). ATTENTION NetBSD/mac68k USERS: Current (as of July 2000) versions of the NetBSD/mac68k kernel have a bug @@ -136,9 +134,10 @@ AmigaOS: following: cd src/AmigaOS - smake + make - To recompile Basilisk II, you need SAS/C 6.58. Earlier versions may not work. + To recompile Basilisk II, you need the GeekGadgets development suite and + PhxAss (which can be found on Aminet). Windows NT: If you have a binary distribution of Basilisk II for Windows, there is a @@ -149,6 +148,12 @@ Windows NT: MS Visual V++ 5.0 or later. Symantec C++ should work, too, with some modifications. See the "sysdeps.h" file in the "Windows" directory. +Mac OS X: + If you have the prebuilt application, there is nothing to do. + If you have the developer tools installed, and want to built it yourself, + look in the file src/MacOSX/0_HOW_TO_BUILD.txt + + The ROM file has to be named "ROM" and put in the same directory as the Basilisk II executable but you can specify a different location for the ROM file with the "rom" option in the preferences file (or with the preferences