--- BasiliskII/README	1999/10/21 18:29:04	1.7
+++ BasiliskII/README	2000/07/13 17:45:51	1.12
@@ -2,7 +2,7 @@
 	Basilisk II, Version 0.8
 	A free, portable Mac II emulator
 
-	Copyright (C) 1997-1999 Christian Bauer et al.
+	Copyright (C) 1997-2000 Christian Bauer et al.
 	Freely distributable
 
 
@@ -22,7 +22,8 @@ distributed under the GNU General Public
 
 Basilisk II has currently been ported to the following systems:
   - BeOS R4 (PowerPC and x86)
-  - Unix (tested under Linux, Solaris 2.5, FreeBSD 3.x and IRIX 6.5)
+  - Unix (tested under Linux, Solaris 2.5, FreeBSD 3.x, NetBSD 1.4.2 and
+    IRIX 6.5)
   - AmigaOS 3.x
   - Windows NT 4.0 (mostly works under Windows 95/98, too)
 
@@ -41,7 +42,8 @@ Some features of Basilisk II:
   - Serial drivers
   - SCSI Manager (old-style) emulation
   - Emulates extended ADB keyboard and 3-button mouse
-  - Uses UAE 68k emulation or (under AmigaOS) real 68k processor
+  - Uses UAE 68k emulation or (under AmigaOS and NetBSD/m68k) real 68k
+    processor
 
 The emulator is not yet complete. See the file "TODO" for a list of
 unimplemented stuff.
@@ -234,11 +236,11 @@ screen <video mode>
         15-bit truecolor display in a Picasso96 PIP. This requires
         Picasso96 as well as a PIP-capable graphics card (e.g. Picasso IV).
       scr/<hexadecimal mode ID>
-        8/15/24-bit fullscreen display on a Picasso96 screen with the given
-        mode ID. This requires Picasso96. For 15 and 24 bit, the frame buffer
-        format must be QuickDraw-compatible (big-endian, xRGB 1:5:5:5 or
-        xRGB 8:8:8:8). The screen size will be the default size for that
-        mode ID.
+        8/15/24-bit fullscreen display on a Picasso96/CyberGraphX screen with
+        the given mode ID. This requires Picasso96 or CyberGraphX. For 15 and
+        24 bit, the frame buffer format must be QuickDraw-compatible
+        (big-endian, xRGB 1:5:5:5 or xRGB 8:8:8:8). The screen size will be
+        the default size for that mode ID.
 
   Windows:
     The "video mode" is one of the following:
@@ -332,6 +334,7 @@ ether <ethernet card description>
   Linux:
     The "ethernet card description" is the name of an Ethernet interface.
     There are two approaches to networking with Basilisk II:
+
       1. Direct access to an Ethernet card via the "sheep_net" driver.
          In this case, the "ethernet card description" must be the name
          of a real Ethernet card, e.g. "eth0". It also requires the "sheep_net"
@@ -341,23 +344,42 @@ ether <ethernet card description>
          networking. MacOS will only be able to talk to other machines on
          the Ethernet, but not to other networks that your Linux box routes
          (e.g. a second Ethernet or a PPP connection to the Internet).
+
       2. Putting Basilisk II on a virtual Ethernet via the "ethertap" device.
          In this case, the "ethernet card description" must be the name
          of an ethertap interface, e.g. "tap0". It also requires that you
          configure your kernel to enable routing and the ethertap device:
          under "Networking options", enable "Kernel/User netlink socket" and
          "Netlink device emulation", under "Network device support", activate
-         "Ethertap network tap". Next, see /usr/src/linux/Documentation/
-         networking/ethertap.txt for information on how to set up /dev/tap*
-         device nodes and activate the ethertap interface. Under MacOS,
-         select an IP address that is on the virtual network and set the
-         default gateway to the IP address of the ethertap interface. This
-         approach will let you access all networks that your Linux box has
-         access to (especially, if your Linux box has a dial-up Internet
-         connection and is configured for IP masquerading, you can access
-         the Internet from MacOS). The drawback is that you can only use
-         network protocols that Linux can route, so you have to install and
-         configure netatalk if you want to use AppleTalk.
+         "Ethertap network tap". You also have to modify devices/net/ethertap.c
+         a bit before compiling the new kernel:
+
+          - insert "#define CONFIG_ETHERTAP_MC 1" near the top (after the
+            #include lines)
+          - comment out the line "dev->flags|=IFF_NOARP;" in ethertap_probe()
+
+         Next, see /usr/src/linux/Documentation/networking/ethertap.txt for
+         information on how to set up /dev/tap* device nodes and activate the
+         ethertap interface. Under MacOS, select an IP address that is on the
+         virtual network and set the default gateway to the IP address of the
+         ethertap interface. This approach will let you access all networks
+         that your Linux box has access to (especially, if your Linux box has
+         a dial-up Internet connection and is configured for IP masquerading,
+         you can access the Internet from MacOS). The drawback is that you
+         can only use network protocols that Linux can route, so you have to
+         install and configure netatalk if you want to use AppleTalk. Here is
+         an example /etc/atalk/atalkd.conf for a LAN:
+
+           eth0 -seed -phase 2 -net 1 -addr 1.47 -zone "Ethernet"
+           tap0 -seed -phase 2 -net 2 -addr 2.47 -zone "Basilisknet"
+
+         (the "47" is an arbitrary node number). This will set up a zone
+         "Ethernet" (net 1) for the Ethernet and a zone "Basilisknet" (net 2)
+         for the internal network connection of the ethertap interface.
+         MacOS should automatically recognize the nets and zones upon startup.
+         If you are in an existing AppleTalk network, you should contact
+         your network administrator about the nets and zones you can use
+         (instead of the ones given in the example above).
 
   AmigaOS:
     You have to specify the name of the SANA-II Ethernet device and the device
@@ -394,7 +416,9 @@ frameskip <frames to skip>
   For refreshed graphics modes (usually window modes), this specifies
   how many frames to skip after drawing one frame. Higher values make
   the video display more responsive but require more processing power.
-  The default is "8".
+  The default is "8". Under Unix/X11, a value of "0" selects a "dynamic"
+  update mode that cuts the display into rectangles and updates each
+  rectangle individually, depending on display changes.
 
 modelid <MacOS model ID>
 
@@ -456,6 +480,18 @@ Unix:
     is /usr/local/share/BasiliskII/fbdevices. A sample file is included
     with Basilisk II.
 
+  mousewheelmode <mode>
+
+    If you have a mouse with a wheel, this option specifies whether moving
+    the wheel will be reported to the MacOS as "Page up/down" (mode 0) or
+    "Cursor up/down" (mode 1) keys.
+
+  mousewheellines <number of lines>
+
+    If "mousewheelmode" is set to mode 1 (Cursor up/down), this option sets
+    the number of key events sent to MacOS for each wheel movement (the
+    number of lines to scroll).
+
 AmigaOS:
 
   sound <sound output description>
@@ -633,6 +669,7 @@ Contributions by:
  - Bill Huey <billh@mag.ucsd.edu>: 15/16 bit DGA and 15/16/32 bit X11
    window support
  - David Lawrence <davidl@jlab.org>: incremental window refresh code
+ - Samuel Lander <blair_sp@hotmail.com>: tile-based window refresh code
  - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
    fbdev video code
  - and others...