--- hatari/doc/manual.html	2019/04/01 07:12:52	1.1.1.5
+++ hatari/doc/manual.html	2019/04/01 07:13:55	1.1.1.7
@@ -14,7 +14,7 @@
   <!--
 	body {  background-color:#FFFFFF;
 		color:#000000;
-           	margin-left:10px;
+		margin-left:10px;
 		margin-right:10px;
 		font-family:Verdana,Arial,Helvetica,sans-serif; font-size:12pt;
 		}
@@ -27,9 +27,9 @@
 	td { font-family:Verdana,Arial,Helvetica,sans-serif; font-size:12pt; }
 
 	a:link { color:#000099; background-color:#ffffff; text-decoration:none; }
- 	a:visited { color:#cc0000; background-color:#ffffff; text-decoration:none;}
- 	a:hover { color:#0000ff; background-color:#ffffff; text-decoration:none; }
- 	a:active { color:#993399; background-color:#ffffff; text-decoration:none; }
+	a:visited { color:#cc0000; background-color:#ffffff; text-decoration:none;}
+	a:hover { color:#0000ff; background-color:#ffffff; text-decoration:none; }
+	a:active { color:#993399; background-color:#ffffff; text-decoration:none; }
 
 	*.commandline { font-family:Fixed,Courier,monospace; font-size:11pt; }
 	*.file { color: #000088;}
@@ -48,7 +48,7 @@
 <h1 align="center">Hatari User's Manual</h1>
 
 <p align="center">
-Version 0.80
+Version 1.0
 </p>
 <p align="center">
 Project initiator and main developer of Hatari: <strong>Thomas Huth</strong>
@@ -66,7 +66,9 @@ Hatari on the WWW: <strong><a href="http
   <ul>
     <li><a href="#General description">General description</a>
     <li><a href="#Features">Features</a>
-    <li><a href="#Experimental STE hardware emulation:">Experimental STE hardware emulation</a>
+    <li><a href="#STE hardware emulation">STE hardware emulation</a>
+    <li><a href="#Very experimental TT hardware emulation">Very experimental TT hardware emulation</a>
+    <li><a href="#Very experimental Falcon hardware emulation">Very experimental Falcon hardware emulation</a>
     <li><a href="#System requirements">System requirements</a>
   </ul>
   <li><a href="#Compiling and running">Compiling and running</a>
@@ -102,19 +104,14 @@ Hatari on the WWW: <strong><a href="http
   </ul>
   <li><a href="#Floppy disk images">Floppy disk images</a>
   <li><a href="#Hard disk support">Hard disk support</a>
+  <ul>
+    <li><a href="#ACSI hard disk emulation">ACSI hard disk emulation</a></li>
+    <li><a href="#GEMDOS based hard disk emulation">GEMDOS based hard disk emulation</a></li>
+  </ul>
   <li><a href="#Appendix">Appendix</a>
   <ul>
     <li><a href="#Copying">Copying</a>
     <li><a href="#Introduction to Emulation">Introduction to Emulation</a>
-    <li><a href="#Software compatibility list">Software compatibility list</a>
-    <ul>
-      <li><a href="#ST games">ST games</a>
-      <li><a href="#ST demos">ST demos</a>
-      <li><a href="#ST applications">ST applications</a>
-      <li><a href="#STE games">STE games</a>
-      <li><a href="#STE demos">STE demos</a>
-      <li><a href="#STE applications">STE applications</a>
-    </ul>
   </ul>
 </ul>
 
@@ -123,10 +120,11 @@ Hatari on the WWW: <strong><a href="http
 
 <a name="General description"></a><h3>General description</h3>
 <p>
-Hatari is an Atari ST emulator for Linux, FreeBSD, BeOS and other
-Systems which are supported by the SDL library.
+Hatari is an Atari ST, STE, TT and Falcon emulator for Linux, FreeBSD, BeOS and
+other Systems which are supported by the SDL library.
 The emulator is open source software and is distributed under the terms of the
-GNU General Public License (GPL).
+<a href="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html">GNU General
+Public License (GPL)</a>.
 </p>
 <p>
 The Atari ST was a 16/32 bit computer system which was first released by Atari
@@ -139,59 +137,85 @@ Unlike many other Atari ST emulators whi
 environment for running GEM applications, Hatari tries to emulate the hardware
 of a ST as close as possible so that it is able to run most of the old ST games
 and demos. Of course you can run normal GEM applications with Hatari, too.
+Recent versions of Hatari even feature basic STE, TT and Falcon emulation.
 </p>
 
 <a name="Features"></a><h3>Features</h3>
 <ul>
-  <li>complete m68k emulation via UAE's CPU core</li>
-  <li>support for TOS 1.00, 1.02, 1.04, 1.06, 1.62, 2.05, 2.06 and EmuTOS</li>
-  <li>ST RAM size variable (512k, 1MB, 2MB and 4MB possible)</li>
+  <li>68000 - 68040 emulation via the UAE CPU core (no PMMU support though)</li>
+  <li>support for all known TOS versions (including EmuTOS)</li>
+  <li>ST RAM size variable (from 512kiB up to 14MiB are possible)</li>
   <li>optional cartridge images for the ST ROM port</li>
   <li>most of the ST specific hardware</li>
   <li>ST Shifter with ST-High, ST-Medium and ST-Low resolutions,
-overscan effects for lower border and partially in the upper, left and
-right border too</li>
-  <li>512 colour ST palette</li>
+    overscan effects for all borders in color resolutions</li>
+  <li>512 color ST palette</li>
+  <li>many raster effects </li>
+  <li>scaling of ST-low resolution by factor two</li>
+  <li>interleaved lines rendering of ST-medium and (scaled) ST-low
+    resolutions for the TV "monitor type"</li>
   <li>Blitter chip emulation (not very accurate)</li>
   <li>PSG YM2149 emulation (soundchip) including STFM samples</li>
   <li>Printer emulation on GEMDOS and Hardware level (print to file)</li>
   <li>experimental support for RS232</li>
-  <li>extremely experimental MIDI support</li>
+  <li>experimental MIDI output support (no MIDI input/through support)</li>
   <li>Mega ST real time clock</li>
-  <li>many (but not all) raster effects </li>
   <li>IKBD emulation (keyboard, mouse and joystick) with custom
-keyboard mapping</li>
+    keyboard mapping</li>
   <li>joystick emulation via cursor keys and joystick emulation via a
-connected PC joystick</li>
+    connected PC joystick</li>
   <li>FDC emulation using floppy disk images in standard formats (*.ST,
-*.MSA
-and *.DIM)</li>
-  <li>optional writeprotection for disk images</li>
+    *.MSA and *.DIM)</li>
   <li>support for packed disk images (PkZip and Gzip)</li>
+  <li>optional write-protection for disk images</li>
   <li>partial ACSI emulation for harddisk support</li>
   <li>GEMDOS interface driver to mount a directory as a harddrive</li>
-  <li>experimental support for memory snapshots</li>
+  <li>support for memory snapshots (save whole system state)</li>
   <li>driver for extended VDI resolutions</li>
   <li>recording of sound as .WAV and .YM files</li>
   <li>screenshots in .BMP format</li>
   <li>animation capturing</li>
-  <li>interlaced rendering of ST-Low and ST-Medium resolutions </li>
-  <li>scaling of ST-Low and ST-Medium to 800x600 resolution </li>
+  <li>TOS versions 1.00, 1.02, 1.04 and 2.06 can be used in ST mode.</li>
 </ul>
 
-<a name="Experimental STE hardware emulation:"></a><h4>Experimental STE hardware emulation:</h4>
-STE emulation is still considered as instable, but if you dare to use it,
-there is support for most of the enhanced STE features:
+<a name="STE hardware emulation"></a>
+<h4>STE hardware emulation</h4>
+STE emulation is still a little bit experimental, but basically
+there is support for most of the enhanced/additional STE features:
 <ul>
   <li>horizontal and vertical hardware fine scrolling</li>
   <li>split screen techniques / in-screen video address manipulations</li>
+  <li>(STE specific) right border opening</li>
   <li>4096 colors STE palette</li>
-  <li>DMA sample sound</li>
+  <li>DMA sample sound ("microwire" audio balance support missing)</li>
+  <li>STE joypads</li>
+  <li>TOS versions 1.06, 1.62, 2.05 and 2.06 can be used in STE mode.</li>
 </ul>
 
-<p>
-At the time of this writing there is neither a complete MMU emulation
-nor support for TT or Falcon specific features.
+<a name="Very experimental TT hardware emulation"></a>
+<h4>Very experimental TT hardware emulation</h4>
+There is support for following additional TT features:
+<ul>
+  <li>TT low/med/high resolution support</li>
+  <li>ST/TT palette switching and video shifter</li>
+  <li>RAM upto 14MiB (ST-RAM only, there is no support for TT-RAM yet)</li>
+  <li>Only TOS version 3.06 can be used in TT mode.</li>
+</ul>
+
+<a name="Very experimental Falcon hardware emulation"></a>
+<h4>Very experimental Falcon hardware emulation</h4>
+There is support for following additional Falcon features:
+<ul>
+  <li>Videl emulation for all Falcon screen modes</li>
+  <li>STE/Falcon palette switching and shifter</li>
+  <li>Mono/RGB/VGA/TV monitor types</li>
+  <li>Some few parts of the Falcon sound system are emulated
+      (e.g. the additional sample rates of the DMA sound)</li>
+  <li>TOS versions 4.00, 4.02, 4.04 and 4.92 can be used in Falcon mode.</li>
+</ul>
+
+<p>DSP is not emulated, but there's a dummy mode with which some
+additional demos work.
 </p>
 
 
@@ -199,7 +223,7 @@ nor support for TT or Falcon specific fe
 
 <p> Hatari currently has the following system requirements: </p>
 <ul>
-  <li>a fast PC (&gt;300MHz) </li>
+  <li>a fast PC (&gt;500MHz, for Falcon and TT emulation even faster) </li>
   <li>some sort of Unix (preferable <a href="http://www.linux.org/">GNU/Linux</a>)
   </li>
   <li>the SDL library (<a href="http://www.libsdl.org/">http://www.libsdl.org/</a>)</li>
@@ -224,7 +248,8 @@ the following systems:
 FreeBSD 5.1 </li>
   <li>OpenBSD 3.5 </li>
   <li>Solaris 8 on a SUN UltraSparc 1</li>
-  <li>Zaurus SL-C760 PDA </li>
+  <li>Zaurus SL-C760 PDA</li>
+  <li>Nokia 770 and N800 Internet Tablets</li>
 </ul>
 
 <a name="Compiling and running"></a><h2>Compiling and running</h2>
@@ -266,15 +291,18 @@ in the src/ subdirectory.
 
 <a name="Installation of a TOS ROM"></a><h3>Installation of a TOS ROM</h3>
 
-<p> Then you'll have to copy a TOS ROM to the data directory (the data
-directory is specified
+<p>
+Before you can start Hatari, you have to copy a TOS ROM image to the data
+directory (the data directory is specified
 in the configuration file <span class="file">Makefile.cnf</span>) and
 rename it to <span class="commandline">tos.img</span>, or use the
 <span class="commandline">--tos</span> command line option to tell
 Hatari where to find a TOS ROM.
 Hatari needs a TOS ROM image because this contains the operating system
-of the emulated Atari.</p>
-<p> Sorry, it is not possible to ship an original ROM
+of the emulated Atari.
+</p>
+<p>
+Unfortunately it is not possible to ship an original ROM
 image with the Hatari package since these images are still copyrighted.
 But you can easily create an image with a real ST and one of those various
 ROM-image programs for the ST (search for &quot;TOSDUMP&quot; with your
@@ -316,129 +344,229 @@ to toggle windowed and fullscreen mode.
 
 <a name="Command line options"></a><h2>Command line options</h2>
 
-<p> Hatari ofcourse understands several command line options. </p>
-<p> Type <span class="commandline">hatari --help</span> to list them
-all. </p>
-<p> The command line options in detail are as follows (in brackets the
-long version): </p>
+<p>Usage:</p>
+<pre>
+ hatari [options] [disk image name]
+</pre>
+
+<p>The command line options are following
+(the long version is in parenthesis): </p>
 <table border="1" cellpadding="3">
   <tbody>
+
     <tr class="backdropped">
-      <td align="center">Option</td>
-      <td align="center">Purpose</td>
+      <th align="center">General options</th>
+      <th>Description</th>
     </tr>
     <tr>
       <td align="center">-h (--help)</td>
-      <td align="center">prints command line options and terminates</td>
+      <td>Prints command line options and terminates</td>
     </tr>
     <tr>
       <td align="center">-v (--version)</td>
-      <td align="center">prints version information and terminates</td>
+      <td>Prints version information and terminates</td>
+    </tr>
+    <tr>
+      <td align="center">--confirm-quit &lt;x&gt;</td>
+      <td>Confirm Hatari quitting (x = y/n)</td>
+    </tr>
+    <tr>
+      <td align="center">-c &lt;file&gt;<br>(--configfile &lt;file&gt;)</td>
+      <td>Use the given file as configuration file
+        instead of ~/.hatari/hatari.cfg</td>
+    </tr>
+
+    <tr class="backdropped">
+      <th align="center">Display options</th>
+      <th>Description</th>
     </tr>
     <tr>
       <td align="center">-m (--mono)</td>
-      <td align="center">starts the emulated Atari ST in monochrome
-resolution</td>
+      <td>Starts the emulated Atari ST in monochrome
+        resolution (deprecated)</td>
+    </tr>
+    <tr>
+      <td align="center">--monitor &lt;x&gt;</td>
+      <td>Select monitor type (x = mono/rgb/vga/tv)</td>
     </tr>
     <tr>
       <td align="center">-f (--fullscreen)</td>
-      <td align="center">tries to use a fullscreen mode</td>
+      <td>Start in fullscreen mode</td>
     </tr>
     <tr>
       <td align="center">--window</td>
-      <td align="center">forces Hatari to use a windowed mode</td>
+      <td>Forces Hatari to use a windowed mode</td>
     </tr>
     <tr>
-      <td align="center">-j (--joystick)</td>
-      <td align="center">activates joystick emulation via cursor keys</td>
+      <td align="center">-z &lt;x&gt;<br>(--zoom &lt;x&gt;)</td>
+      <td>Doubles ST low resolution (1=no, 2=yes)</td>
     </tr>
     <tr>
-      <td align="center">--nosound</td>
-      <td align="center">disables sound (makes emulation faster)</td>
+      <td align="center">--frameskips &lt;x&gt;</td>
+      <td>Shows only every &lt;x&gt; frame (speeds up emulation!)</td>
     </tr>
     <tr>
-      <td align="center">--frameskip</td>
-      <td align="center">drops every second frame (accelerates
-emulation)</td>
+      <td align="center">--borders &lt;bool&gt;</td>
+      <td>Show screen borders (for overscan demos etc.)</td>
     </tr>
     <tr>
-      <td align="center">-D (--debug)</td>
-      <td align="center">activates the simple builtin debugger</td>
+      <td align="center">--spec512 &lt;x&gt;</td>
+      <td>Use threshold x to decide when to render a screen with the slower
+         but more<br> accurate Spectrum512 screen conversion functions
+         (0 <= x <= 512, 0=disable)</td>
     </tr>
     <tr>
-      <td align="center">--slowfdc</td>
-      <td align="center">slows down FDC emulation (needed to make some
-games and demos work)</td>
+      <td align="center">--bpp &lt;x&gt;</td>
+      <td>Force color bitdepth (x=8/16/32, 0=autodetection)</td>
+    </tr>
+
+    <tr class="backdropped">
+      <th align="center">VDI options</th>
+      <th>Description</th>
     </tr>
     <tr>
-      <td align="center">-d &lt;dir&gt; (--harddrive &lt;dir&gt;)</td>
-      <td align="center">emulates &lt;dir&gt; as a hard disk</td>
+      <td align="center">--vdi-planes</td>
+      <td>Specify extended VDI resolution bit-depth, x = 1/2/4</td>
     </tr>
     <tr>
-      <td align="center">--hdimage &lt;imagefile&gt;</td>
-      <td align="center">emulate hard disk with an image file<br>
-      </td>
+      <td align="center">--vdi-width &lt;w&gt;</td>
+      <td>Specify extended VDI resolution width
+      (320 &lt; w &lt;= 1024, multiple of 128)</td>
     </tr>
     <tr>
-      <td style="text-align: center;">--cartridge &lt;imagefile&gt;<br>
-      </td>
-      <td style="text-align: center;">sets imagefile as the cartridge
-on the ROM port<br>
-This currently does not work together with GEMDOS hard disk emulation!<br>
-      </td>
+      <td align="center">--vdi-height &lt;h&gt;</td>
+      <td>Specify extended VDI resolution height
+      (200 &lt; h &lt;= 768, multiple of text height)</td>
+    </tr>
+
+    <tr class="backdropped">
+      <th align="center">Device options</th>
+      <th>Description</th>
     </tr>
     <tr>
-      <td align="center">--tos &lt;imagefile&gt;</td>
-      <td align="center">specify TOS ROM image to use</td>
+      <td align="center">-j &lt;port&gt;<br>(--joystick &lt;port&gt;)</td>
+      <td>Activates joystick emulation via cursor keys
+         for given joystick "port"<br>(0-5, see joystick dialog)</td>
     </tr>
     <tr>
-      <td align="center">--memsize x</td>
-      <td align="center">set amount of emulated RAM<br>
-x=0 for 512K, x=1,x=2 or x=4 for 1,2 or 4 MB</td>
+      <td align="center">--printer &lt;file&gt;</td>
+      <td>Enable printer support and write data to the specified file</td>
     </tr>
     <tr>
-      <td align="center">--cpulevel x</td>
-      <td align="center">specify CPU (680x0) to use
-         (works on TOS 2.06 only!!)</td>
+      <td align="center">--midi &lt;file&gt;</td>
+      <td>Enable MIDI output and write midi data to the specified file</td>
     </tr>
     <tr>
-      <td align="center">--compatible</td>
-      <td align="center">use a more compatible but slower 68000 CPU mode</td>
+      <td align="center">--rs232 &lt;file&gt;</td>
+      <td>Enable RS232 communication via the specified file</td>
+    </tr>
+
+    <tr class="backdropped">
+      <th align="center">Disk options</th>
+      <th>Description</th>
+    </tr>
+    <tr>
+      <td align="center">-d &lt;dir&gt;<br>(--harddrive &lt;dir&gt;)</td>
+      <td>Emulates a hard disk at the GEMDOS level
+         (&lt;dir&gt; = root directory)</td>
     </tr>
     <tr>
-      <td align="center">--blitter</td>
-      <td align="center">enable blitter emulation (for ST mode only)</td>
+      <td align="center">--acsi &lt;imagefile&gt;</td>
+      <td>Emulate an ACSI hard disk with an image file</td>
     </tr>
     <tr>
-      <td align="center">--vdi</td>
-      <td align="center">use extended VDI resolution</td>
+      <td align="center">--slowfdc &lt;bool&gt;</td>
+      <td>Slow down FDC emulation (deprecated)</td>
+    </tr>
+
+    <tr class="backdropped">
+      <th align="center">Memory options</th>
+      <th>Description</th>
     </tr>
     <tr>
-      <td align="center">--printer</td>
-      <td align="center">enable experimental printer support</td>
+      <td align="center">-s &lt;x&gt;<br>(--memsize &lt;x&gt;)</td>
+      <td>set amount of emulated RAM upto 14MB<br>
+        x=0 for 512K, x=1,x=2 or x=4 for 1, 2 or 4 MB</td>
     </tr>
     <tr>
-      <td align="center">--midi &lt;filename&gt;</td>
-      <td align="center">enable experimental MIDI output to the
-mentioned file</td>
+      <td align="center">--tos &lt;imagefile&gt;</td>
+      <td>Specify TOS ROM image to use</td>
     </tr>
     <tr>
-      <td align="center">--rs232 &lt;filename&gt;</td>
-      <td align="center">enable experimental RS232 communication via
-the mentioned file</td>
+      <td align="center">--cartridge &lt;file&gt;</td>
+      <td>Use file as the cartridge on the ROM port.<br>
+        This currently does not work together with GEMDOS hard disk emulation!</td>
     </tr>
     <tr>
-      <td align="center">-c &lt;filename&gt; (--configfile)</td>
-      <td align="center">Use the mentioned file as configuration file
-instead of ~/.hatari.cfg</td>
+      <td align="center">--memstate &lt;file&gt;</td>
+      <td>Load memory snap-shot file</td>
+    </tr>
+
+    <tr class="backdropped">
+      <th align="center">CPU options</th>
+      <th>Description</th>
+    </tr>
+    <tr>
+      <td align="center">--cpulevel &lt;x&gt;</td>
+      <td>Set the CPU type (x =&gt; 680x0) &mdash;
+         works with EmuTOS / TOS 2.06 only!</td>
+    </tr>
+    <tr>
+      <td align="center">--cpuclock &lt;x&gt;</td>
+      <td>Set the CPU frequency in MHz (8, 16 or 32)</td>
+    </tr>
+    <tr>
+      <td align="center">--compatible &lt;bool&gt;</td>
+      <td>Use a more compatible but slower 68000 CPU mode</td>
+    </tr>
+
+    <tr class="backdropped">
+      <th align="center">Misc system options</th>
+      <th>Description</th>
     </tr>
     <tr>
       <td align="center">--machine &lt;x&gt;</td>
-      <td align="center">Select machine type (x = st or ste)</td>
+      <td>Select machine type (x = st/ste/tt/falcon)</td>
+    </tr>
+    <tr>
+      <td align="center">--blitter &lt;bool&gt;</td>
+      <td>Use blitter emulation (for ST only)</td>
+    </tr>
+    <tr>
+      <td align="center">--dsp &lt;x&gt;</td>
+      <td>Select DSP type (Falcon only, x = none/dummy(/emu))</td>
+    </tr>
+    <tr>
+      <td align="center">--sound &lt;x&gt;</td>
+      <td>Sound quality (x = off/low/med/hi)</td>
+    </tr>
+    <tr>
+      <td align="center">-k &lt;file&gt;<br>(--keymap &lt;file&gt;)</td>
+      <td>Read (additional) keyboard mapping from file</td>
+    </tr>
+
+    <tr class="backdropped">
+      <th align="center">Debug options</th>
+      <th>Description</th>
+    </tr>
+    <tr>
+      <td align="center">-D (--debug)</td>
+      <td>Activates the simple builtin debugger</td>
+    </tr>
+    <tr>
+      <td align="center">--log &lt;file&gt;</td>
+      <td>Direct log output to the specified file</td>
+    </tr>
+    <tr>
+      <td align="center">--trace &lt;type1,...&gt;</td>
+      <td>Activate debug traces, use --trace help to see the options</td>
     </tr>
   </tbody>
 </table>
 
+<p>Type <span class="commandline">hatari --help</span> to list all
+the command line options supported by a given version of Hatari.</p>
+
 <a name="Using the emulated system"></a><h2>Using the emulated system</h2>
 
 <p> Once you've started Hatari succesfully, you can use the emulator as
@@ -481,13 +609,56 @@ that you have made.</p>
 <img src="images/system.png" width="360" height="368" alt="Hatari's GUI - the system dialog">
 </div>
 
-<p>Select the CPU type to use here. For best Atari ST compatibility choose a
- plain 68000.</p>
-<p>Choose whether you want to emulate a normal ST or an STE.
- <em>Note:</em> STE emulation is very incomplete. It may not work very well.</p>
-<p>For STE emulation a STE compatible TOS image, e.q. version 1.06, 1.62 or 2.x, is strongly recommended.</p>
-<p>Select the CPU clock you want to use. 8Mhz is ST standard and the most
- compatible, 16MHz is for Mega STE emulation.</p>
+<p>
+ First you can select the CPU type here. Here are some important hints for
+ choosing the correct CPU type:
+</p>
+<ul>
+ <li>
+  Atari ST and STE have only been shipped with a 68000 CPU, so for best
+  compatibility with old programs, choose this CPU type.
+ </li>
+ <li>
+  Atari TT and Falcon computers were using the 68030 CPU, so you should switch
+  either to 68020 or 68020+FPU when you want to use TT or Falcon mode.
+  (The 68020 and 68030 were pretty much the same apart from some minor details).
+ </li>
+ <li>
+  TOS 1.0x only works with 68000, while TOS 3.0x and 4.0x work only with a CPU
+  &gt;= 68020.
+ </li>
+ <li>
+  68010 and 68040 have never been used in official Atari computers, so don't
+  use these CPU types unless you've got some good reasons.
+ </li>
+</ul>
+
+<p>
+ Beside the CPU type, you can also choose the machine type to emulate.
+ The ST was the very first 16/32-bit computer from Atari. Most older games
+ and demos require an ST. The STE was introduced some years later and had
+ some more advanced hardware features. There are not that many demos or
+ games that really require an STE but since most normal ST games/demos also
+ work with an STE, it's normally safe to always work in STE mode.
+ <br>
+ TT and Falcon are more advanced, but they are not as compatible to the ST as
+ the STE was. So many old games and demos do not work with these machine types
+ anymore. There were only very few programs that were made for the TT
+ exclusively, while there were some interesting games and demos specially made
+ for the Falcon.
+ <em>Note:</em> TT and Falcon emulation are very incomplete. They may not work
+ very well.
+</p>
+<p>
+ For STE emulation a STE compatible TOS image, e.q. version 1.06, 1.62 or
+ 2.x, is strongly recommended. For TT emulation you need TOS 3.0x and for Falcon
+ emulation you need TOS 4.0x. EmuTOS can be used on all machine types.
+</p>
+<p>
+ Select the CPU clock you want to use. 8Mhz is ST standard and the most
+ compatible. Use 16MHz for Mega STE and Falcon emulation.
+ The CPU in the TT was clocked with 32 MHz.
+</p>
 <p>With the &quot;Slower but more compatible CPU&quot; option, you can enable
  the emulation of 68k address errors and the CPU prefetch buffer. This is needed
  for best compatibility, but it slows down emulation a little bit so you can
@@ -502,7 +673,7 @@ that you have made.</p>
 <p>The Timer-D patch changes the Timer-D initialization from TOS. TOS uses
  the MFP timer D as a baudrate generator for RS232. However, the TOS default
  value slows down the emulation. The patch gives you a better performance.
- It is normally save to enable the patch, but if you encounter a program that
+ It is normally safe to enable the patch, but if you encounter a program that
  does not work, you can try to disable the patch to see if it works then.</p>
 <p>Select if you want to use slow FDC emulation. Slow is more compatible esp.
  with games and demos that use custom loaders.</p>
@@ -539,15 +710,16 @@ from the emulated drive. The emulated ST
 disk in its drive.</p>
 <p>You can specify a default directory where Hatari will start to
 browse the filesystem.</p>
-<p>Check the "Auto insert B" option if you want Hatari to be smart and
-insert the second disk
-of a two disk game automatically. This option will insert the second
-disk in drive B and some
-games may not be able to find the disks there. In that rare case you
-will need to insert the
-second disk manually when prompted.</p>
 <p>
-<em>NOTE:</em> This option does not always work properly.
+Check the "Auto insert B" option if you want Hatari to be smart and
+insert the second disk of a two disk game automatically.
+Some games then use the second drive automatically.
+In the case that a game is not able to find the disk in the second drive,
+you have to insert the second disk in drive A: manually when prompted.
+<br>
+<em>NOTE:</em> This option only works properly if the file name of the
+first disks ends with an 'a' before the extension and the second disk name
+ends with a 'b'.
 </p>
 <p>If you need to create a new blank disk image, click on <span
  class="button">Create disk image</span>.
@@ -610,13 +782,26 @@ You can also select an optional cartridg
  class="button">Browse</span> to select one via the fileselector. Click on <span
  class="button">Eject</span> to disconnect the custom cartridge image.
 </p>
-<p>Keep in mind that any custom cartridge image will not work together with
+<p>
+For ST mode, use TOS 1.00, 1.02, 1.04 or 2.06.
+For STE mode, use TOS 1.06, 1.62, 2.05 or 2.06.
+If you want to use the TT mode, you must specify a TOS 3.06 image here.
+And in Falcon mode, you have to use either TOS 4.00, 4.02, 4.04 or 4.92.
+However, you should always use TOS 4.04 for Falcon mode, it's the most common one.
+Also note that TOS 4.92 can not be booted from a boot disk (like it's done on a
+real Falcon), you have to specify it directly in the TOS ROM setup dialog here.
+</p>
+<p>
+Keep in mind that any custom cartridge image will not work together with
 GEMDOS hard disk emulation or the VDI extended resolution emulation
 since some additional driver code will be used in the cartridge memory
-space for these emulations.<br>
-<p><em>Note:</em> These options are critical and you are strongly
+space for these emulations.
+</p>
+<p>
+<em>Note:</em> These options are critical and you are strongly
 advised to reset the emulated ST
-when changing one of these option.</p>
+when changing one of these option.
+</p>
 
 <a name="The Joystick Dialog"></a><h4>The Joystick Dialog</h4>
 
@@ -652,33 +837,57 @@ certain games. In some other games, it g
 
 <a name="The Screen Dialog"></a><h4>The Screen Dialog</h4>
 
-<div class="image" align="center">
-<img src="images/screen.png" width="768" height="534" alt="Hatari's GUI - the screen dialog">
+<div class="floatimage">
+<img src="images/screen.png" width="500" height="400" alt="Hatari's GUI - the screen dialog">
 </div>
 
-<p>Here you control the video output of the emulated ST.</p>
-<p>Check "Fullscreen" to run Hatari fullscreen, default is windowed.</p>
-<p>Check "Interleaved mode" if you wish to have that old TV feeling in
-Hatari. Every second line will be black.
-This will only work in ST-MEDIUM or ST-LOW in scaled up resolutions.</p>
-<p>Check "Frame Skip" to speed Hatari up if emulation is too slow. This
-will only draw every second ST frame
-instead of the default of drawing every ST frame. Uncheck if you have a
-fast PC.</p>
-<p>Check "Use Borders" if you wish to have the borders around the ST
-screen.</p>
-<p>"Force 8Bpp" will force SDL to use an 8bit video mode. You don't
-need this for modern video cards.</p>
-<p>You can select which sort of monitor to use. Check "Color" for games
-and demos. If you check "Mono" here,
-Hatari will emulate the good old SM124 and will not allow you to switch
-to color modes from the running ST.
-This toggle acts like a monitor switch with a color and monochrome
-monitor connected.</p>
-<p>"Zoom ST-Low res." will control if Hatari renders ST-LOW to a
-320x200 or 640x400 PC display (with borders turned off) or 384x267 or
-768x534.
-Basically select this to toggle between a small or a large window.</p>
+<p>
+ Here you control the video output of the emulated Atari.
+</p>
+<p>
+ Check &quot;Fullscreen&quot; to run Hatari fullscreen, default is windowed.
+</p>
+<p>
+ &quot;Use Borders&quot; toggles the displaying of the borders around the ST
+ screen. Some few demos/games use the borders for displaying additional
+ graphics. However, when you enable this option, it increases CPU computing
+ time, so you should not enable it if you have a slow computer.
+ Please note that this option also only affects the ST and STE mode, TT and
+ Falcon modes are always displayed without borders.
+</p>
+<p>
+ &quot;Zoom ST-Low res.&quot; controls whether Hatari doubles the low
+ resolutions. For example Hatari then zooms the ST low resolution 320x200 to
+ 640x400 and it doubles 384x267 (ST low with borders) to 768x534.
+ Note that zooming also takes a lot of CPU computing time and should not be
+ enabled on slow computers.
+</p>
+<p>
+ &quot;Force 8Bpp&quot; will force Hatari to use an 8bit video mode.
+ You don't need this for modern video cards.
+</p>
+<p>
+ The &quot;Frame Skip&quot; option can be set to speed up the emulator
+ if it is running too slow on your system. 1 to 8 frames will be dropped
+ after each frame that has been drawn. Disable frame-skip if you have a
+ fast computer.
+</p>
+<p>
+ You can select which sort of monitor to use. This option depends on the
+ machine type which you have selected in the &quot;System options&quot;
+ dialog. In ST and STE mode, you can choose between monochrome mode (select
+ &quot;Mono&quot;) and color mode (select one of the other monitor types).
+ Note that when you select &quot;TV&quot; and use zoomed low resolution or
+ switch to ST medium resolution, you will get a TV-like screen rendering
+ which is a little bit faster but darker compared to the normal &quot;RGB&quot;
+ monitor mode. Switching between mono and a color monitor acts like a monitor
+ switch on a real ST - so beware, this will reboot your emulated system!<br>
+ In TT mode, you can only choose between TT-high resolution (&quot;Mono&quot;)
+ and normal modes (select one of the other monitor types).
+ Finally the Falcon mode supports all four types of monitors. Note that most
+ Falcon demos/games require a RGB or TV mode and do not work with VGA.
+</p>
+<p>
 Extended GEM resolutions will emulate some sort of extended graphics
 card in the emulated ST giving you larger resolutions and a higher
 colordepth in GEM. Select a resolution and color depth. Check to
@@ -686,7 +895,8 @@ activate. It will disable all other vide
 Uncheck to get back to a normal ST behaviour.<br>
 <em>Note:</em> Using an extended resolution will only work with GEM
 conformant applications. 99% of all games and demos will not run if you
-activate any extended resolution here.<br>
+activate any extended resolution here.
+</p>
 <p>Click <span class="button">Capture Screen</span> to create a
 screenshot in .BMP format to the current working directory or click <span
  class="button">Record Animation</span> to record a sequence of single
@@ -714,9 +924,10 @@ screen content really changed.
  mapping. Note that you also need a TOS version with the right language
  (e.g. use a French TOS if you are using a French keyboard).</p>
 <p>You can also load a custom keyboard mapping file here if you wish. Please
- note that the custom keyboard mapping will use the &quot;symbolic&quot; mapping
- for all keys that are not defined by your map file. Have a look at the supplied
- example mapfile to see how to create your own keyboard mapping.</p>
+ note that the custom keyboard mapping will use the &quot;symbolic&quot;
+ mapping for all keys that are not defined by your map file. Have a look
+ at the supplied example mapfile (keymap-sample.txt) to see how to create
+ your own keyboard mapping.</p>
 
 <a name="The Sound Dialog"></a><h4>The Sound Dialog</h4>
 
@@ -773,7 +984,8 @@ Don't enable them unless you really need
 <a name="Keyboard shortcuts"></a><h3>Keyboard shortcuts</h3>
 
 <p> While the emulator is running, you can activate or toggle various
-features via the following keyboard shortcuts. </p>
+features via Hatari keyboard shortcuts. Below are listed the default
+shortcut key bindings:</p>
 <table border="1" cellpadding="3">
   <tbody>
     <tr class="backdropped">
@@ -795,7 +1007,8 @@ window</td>
     </tr>
     <tr>
       <td align="center"><span class="key">ALTGR+j</span></td>
-      <td align="center">activates joystick emulation via cursor keys</td>
+      <td align="center">toggles joystick emulation via cursor keys
+between port 0, port 1 and being off from those ports</td>
     </tr>
     <tr>
       <td align="center"><span class="key">ALTGR+m</span></td>
@@ -827,6 +1040,14 @@ switch)</td>
       <td align="center">enable/disable sound recording</td>
     </tr>
     <tr>
+      <td align="center"><span class="key">ALTGR+k</span></td>
+      <td align="center">save memory snapshot</td>
+    </tr>
+    <tr>
+      <td align="center"><span class="key">ALTGR+l</span></td>
+      <td align="center">load memory snapshot</td>
+    </tr>
+    <tr>
       <td align="center"><span class="key">ALTGR+f or F11</span></td>
       <td align="center">toggles fullscreen and windowed mode</td>
     </tr>
@@ -842,6 +1063,11 @@ switch)</td>
   </tbody>
 </table>
 
+<p>You can change the key bindings from the Hatari configuration file.
+The required key values you can see from the SDL_keysym.h include file
+(usually in /usr/include/SDL/).
+
+
 <a name="Emulated Atari ST keyboard"></a><h3>Emulated Atari ST keyboard</h3>
 
 <p> All other keys on the keyboard act as the normal Atari ST keys so
@@ -899,6 +1125,7 @@ the Hatari window. Do this by pressing t
 hotkey combination.
 Press it again to go back to normal mouse behaviour which allows you to
 work in other X11 windows while Hatari is up and running. </p>
+<p>Mouse scrollwheel will act as cursor up and down keys. </p>
 
 <a name="Emulated joystick"></a><h3>Emulated joystick</h3>
 
@@ -927,12 +1154,12 @@ along with the cursorkeys. </p>
 <a name="Emulated video"></a><h3>Emulated video</h3>
 
 <p>Hatari by default only handles ST modes, ST-LOW, ST-MED and ST-HIGH.</p>
-<p>Overscan effects and socalled "Border Removal" are possible too.</p>
+<p>Overscan effects and so called "Border Removal" are possible too.</p>
 <p>Due to the fact that these effects are achieved by using quirks and
 glitches in the original chips to do things beyond their specification
 emulation is a bit tricky for these and not all ST applications
 utilizing these techniques will work properly in Hatari.
-Especially socalled "Sync Scrolling", a special technique to emulate
+Especially so called "Sync Scrolling", a special technique to emulate
 the low byte of the video address, currently does not work properly in
 Hatari.
 </p>
@@ -1046,12 +1273,30 @@ a zipped disk image.</p>
 
 <p>Hatari supports two ways of emulating a ST hard drive: The low-level
 ACSI hard disk emulation and a GEMDOS based drive emulation. </p>
-<p>To use the ACSI hard disk emulation, you need a hard disk image file
+
+<a name="ACSI hard disk emulation"></a><h3>ACSI hard disk emulation</h3>
+<p>
+To use the ACSI hard disk emulation, you need a hard disk image file
 with a pre-installed HD driver in it. So either try to image your old
-ST
-hard disk or grab one from the internet. There is a HD image on the
-Hatari web page for download. Perhaps we'll also provide a tool for
-creating HD images one day. </p>
+ST hard disk or grab one from the internet (e.g. from the Hatari website).
+Please note that AHDI 5.0 is the <em>only</em> hard disk driver that
+is currently working and supported. Other hard disk drivers likely will not
+work.
+</p>
+<p>
+To create a new ACSI hard disk image, you can start with an empty image that
+you have for example created with the following command:
+<span class="commandline">dd if=/dev/zero of=hd.img bs=512 count=xxx</span>.
+Then copy the complete AHDI 5.0 package to a floppy disk image, and enable
+this floppy disk image and the fresh hard disk image in the emulator.
+Start HDX.PRG from the floppy disk and format and partition the hard disk
+with this tool. When you're finished, you have to restart the emulated system,
+run AHDI.PRG from the floppy disk and HINSTALL.PRG afterwards.
+With HINSTALL.PRG you can install the hard disk driver to the fresh HD image,
+so you can directly boot from the hard disk image in the future.
+</p>
+
+<a name="GEMDOS based hard disk emulation"></a><h3>GEMDOS based hard disk emulation</h3>
 <p>With the GEMDOS based drive emulation, you can easily "mount" a
 folder from the host file system to a drive of the emulated Atari. To
 use the GEMDOS based drive emulation, you should use a folder on your
@@ -1075,7 +1320,11 @@ GEMDOS drive emulation. </p>
 <p> Note that changing the HD-image or the GEMDOS HD-folder will reset
 the emulated Atari since it is not possible to switch the hard disk
 while the emulator is running. </p>
-<p> May the fun without the price to be with you ;-) ! </p>
+
+<p>
+That's all for the moment.
+May the fun without the price to be with you ;-) !
+</p>
 
 <a name="Appendix"></a><h2>Appendix</h2>
 
@@ -1137,737 +1386,6 @@ emulation of the various custom chips an
 parts of the emulated system is much trickier.
 </p>
 
-<a name="Software compatibility list"></a><h3>Software compatibility list</h3>
-
-<p>This is a little compilation of what Atari software does work in
-Hatari. It is by no means finished.</p>
-
-<p>First is listed software (games, demos and applications) that work
-on normal STs, after them is listed STE only software that has been
-tested with the current STE hardware emulation.</p>
-
-<a name="ST games"></a><h4>ST games</h4>
-
-<table border="1" cellpadding="3">
-  <caption align="bottom">tested games</caption> <tbody>
-    <tr class="backdropped">
-      <td align="center">Game</td>
-      <td align="center">Working</td>
-      <td align="center">Sound</td>
-      <td align="center">Comment</td>
-    </tr>
-    <tr>
-      <td>Eliminator</td>
-      <td>yes</td>
-      <td>perfect</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Speedball</td>
-      <td>yes</td>
-      <td>perfect</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Xenon</td>
-      <td>yes</td>
-      <td>music ok - fx dodgy</td>
-      <td>bullets and explosions sound weired</td>
-    </tr>
-    <tr>
-      <td>Bubble Bobble</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>F15 Strike Eagle 2</td>
-      <td>yes</td>
-      <td>ok</td>
-      <td>keyboard emulation seems to be dodgy</td>
-    </tr>
-    <tr>
-      <td>Rick Dangerous</td>
-      <td>yes</td>
-      <td>perfect</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Slayer</td>
-      <td>yes</td>
-      <td>ok</td>
-      <td>raster fx at highscore entry dodgy</td>
-    </tr>
-    <tr>
-      <td>Lethal Xcess</td>
-      <td>no</td>
-      <td>&nbsp;</td>
-      <td>crashes while loading, sync scrolling will not work properly</td>
-    </tr>
-    <tr>
-      <td>Star Goose</td>
-      <td>yes</td>
-      <td>music ok - bullet sound dodgy</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Xenon 2 - Megablast</td>
-      <td>yes</td>
-      <td>nearly perfect (including sampled intro)</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Metal Mutant</td>
-      <td>yes</td>
-      <td>seems ok</td>
-      <td>some color effects in the lower screen seem buggy</td>
-    </tr>
-    <tr>
-      <td>Defenders Of The Earth</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Nebulus</td>
-      <td>yes</td>
-      <td>music ok; snowball, balls and trapdoors dodgy</td>
-      <td>otherwise working to a playable extend</td>
-    </tr>
-    <tr>
-      <td>Leander</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Navy Seals</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Armalyte</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Wings Of Death</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>works in STE mode too</td>
-    </tr>
-    <tr>
-      <td>Toki</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Alien World</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Only works with "--slowfdc"</td>
-    </tr>
-    <tr>
-      <td>Skweek</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Does not work with cartridge / HD emulation</td>
-    </tr>
-  </tbody>
-</table>
-
-<a name="ST demos"></a><h4>ST demos</h4>
-
-<table border="1" cellpadding="3">
-  <caption align="bottom">tested demos</caption> <tbody>
-    <tr class="backdropped">
-      <td align="center">Demo</td>
-      <td align="center">Working</td>
-      <td align="center">Sound</td>
-      <td align="center">Comment</td>
-    </tr>
-    <tr>
-      <td>Fantasia (by Dune)</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Only works with "--slowfdc"</td>
-    </tr>
-    <tr>
-      <td>Oddstuff (by Dune/SectorOne)</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Only works with "--slowfdc".
-          Enable "frameskip" to avoid the flicker.</td>
-    </tr>
-    <tr>
-      <td>If pigs could fly (by Syndicate)</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Only works with "--slowfdc"</td>
-    </tr>
-    <tr>
-      <td>LongScreen (by X-Troll)</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Only works with "--slowfdc"</td>
-    </tr>
-    <tr>
-      <td>Overdose (by Aggression)</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Does not work with cartridge / HD emulation</td>
-    </tr>
-    <tr>
-      <td>Virtual Escape (by Equinox)</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Posh (by Checkpoint)</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Flipo (by Oxygene)</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Syntax Terror (by DeltaForce)</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Sweety (by DHS)</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Does not work with HD emulation</td>
-    </tr>
-    <tr>
-      <td>B.I.G-demo (musicdemo by Exceptions)</td>
-      <td>partially</td>
-      <td>&nbsp;</td>
-      <td>Flickers and colors in 3 of the screens don't look right</td>
-    </tr>
-    <tr>
-      <td>SoWatt (by CareBears)</td>
-      <td>partially</td>
-      <td>&nbsp;</td>
-      <td>Colors and scrolling in the main menu are broken</td>
-    </tr>
-    <tr>
-      <td>Punish your machine</td>
-      <td>partially</td>
-      <td>&nbsp;</td>
-      <td>Colors and scrolling in the main menu are broken</td>
-    </tr>
-    <tr>
-      <td>Froggies over the Fence<br>Oh no more Froggies</td>
-      <td>No</td>
-      <td>&nbsp;</td>
-      <td>Stop when the main menu loads</td>
-    </tr>
-  </tbody>
-</table>
-
-<a name="ST applications"></a><h4>ST applications</h4>
-
-<table border="1" cellpadding="3">
-  <caption align="bottom">tested applications</caption> <tbody>
-    <tr class="backdropped">
-      <td align="center">Application</td>
-      <td align="center">Working</td>
-      <td align="center">Comment</td>
-    </tr>
-    <tr class="backdropped">
-      <td colspan="3" align="right"><i>Programming</i></td>
-    </tr>
-    <tr>
-      <td>DevPac 2.2</td>
-      <td>yes</td>
-      <td>MonST crashy</td>
-    </tr>
-    <tr>
-      <td>Turbo Assembler</td>
-      <td>yes</td>
-      <td>Due to a bug you need to have a proper disk image inserted into drive A. Works otherwise!</td>
-    </tr>
-    <tr>
-      <td>GFABASIC 3.6TT</td>
-      <td>yes</td>
-      <td>MENU.PRG does not like harddisks. Use diskimages for
-compiling.</td>
-    </tr>
-    <tr>
-      <td>ST Basic</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Orcs Resource editor</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr class="backdropped">
-      <td colspan="3" align="right"><i>Graphics</i></td>
-    </tr>
-    <tr>
-      <td>Mgif</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Neochrome</td>
-      <td>yes</td>
-      <td>rasters sometimes unstable</td>
-    </tr>
-    <tr>
-      <td>Crackart</td>
-      <td>yes</td>
-      <td>Harddisk access does not work with GEMDOS emulation - fine
-with disk images</td>
-    </tr>
-    <tr>
-      <td>Speed Of Light</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr class="backdropped">
-      <td colspan="3" align="right"><i>Sound</i></td>
-    </tr>
-    <tr>
-      <td>SidSound Designer</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>MusicMon 2</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Protracker</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Accompanist<br>(Henry Cosh Sequencer)</td>
-      <td>yes</td>
-      <td>Program works, but couldn't get Hatari midi output to work</td>
-    </tr>
-    <tr>
-      <td>Sequencer One</td>
-      <td>yes</td>
-      <td>Program and sample sounds work, but couldn't get Hatari midi
-      output to work</td>
-    </tr>
-    <tr>
-      <td>Cubase Lite</td>
-      <td>yes</td>
-      <td>Program works, but couldn't get Hatari midi output to work</td>
-    </tr>
-    <tr class="backdropped">
-      <td colspan="3" align="right"><i>Text Editors</i></td>
-    </tr>
-    <tr>
-      <td>Tempus</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Qed editor</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Everest editor</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr class="backdropped">
-      <td colspan="3" align="right"><i>Business applications</i></td>
-    </tr>
-    <tr>
-      <td>Opus spreadsheet</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>SBase database</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr class="backdropped">
-      <td colspan="3" align="right"><i>Communications</i></td>
-    </tr>
-    <tr>
-      <td>CAB browser</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Kivi QWK Reader</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr class="backdropped">
-      <td colspan="3" align="right"><i>Desktops</i></td>
-    </tr>
-    <tr>
-      <td>Teradesk desktop</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Thing desktop</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr class="backdropped">
-      <td colspan="3" align="right"><i>Others</i></td>
-    </tr>
-    <tr>
-      <td>ST-Guide</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Sagrotan viruskiller</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-    </tr>
-  </tbody>
-</table>
-
-<a name="STE games"></a><h4>STE games</h4>
-
-<p>First are some STE games that do work with the STE features
-in Hatari.  Most of these games work only on STE, but here are also some
-games which work (or have a version that works) also on ST, i.e. they
-are just STE enhanced.  These are marked with '*'.</p>
-<table border="1" cellpadding="3">
-  <caption align="bottom">tested STE games</caption> <tbody>
-    <tr class="backdropped">
-      <td align="center">Title</td>
-      <td align="center">Working</td>
-      <td align="center">Sound</td>
-      <td align="center">Comment</td>
-    </tr>
-    <tr>
-      <td>Alien Blast</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Astrodia*</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Blitter support doesn't work with EmuTOS, only real STE TOS</td>
-    </tr>
-    <tr>
-      <td>Battletris+</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Blat!</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Bombaman</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Breakdance</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td><em>THE</em> ultimate scene game</td>
-    </tr>
-    <tr>
-      <td>ChuChu Rocket</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>needs to be run from disk image</td>
-    </tr>
-    <tr>
-      <td>Dynabusters+</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>H.E.R.O. 2</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Requires 4MB RAM</td>
-    </tr>
-    <tr>
-      <td>Manga Puzzle</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Penta*</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Blitter, DMA audio and STE fadings do work properly</td>
-    </tr>
-    <tr>
-      <td>No Limit II</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Obsession</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>opens top &amp; bottom border, but part from the right is not visible on screen</td>
-    </tr>
-    <tr>
-      <td>Operation Garfield</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Pacman on E</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Power Up*</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Problems with music, but DMA sound effects work</td>
-    </tr>
-    <tr>
-      <td>Roger</td>
-      <td>partially</td>
-      <td>&nbsp;</td>
-      <td>Blitter timings inaccurate - game is too fast,
-          needs to be run from disk image</td>
-    </tr>
-    <tr>
-      <td>Skulls</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>part from the right border is not visible on screen</td>
-    </tr>
-    <tr>
-      <td>Starball*</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Stardust</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Stupid Balloon game</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Substation</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>TomTar</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Utopos</td>
-      <td>partially</td>
-      <td>&nbsp;</td>
-      <td>screen corrupted</td>
-    </tr>
-    <tr>
-      <td>Ultimate Arena</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Wolfenstein 3D*</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>STE DMA sound does work</td>
-    </tr>
-    <tr>
-      <td>Zool</td>
-      <td>partially</td>
-      <td>&nbsp;</td>
-      <td>screen corrupted, scrolling fails</td>
-    </tr>
-  </tbody>
-</table>
-
-<a name="STE demos"></a><h4>STE demos</h4>
-
-<p>Some tested STE demos and intros</p>
-<table border="1" cellpadding="3">
-  <caption align="bottom">tested STE demos</caption> <tbody>
-    <tr class="backdropped">
-      <td align="center">Title</td>
-      <td align="center">Working</td>
-      <td align="center">Sound</td>
-      <td align="center">Comment</td>
-    </tr>
-    <tr>
-      <td>Aggression: Braindamage</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>Colors in the last 2 screens don't look right</td>
-    </tr>
-    <tr>
-      <td>Armada: Armada is Dead</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>bottom border broken</td>
-    </tr>
-    <tr>
-      <td>DHS: Tyranny &amp; Massacre</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>GGN: Alive</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Ice: Extacy</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Imagina: 1992 X-mas demo</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>flickers without frameskip</td>
-    </tr>
-    <tr>
-      <td>MJJ-Prod: 1st Step</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>New Core: Beyond Deadline</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Omega: Grotesque</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Paradox: X-mas 1994 demo</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Reservoir Gods: Mind Rewind</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>opens all borders</td>
-    </tr>
-    <tr>
-      <td>Reservoir Gods: Grimey</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>Syntax: Reanimation</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>&nbsp;</td>
-    </tr>
-    <tr>
-      <td>MJJ-Prod: Tribute To Rainbow Tos</td>
-      <td>partially</td>
-      <td>&nbsp;</td>
-      <td>screen corrupted, Blittermania does not work but the code does not crash nor lockup</td>
-    </tr>
-    <tr>
-      <td>Armada: RGBRuler demo</td>
-      <td>partially</td>
-      <td>&nbsp;</td>
-      <td>doesn't look right</td>
-    </tr>
-    <tr>
-      <td>New Core: Core Flakes</td>
-      <td>partially</td>
-      <td>&nbsp;</td>
-      <td>doesn't look right</td>
-    </tr>
-    <tr>
-      <td>Percy of Light: VGA slideshow</td>
-      <td>partially</td>
-      <td>&nbsp;</td>
-      <td>doesn't look right</td>
-    </tr>    
-  </tbody>
-</table>
-
-<a name="STE applications"></a><h4>STE applications</h4>
-
-<p>Finally some tested STE applications</p>
-<table border="1" cellpadding="3">
-  <caption align="bottom">tested STE applications</caption> <tbody>
-    <tr class="backdropped">
-      <td align="center">Title</td>
-      <td align="center">Working</td>
-      <td align="center">Sound</td>
-      <td align="center">Comment</td>
-    </tr>
-    <tr>
-      <td>Octalyzer</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>part from the right is not visible on screen</td>
-    </tr>
-    <tr>
-      <td>Protracker STE</td>
-      <td>yes</td>
-      <td>&nbsp;</td>
-      <td>garbage at screen bottom, 50KHz replay duff</td>
-    </tr> 
-  </tbody>
-</table>
-
 <br>
 
 <hr style="width: 100%; height: 2px;">
@@ -1878,8 +1396,7 @@ are just STE enhanced.  These are marked
  src="http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01!"
  border="0" height="31" width="88"></a></td>
       <td align="right">
-      <address><a href="mailto:marndt@asmsoftware.de">Matthias Arndt</a>
-August 31 2005</address>
+      February 29th 2008
       </td>
     </tr>
   </tbody>