--- hatari/doc/manual.html	2019/04/01 07:11:03	1.1.1.1
+++ hatari/doc/manual.html	2019/04/01 07:11:39	1.1.1.2
@@ -8,16 +8,16 @@
   <meta name="resource-type" content="document">
   <meta name="distribution" content="global">
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15">
-  <meta name="Generator" content="Quanta Plus 3.1.2 Debian GNU/Linux 3.0 Woody">
+  <meta name="Generator" content="Quanta Plus 3.2.1  SuSE Linux 9.1">
   <meta http-equiv="Content-Style-Type" content="text/css">
   <style type="text/css">
   <!--
-	body { background-color:#FFFFFF;
-		   color:#000000;
-           margin-left:10px;
-		   margin-right:10px;
-		   font-family:Verdana,Arial,Helvetica,sans-serif; font-size:12pt;
-		 }
+	body {  background-color:#FFFFFF;
+		color:#000000;
+           	margin-left:10px;
+		margin-right:10px;
+		font-family:Verdana,Arial,Helvetica,sans-serif; font-size:12pt;
+		}
 
 	h1 { font-size:28pt; }
 	h2 { font-size:22pt; border-bottom:solid thin black;}
@@ -32,6 +32,8 @@
  	a:active { color:#993399; background-color:#ffffff; text-decoration:none; font-weight:bold; }
 
 	*.commandline { font-family:Fixed,Courier,monospace; font-size:10pt; }
+	*.file { color: #000088;}
+	*.button { color: #468E64;}
 	*.key { color:#550000; font-family:Fixed,Courier,monospace; font-size:10pt; }
 	*.backdropped { background-color:#ffffee; }
 	*.image {border-width:2px; border-style:solid; border-color:#eeeeff; padding:1cm; text-align:justify; }
@@ -42,7 +44,13 @@
 </head>
 <body bgcolor="#ffffff" text="#000000" link="#000099" vlink="#cc0000" alink="#993399">
 <h1 align="center">Hatari User's Manual</h1>
-<p align="center"><strong>manual by Matthias Arndt &lt;<a href="mailto:marndt@asmsoftware.de">marndt@asmsoftware.de</a>&gt;</strong></p>
+<p align="center">
+<strong>project initiator and main developer of Hatari: Thomas Huth &lt;<a href="mailto:thothy@users.sourceforge.net">thothy@users.sourceforge.net</a>&gt;</strong><br>
+<strong>manual by Matthias Arndt &lt;<a href="mailto:marndt@asmsoftware.de">marndt@asmsoftware.de</a>&gt;</strong>
+</p>
+<p align="center">
+<strong>Hatari on the WWW: <A href="http://hatari.sourceforge.net/" target="_blank">http://hatari.sourceforge.net/</A> </strong>
+</p>
 <br>
 
 <h2>Introduction</h2>
@@ -50,14 +58,14 @@
 <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. See Appendix B
-for details on emulation in general. </p>
+for details on emulation in general.</p>
 <p>Hatari is based on two main sources: </p>
 
 <ul>
   <li>The WinSTon sourcecode written by Paul Bates. You can get it
 from: <a href="http://www.sourceforge.net/projects/winston/">http://www.sourceforge.net/projects/winston/</a> </li>
   <li>The UAE's CPU core, you can download UAE
-at: <a href="http://www.freiburg.linux.de/uae/">http://www.freiburg.linux.de/uae/</a> </li>
+at: <a href="http://www.freiburg.linux.de/~uae/">http://www.freiburg.linux.de/~uae/</a> </li>
 </ul>
 <p>
 Hatari started as an adaption of the free WinSTon source code to Linux.
@@ -70,29 +78,33 @@ portable C and also has some nice featur
 
 <h3>Features</h3>
 <ul>
-  <li>complete m68k emulation via UAE's CPU core </li>
-  <li>support for EmuTOS, TOS 1.00, 1.02, 1.04, 2.05 and 2.06 </li>
-  <li>ST RAM size variable (512k, 1MB, 2MB and 4MB possible) </li>
-  <li>most of the ST specific hardware </li>
+  <li>complete m68k emulation via UAE's CPU core</li>
+  <li>support for EmuTOS, TOS 1.00, 1.02, 1.04, 2.05 and 2.06</li>
+  <li>ST RAM size variable (512k, 1MB, 2MB and 4MB possible)</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 border too</li>
-  <li>512 colour ST palette </li>
-  <li>Blitter chip emulation </li>
-  <li>AY-3-8910 emulation (soundchip)</li>
+overscan effects for lower border and partially in the upper, left and right border too</li>
+  <li>512 colour ST palette</li>
+  <li>Blitter chip emulation</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>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>
   <li>joystick emulation via cursor keys and joystick emulation via a
-connected PC joystick </li>
-  <li>FDC emulation using floppy disk images in standard formats (*.ST
-and *.MSA) </li>
-  <li>support for zipped disk images</li>
-  <li>partial ACSI emulation for harddisk support </li>
-  <li>GEMDOS interface driver to mount a directory as a harddrive </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>
+connected PC joystick</li>
+  <li>FDC emulation using floppy disk images in standard formats (*.ST, *.MSA
+and *.DIM)</li>
+  <li>support for zipped disk images (both PkZip and Gzip)</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>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>
 </ul>
@@ -112,17 +124,18 @@ nor support for STE specific features.
 Hatari has been succesfully tested on the following machines:
 <p> </p>
 <ul>
-  <li>Linux/i86 with Kernel 2.4.20, AMD Athlon 600MHz </li>
+  <li>Linux/i86 with Kernel 2.6.6, AMD Athlon 600MHz</li>
+  <li>Linux/i86 with Kernel 2.4.x, AMD Athlon 600MHz </li>
   <li>Linux/i86 with Kernel 2.2.18, Pentium MMX 200MHz </li>
-  <li>Linux/PPC with Kernel 2.4.x BeOS/i86 </li>
+  <li>Linux/PPC with Kernel 2.4.x </li>
+  <li>BeOS/i86 </li>
   <li>Apple PowerMac with Mac OS X </li>
   <li>NetBSD 1.6 </li>
-  <li>FreeBSD 4.1 on a 33MHz i486 computer (very slow, but it worked!) </li>
-  <li>FreeBSD 4.8 on a Pentium 4</li>
+  <li>FreeBSD 4.1 on an i486 computer, FreeBSD 4.8 on a Pentium 4 and FreeBSD 5.1 </li>
+  <li>OpenBSD 3.5 </li>
+  <li>Since version 0.40, Hatari now also works on machines with a Sparc CPU </li>
+  <li>Zaurus SL-C760 PDA </li>
 </ul>
-<p>
-It has also been tested on Linux/Sparc and it should work by now with the latest CVS version.
-</p>
 
 <h2>Compiling and running</h2>
 
@@ -140,13 +153,17 @@ for it installed as well.
 Of course, you need the GNU C compiler and (GNU) Make, too!
 </p>
 
-<p> Change to the src/ directory and adapt the Makefile to suite your
-mood (and system of course). Then compile it by typing <span class="commandline">make</span>. If all
-works fine, you'll get the executable <span class="commandline">hatari</span>. </p>
+<p> Change to the hatari/ directory and adapt the configuration file
+<span class="file">Makefile.cnf</span> to suite your system.
+Alternatively, you can use the supplied configure script to auto-detect
+all parameters (type "./configure --help" to see the options of the script).
+Then compile Hatari by typing <span class="commandline">make</span>. If all
+works fine, you'll get the executable <span class="commandline">hatari</span> in the src/ subdirectory.
+</p>
 
 <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
-in the Makefile) and rename it to <span class="commandline">tos.img</span>, or use the
+in the configuration file Makefile.cnf) 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. Sorry, it is not possible to ship an image with
@@ -158,14 +175,16 @@ where to find one.
 <p> Another solution is EmuTOS, which is an open-source
 TOS clone. You can find EmuTOS at: <a href="http://emutos.sourceforge.net/">http://emutos.sourceforge.net/</a>. It's
 not the best solution for playing games or running other old software
-due to compatibility issues, but it's free! </p>
+due to compatibility issues, but it's free and officially compatible with Hatari! </p>
 <p>If you do not specify a TOS image on the commandline nor can Hatari
 find a suitable TOS image in the default dir, you'll get the chance to
 select a TOS image file from the GUI. </p>
 
 <h3>Installation of the binary</h3>
-<p> Simply copy the hatari binary somewhere in your path where you can
-access it easily by typing <span class="commandline">hatari</span> in your shell. </p>
+<p> Type <span class="commandline">make install</span> as root to do a systemwide installation. In this case it is recommended
+to set the DATADIR variable in Makefile.cnf to a proper value. <tt>/usr/local/share/hatari</tt> is a good value in that case.</p>
+<p>The Hatari executable should now be in your PATH and accessible from anywhere.</p>
+
 <p> When you finally have got a TOS image, try starting Hatari with the
 option <span class="commandline">--help</span> to find out more about its command line parameters. </p>
 
@@ -222,6 +241,10 @@ emulation)</td>
       <td align="center">activates the simple builtin debugger</td>
     </tr>
     <tr>
+    	<TD align="center">--slowfdc</TD>
+	<td align="center">slows down FDC emulation (needed to make some games and demos work)</td>
+    </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>
     </tr>
@@ -254,6 +277,22 @@ emulation)</td>
       <td align="center">--vdi</td>
       <td align="center">use extended VDI resolution</td>
     </tr>
+	<tr>
+      <td align="center">--printer</td>
+      <td align="center">enable experimental printer support</td>
+    </tr>
+    <tr>
+      <td align="center">--midi &lt;filename&gt;</td>
+      <td align="center">enable experimental MIDI output to the mentioned file</td>
+    </tr>
+    <tr>
+      <td align="center">--rs232 &lt;filename&gt;</td>
+      <td align="center">enable experimental RS232 communication via the mentioned file</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>
+    </tr>
   </tbody>
 </table>
 
@@ -266,27 +305,49 @@ an allmost complete Atari ST computer sy
 <h4>General usage</h4>
 <p>Press <span class="key">F12</span> to enter the GUI. Navigate it with the mouse.
 The GUI is rather self explanatory.</p>
-<p>Click "Okay" to go back to the emulated ST. All checked options will be applied.</p>
-<p>Check the "Reset ST" option if you want the emulated ST to perform a soft reset.</p>
-<p>Click "Quit" to terminate Hatari and return to the host OS.</p>
-<p>Click "Cancel" to abandon any changes made.</p>
+<p>Click <span class="button">Okay</span> to go back to the emulated ST. All checked options will be applied.</p>
+<p>Check the <span class="button">Reset ST</span> option if you want the emulated ST to perform a soft reset. This should be equal to pressing the reset button on your ST.
+</p>
+<p>Click <span class="button">Quit</span> to terminate Hatari and return to the host OS.</p>
+<p>Click <span class="button">Cancel</span> to abandon any changes made.</p>
 
 <h4>The System Dialog</h4>
 <p>Check the CPU type to use here, enable prefetch mode and if the Blitter should be active.</p>
 <p>For best Atari ST compatibility choose plain 68000 here.</p>
-<p><em>NOTE:</em> These parameters are sensitive to the emulated ST and it is strongly recommended to
+<p>The Timer-D patch changes the Timer-D initialization from TOS. TOS uses Timer-D as a baudrate generator for RS232.
+The TOS default slows the emulation down so the patch gives you a faster emulation.
+</p>
+<p>You can disable the Timer-D patch if games or demos require the original TOS setting.</p>
+<p><em>NOTE:</em> These parameters are very sensitive to the emulated ST and it is strongly recommended to
 reset the emulated ST after changing these options.</p>
 
-<h4>The Floppy Disk Dialog</h4>
-<p>Use this dialog to choose which disks should be emulated in the disk drives.</p>
+<h4>The Discs Dialog</h4>
+<p>Use the upper dialog to choose which floppy disks should be emulated in the disk drives.</p>
 <p>You can use most standard Atari ST disk image files. See the chapter "Floppy disk images"
 for details.</p>
-<p>Click on the button "Browse" next to the A: and B: option to go to the fileselector.</p>
+<p>Click on the button <span class="button">Browse</span> next to the A: and B: option to go to the fileselector.
+You may select and browse zipped disk images as well.</p>
+<p>Click on <span class="button">Eject</span> to eject a disk image from the emulated drive. The emulated ST will act as if had no floppy 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.
+</p>
+
+<p>If you need to create a new blank disk image, click on <span class="button">Create disk image</span>.
+Parameters for the new image can be set in the following dialog. Click on <span class="create">create</span> to create the image or on <span class="button">back</span> to get back to the
+disk dialog.
+</p>
+<p>
+After clicking <span class="button">create</span>, a fileselector appears. You can browse the filesystem now. Select the target directory, click beside File:
+and type in a name for the new disk image. The name should terminate with .st or .msa.
+</p>
+<p>Hatari can currently create plain .ST and .MSA disk images exclusively.</p>
+
+<p>Use the lower dialog to change the harddisk settings.</p>
 <p>You can select a harddrive image for harddrive emulation via image file here or you may select
 a directory of your local filesystem to be emulated as the ST's harddrive.</p>
 <p>Check "Boot from HD" if you want Hatari to execute the AUTO folder on the harddrive.
@@ -296,9 +357,13 @@ This option is checked by default if you
 <p>You can select the amount of RAM for the emulated ST here.</p>
 <p><em>Note:</em> This option is critical and you are strongly advised to reset the emulated ST
 when changing this option.</p>
+<p>Here you will find the options to save memory snapshots as well.</p>
+<p>Click on <span class="button">Save</span> to save a memory snapshot to file. You can select a new filename here.</p>
+<p>Click on <span class="button">Restore</span> to restore a memory snapshot from a file. Use the fileselector to select the snapshot to be restored.</p>
+<p><em>NOTE:</em> Memory snapshots should be considered <span style="color:red;">EXPERIMENTAL</span> and the Hatari team strongly advises you not to rely on them yet!</p>
 
 <h4>The TOS/GEM Dialog</h4>
-<p>Here you can select the TOS image to use. Click on "Browse" to select it via the fileselector.</p>
+<p>Here you can select the TOS image to use. Click on <span class="button">Browse</span> to select it via the fileselector.</p>
 <p>In the GEM setup you can select a larger resolution for GEM conformant apps. Select resolution
 and colour depth. Almost all games and demos will not work in one of these resolutions.</p>
 <p><em>Note:</em> These options are critical and you are strongly advised to reset the emulated ST
@@ -325,8 +390,7 @@ Hatari will emulate the good old SM124 a
 This toggle acts like a monitor switch with a color and monochrome monitor connected.</p>
 <p>"ST-Low mode" 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>Click "Capture Screen" to create a screenshot in .BMP format to the current working directory or click "Record Animation"
-to record a little movie.
+<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 screenshots.
 </p>
 
 <h4>The Keyboard Dialog</h4>
@@ -337,13 +401,31 @@ use the "symbolic" mapping for all keys
 own keyboard mapping.</p>
 
 <h4>The Sound Dialog</h4>
-<p>Here you control the sound subsystem.</p>
+<p>Here you can control the sound subsystem.</p>
 <p>Check if you want emulated sound at all. Emulation is faster if sound emulation is turned off.</p>
 <p>3 frequencies from low to high quality are available. Experiment a little bit to find out which fits best for your setup.
 Medium quality will work ok in most cases.</p>
 <p>You can select to record a piece of sound here. Check which format to use and click the button. It is a toggle button so
 you will need to return to the GUI to switch sound recording off again.</p>
 
+<h4>The Devices Dialog</h4>
+<p>Check here if you want to enable experimental printer support. See the chapter "Emulated printer" for details.</p>
+<p>As Hatari currently only supports printing to file, click on <span class="button">Select</span> to select the file to print to. You can enter a new filename as well.</p>
+<p><em>NOTE:</em> As the printer emulation is not perfect yet, activated printer support may interfere with the emulated sound.
+This is due to the fact that the Atari ST uses some general I/O ports of the soundchip for the printer port. The Hatari team suggests to
+disable printing while using games and demos.
+</p>
+<p>Check the second checkmark if you want to enable experimental RS232 support. The RS232 device is configured according to the settings of the emulated RS232 of the Atari ST. This means Hatari will automatically use baudrate and handshaking as configured for the emulated ST.</p>
+<p>Select a suitable device file for input and output. Click on <span class="button">Browse</span> to select.
+A good choice is /dev/ttyS0 or /dev/ttyS1.
+</p>
+<p>You can enable MIDI as well. This currently work for outputting MIDI data only. A good choice is /dev/midi00.</p>
+<p>Click on <span class="button">Browse</span> to select a suitable MIDI device file for output.</p>
+<p>Your sound driver must support MIDI to make this work.</p>
+
+<p><em>NOTE:</em> RS232 and MIDI emulation are very experimental, too.
+Don't enable them unless you really need them!
+</p>
 
 <h3>Keyboard shortcuts</h3>
 <p> While the emulator is running, you can activate or toggle various
@@ -356,10 +438,18 @@ features via the following keyboard shor
       <td align="center">Purpose</td>
     </tr>
     <tr>
+      <td align="center"><span class="key">ALTGR+a</span></td>
+      <td align="center">record animation</td>
+    </tr>
+    <tr>
       <td align="center"><span class="key">ALTGR+g</span></td>
       <td align="center">grabs a screenshot</td>
     </tr>
     <tr>
+      <td align="center"><span class="key">ALTGR+i</span></td>
+      <td align="center">boss key: leave full screen mode and iconify window</td>
+    </tr>
+    <tr>
       <td align="center"><span class="key">ALTGR+j</span></td>
       <td align="center">activates joystick emulation via cursor keys</td>
     </tr>
@@ -369,23 +459,35 @@ features via the following keyboard shor
     </tr>
     <tr>
       <td align="center"><span class="key">ALTGR+r</span></td>
-      <td align="center">reset the ST</td>
+      <td align="center">(warm) reset the ST</td>
     </tr>
     <tr>
       <td align="center"><span class="key">ALTGR+c</span></td>
       <td align="center">coldreset the ST (same as the original power switch)</td>
     </tr>
     <tr>
+      <td align="center"><span class="key">ALTGR+s</span></td>
+      <td align="center">enable/disable sound</td>
+    </tr>
+    <tr>
       <td align="center"><span class="key">ALTGR+q</span></td>
       <td align="center">quit the emulator</td>
     </tr>
     <tr>
+      <td align="center"><span class="key">ALTGR+x</span></td>
+      <td align="center">toggle normal/max speed</td>
+    </tr>
+    <tr>
+      <td align="center"><span class="key">ALTGR+y</span></td>
+      <td align="center">enable/disable sound recording</td>
+    </tr>
+    <tr>
       <td align="center"><span class="key">F11</span></td>
       <td align="center">toggles fullscreen and windowed mode</td>
     </tr>
     <tr>
       <td align="center"><span class="key">F12</span></td>
-      <td align="center">activate the GUI</td>
+      <td align="center"><p>activate the GUI</p><p>You may need to hold <span class="key">SHIFT</span> down while in windowed mode.</p></td>
     </tr>
     <tr>
       <td align="center"><span class="key">PAUSE</span></td>
@@ -414,13 +516,21 @@ key on the ST. The following keys have s
       <td align="center">will act as the ST's CONTROL key</td>
     </tr>
     <tr>
-      <td align="center"><span class="key">Page Up</span></td>
+      <td align="center"><span class="key">Print Screen</span></td>
       <td align="center">will emulate the ST's HELP key</td>
     </tr>
     <tr>
-      <td align="center"><span class="key">Page Down</span></td>
+      <td align="center"><span class="key">Scroll Lock</span></td>
       <td align="center">will emulate the ST's UNDO key</td>
     </tr>
+    <tr>
+      <td align="center"><span class="key">Page Up</span></td>
+      <td align="center">will emulate the ST's ( key in the keypad</td>
+    </tr>
+    <tr>
+      <td align="center"><span class="key">Page Down</span></td>
+      <td align="center">will emulate the ST's ) in the keypad</td>
+    </tr>
   </tbody>
 </table>
 
@@ -460,11 +570,38 @@ as the joystick directions, the right CT
 firebutton. You can still use the cursor keys as the ST's
 cursorkeys in this mode as long as you press <span class="key">SHIFT</span> along with the cursorkeys. </p>
 
+<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>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 the low byte of the video address, currently does not work properly in Hatari.
+</p>
+<p>Beside that you can setup extended VDI modes. These only work with GEM-compliant applications and they are equal to fitting a videocard into your Mega ST.</p>
+<p>Make sure to disable extended VDI modes for playing games as 99% of all ST games will not be able to make use of higher resolutions.</p>
+
+
+<h3>Emulated printer</h3>
+<p>Due to the fact that printer handling is very different between Unix style machines and the Atari ST, emulation
+of the printer is achieved by writing all printer output to a file.</p>
+<p>The file will contain a sequence of data, the same that would appear on the data pins of the Atari ST printer port.
+That would include control characters and commands for graphic printing. Clicking "Print desktop" on the GEM desktop would result
+in a messy data dump in the printer output.</p>
+<p>Printer emulation works best for plain text files or programs that do not format the output for a specific printer.
+The file contents can be used with your favourite text editor for further processing and printing to a real printer.</p>
+<p>To get real direct printing out of Hatari on a PostScript printer, you may set up a GDOS printer with a PostScript driver on the emulated Atari and set your printer device file as Hatari's printer output.<br>
+<em>NOTE:</em> This has not been tested yet and the Hatari team cannot guarantee that it will work.</p>
+
+<h3>Emulated RS232</h3>
+<p>Serial communications in Hatari is designed to directly use a serial port on your PC.</p>
+<p>Communications parameters are set automatically upon the settings of the emulated ST. This means all you do is to set
+the communication parameters like baudrate from your ST communications software. Hatari will do the rest and handle
+the serial input and output for you.</p>
+
 <h2>Floppy disk images</h2>
 <p>Hatari does not use floppy disks directly but disk images due to
 differences between the floppy disk controllers of the ST and the PC.
-Two types of disk images are currently supported: The raw "ST" type and
-the "MSA" (Magic-Shadow-Archiver) type. </p>
+Three types of disk images are currently supported: The raw "ST" type, the similar "DIM" type and
+the compressed "MSA" (Magic-Shadow-Archiver) type. </p>
 <p> The raw type (file suffix should be "*.st") is simply a sector by
 sector image of a real floppy disk. You can easily create such an image
 with the <span class="commandline">dd</span> program which should normally be pre-installed on every
@@ -479,14 +616,22 @@ are programs like the Magic Shadow Archi
 supports this slightly compressed MSA disk images, too. Note that Hatari
 only supports the "old" MSA format, there are some Magic Shadow Archiver
 clones (like Jay-MSA) that create better compressed but
-Hatari-incompatible disk images. </p>
+Hatari-incompatible disk images. However, if you have got such a MSA
+disk and want to use it with Hatari, you can still run the corresponding
+MSA program within Hatari to extract the incompatible disk image to a
+normal floppy disk image. </p>
 <p> While *.ST and *.MSA are more or less the "standard" types of Atari
-disk images, you might sometimes also find DIM or ADF images on the
-internet. These currently do not work with Hatari. But since DIM images
-are nearly the same as the raw ST images (they only have an additional
-32 byte header) you can easily transform the DIM images into ST images
-by stripping the header from the files. For example try something like:
-<span class="commandline">dd if=input.dim of=output.st bs=32 skip=1</span> </p>
+disk images, you might sometimes also find STT or ADF images on the
+internet. These currently do not work with Hatari.  </p>
+
+<p>Hatari can now also utilize *.DIM images just as *.ST ones without any problems.
+Note that DIM images are nearly the same as the raw ST images
+(they only have an additional 32 bytes header), so you can easily transform
+the DIM images into ST images by stripping the header from the files.
+For example try something like:
+<span class="commandline">dd if=input.dim of=output.st bs=32 skip=1</span>
+</p>
+
 <p> If you've got a disk image that has been created with the old ST
 emulator PaCifiST (for DOS) or with early versions of the program
 Makedisk, and the disk image does not work with Hatari, then the disk
@@ -500,11 +645,14 @@ can also easily destroy your disk image
 there). If the disk contains a bootsector program, you probably have to
 adjust the boot sector check sum, too (it can be found at offset $1FE +
 $1FF). </p>
-<p>Hatari supports zipped disk images so you can archive your disk images into zip archives.
-You can also directly run the zip archives you may download from the net as long as the archive contains a
-disk image in .ST or .MSA format.</p>
-<p><em>Note:</em> Hatari does not save disk images back to zipfiles so your highscores and savegames are lost if you
-loaded the game from a zipped disk image.</p>
+<p>Hatari supports disk images that are compressed with (Pk-)ZIP
+(file suffix must be ".zip") or GZip (file suffix must be ".st.gz" or
+".msa.gz"),  so you can archive your disk images into zip archives.
+You can also directly run the zip archives you may download from the
+net as long as the archive contains a disk image in .ST or .MSA format.</p>
+<p><em>Note:</em> Hatari does not save disk images back to *.ZIP files so
+your highscores and savegames are lost if you load the game from such
+a zipped disk image.</p>
 
 <h2>Hard disk support</h2>
 <p>Hatari supports two ways of emulating a ST hard drive: The low-level
@@ -575,13 +723,13 @@ So you have an CPU emulator that basical
 The typical von-Neumann CPU can be emulated very fast, stable and error-free using such a simple loop system.
 </p>
 <p>
-But in most cases the CPU emulation is the simplest part. Correct emulation of the various cutom chips and hardware
+But in most cases the CPU emulation is the simplest part. Correct emulation of the various custom chips and hardware
 parts of the emulated system is much trickier.
 </p>
 
 
 <h3>Software compatibility list</h3>
-<p>This is a little compilation of what software does work in Hatari. It is by no means finished.</p>
+<p>This is a little compilation of what Atari software does work in Hatari. It is by no means finished.</p>
 
 <table cellpadding="3" border="1">
   <caption align="bottom">tested games</caption>
@@ -611,6 +759,12 @@ parts of the emulated system is much tri
 	  <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>
@@ -632,7 +786,7 @@ parts of the emulated system is much tri
 	  <td>Lethal Xcess</td>
 	  <td>no</td>
 	  <td>&nbsp;</td>
-	  <td>crashes while loading</td>
+	  <td>crashes while loading, sync scrolling will not work properly</td>
 	</tr>
 	<tr>
 	  <td>Star Goose</td>
@@ -643,7 +797,7 @@ parts of the emulated system is much tri
 	<tr>
 	  <td>Xenon 2 - Megablast</td>
 	  <td>yes</td>
-	  <td>perfect (including sampled intro)</td>
+	  <td>nearly perfect (including sampled intro)</td>
 	  <td>&nbsp;</td>
 	</tr>
 	<tr>
@@ -664,6 +818,49 @@ parts of the emulated system is much tri
 	  <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>&nbsp;</td>
+	</tr>
+	<tr>
+	  <td>Alien World</td>
+	  <td>yes</td>
+	  <td>&nbsp;</td>
+	  <td>Only works with &quot;--slowfdc&quot;</td>
+	</tr>
+	<tr>
+	  <td>Fantasia (Demo by Dune)</td>
+	  <td>yes</td>
+	  <td>&nbsp;</td>
+	  <td>Only works with &quot;--slowfdc&quot;</td>
+	</tr>
+	<tr>
+	  <td>If pigs could fly (Demo by Syndicate)</td>
+	  <td>yes</td>
+	  <td>&nbsp;</td>
+	  <td>Only works with &quot;--slowfdc&quot;</td>
+	</tr>
+
   </tbody>
 </table>
 
@@ -688,7 +885,7 @@ parts of the emulated system is much tri
 	<tr>
 	  <td>GFABASIC 3.6TT</td>
 	  <td>yes</td>
-	  <td>&nbsp;</td>
+	  <td>MENU.PRG does not like harddisks. Use diskimages for compiling.</td>
 	</tr>
 	<tr>
 	  <td>ST Basic</td>
@@ -701,6 +898,11 @@ parts of the emulated system is much tri
 	  <td>rasters sometimes unstable</td>
 	</tr>
 	<tr>
+	  <td>Crackart</td>
+	  <td>yes</td>
+	  <td>&nbsp;</td>
+	</tr>
+	<tr>
 	  <td>Tempus</td>
 	  <td>yes</td>
 	  <td>&nbsp;</td>
@@ -711,6 +913,11 @@ parts of the emulated system is much tri
 	  <td>&nbsp;</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>
@@ -720,6 +927,26 @@ parts of the emulated system is much tri
 	  <td>yes</td>
 	  <td>&nbsp;</td>
 	</tr>
+	<tr>
+	  <td>Teradesk</td>
+	  <td>yes</td>
+	  <td>&nbsp;</td>
+	</tr>
+	<tr>
+	  <td>Qed</td>
+	  <td>yes</td>
+	  <td>&nbsp;</td>
+	</tr>
+	<tr>
+	  <td>Everest</td>
+	  <td>yes</td>
+	  <td>&nbsp;</td>
+	</tr>
+	<tr>
+	  <td>Speed Of Light</td>
+	  <td>yes</td>
+	  <td>&nbsp;</td>
+	</tr>
   </tbody>
 </table>
 
@@ -729,11 +956,10 @@ parts of the emulated system is much tri
 	<tbody>
     <tr>
       <td align="left"><a href="http://validator.w3.org/check/referer"><img border="0" src="http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01!" height="31" width="88"></a></td>
-      <td align="right"><address><a href="mailto:marndt@asmsoftware.de">Matthias Arndt</a> July 08 2003</address></td>
+      <td align="right"><address><a href="mailto:marndt@asmsoftware.de">Matthias Arndt</a>July 08 2004</address></td>
     </tr>
 	</tbody>
 </table>
 
 </body>
 </html>
-
