--- uae/docs/README	2018/04/24 16:44:33	1.1.1.7
+++ uae/docs/README	2018/04/24 16:47:11	1.1.1.9
@@ -1,4 +1,4 @@
-This is version 0.8.7 of UAE, the Un*x Amiga Emulator.
+This is version 0.8.9 of UAE, the Un*x Amiga Emulator.
 
 Versions numbered 0.8.x are beta versions, to be used for development only.
 If you are only a user of UAE, you are better off using the latest 0.7.x
@@ -15,6 +15,9 @@ for UAE.
 See the file COPYING that is included in the top level directory of this
 archive for details.
 
+The SCSI code distributed with UAE is also available under the terms of the
+GPL and was written by J. Schilling.
+
 
 Overview
 ========
@@ -543,6 +546,45 @@ After that is complete, reboot, and you
 modes from the ScreenModes program.
 
 
+UAE SCSI device
+===============
+
+To enable SCSI support, use --enable-scsi-device when running configure.
+The emulator provides a uaescsi.device. This device only supports
+direct SCSI, which is sufficient to run applications like MakeCD. The
+device does not support reading or writing with the normal Exec commands,
+so you cannot mount filesystems on it right now.
+
+The unit numbers of the uaescsi.device follow the Amiga SCSI
+conventions: unit number "xyz" maps to the lun y of target z on bus
+x. Wide SCSI busses can have targets with numbers larger than 9. In
+this case the uaescsi.device pretends that there is another SCSI
+bus. To avoid confusion, all available SCSI targets are listed
+together with their unit number when starting UAE. Devices cannot be
+added while the emulator is running.  Reseting it is not sufficient
+either for technical reasons.
+
+The implementation of the uaescsi.device uses cdrecord's libscg as
+interface to the native SCSI system. Many implementations of this
+interface exist, although only the Linux implementation has been
+incorporated into UAE at the moment. Using threads is strongly
+recommended, because some SCSI commands can run for extended periods
+of time and would block the whole emulation during this time without
+threads. Use --enable-threads when starting configure.
+
+Depending on the hosts capabilities the uaescsi.device may be limited
+compared to other Amiga SCSI devices. The Linux kernel by default only
+allows 32KB of data per SCSI command and does not always perform SCSI
+requests in parallel.
+
+Setting the chunk size in MakeCD to 30KB is already too much and
+causes an IO error -4 (IOERR_BADLENGTH), because the setting is only
+used as a guideline. You can work around this by setting the Tooltypes
+BUFFER_CHUNK_XXX to 29. On a Pentium II 350MHz with Adaptec UW SCSI
+controller on board on-the-fly copying was possible from a Philips
+CDD2600 (SCSI) to a Yamaha CRW4416E (IDE) at 4x.
+
+
 The UAE_CONTROL program
 =======================
 
@@ -554,6 +596,15 @@ with Kick 2.0 and upwards. Copy these tw
 use for harddisk emulation. They should be self-explanatory.
 
 
+The timehack
+============
+
+Another tool in the "amiga" subdirectory, timehack, synchronizes the
+emulated Amiga's system time with the host's time every second. This
+is useful when the emulation is not done in real-time or is suspended
+completely.
+
+
 Quick overview of the debugger commands
 =======================================