UAE for Windows.
READ BELOW FOR HARDDISK IMAGE, CD32 AND ACTION REPLAY INSTRUCTIONS!
===================================================================

WinUAE 1.4.3 (29.07.2007)
=========================

New features:

- Built-in lha/lzh and lzx support.
- Mount archives as a harddrive with transparent, recursive
  (archives inside archive) decompression. Supported: zip, 7zip,
  rar (unrar.dll or archiveaccess.dll required), lha/lzh, lzx.
- A3000 Kickstart ROM and SuperKickstart disk support.
- A590/A2091 SCSI, A3000 SCSI and CDTV SCSI expansion harddrive (HDF)
  emulation (WD33C93 + (Super)DMAC based SCSI hardware).
- Action Cartridge Super IV Professional freezer cartridge emulation.
- X-Power Professional 500 (v1.2) freezer cartridge emulation.
- Nordic Power (v2.0) freezer cartridge emulation.
- Debugger improvements (improved deep trainer, copper memwatch points,
  CPU-model specific registers can be modified, illegal access logger
  improved, process breakpoints etc..)
- Paths-panel default paths selection improved.
- Separate native and Picasso96 vsync setting.
- GUI will "autoscroll" if fullscreen mode is smaller than GUI.
- Improved rtg.library, speeds up Picasso96 in high resolution modes
  (obsoletes picasso96fix)

Bugs fixed:

- CDTV emulation improved (DOTC2, Xenon2, ChaosInAndromeda CD player)
- CD32 CD emulation improved (Fightin' Spirit, Base Jumpers etc..)
- Ghostscript printing fixed (again).
- Floppy drive sound selection if fdrawcmd.sys was not installed.
- Video recording sound pitch issue.
- -datapath command line parameter fixed (again..)
- uae-configuration JIT on/off switching fixed.
- Sprite attachment fix, fixes "Great Demo" by "The Tremendous Trio" :)
- Some FPU fixes from Aranym.
- Directory filesystem locked files (most commonly s:startup-sequence)
  after software reset
- Filesystem emulation not initializing if JIT was enabled and no other
  expansions enabled (fast RAM, Z3 fast, etc..)


WinUAE 1.4.2a (13.05.2007)
==========================

- Paths not working bug fixed.
- Windows 98SE/ME compatibility fixed.

WinUAE 1.4.2 (12.05.2007)
=========================

New features:

- "Windowed fullscreen" for users with multiple monitors, fullscreen
  Amiga on secondary monitor, Windows on primary monitor, no more lost
  fullscreen when focus changes to Windows program.
- A600/A1200 and A4000 IDE harddrive (HDF) hardware emulation, includes
  also "4-Way IDE" / "IDE splitter" emulation.
- Directory, HDF, IDE and Picasso96 statefile support. WARNING: data loss
  possible if data in HDF has changed between saving and restoring!
  Picasso96 statefile support not 100% compatible yet.
- 68030 and 68060 (with FPU. 68060.library required) emulation. (no MMU)
- 68881/68882 FPU type selectable.
- Global brightness, contrast and gamma adjustment.
- "PAL" TV-like filter, with brightness, contrast, gamma, scanline level,
  blur and noise adjustment.
- GUI debugger, debugger improvements. (xx switches debugger modes)
- New GUI font if running under Windows 2000/XP/Vista.
- Interpolation and filters supported in 4/6 channel sound modes.
- Log and debugger console position stored in registry.

Bugs fixed:

- Improved CDTV emulation compatibility.
- 1.4.0 FPU clamping fix.
- Missing channels in 4 channel sound mode. (Emu10K based cards)
- 10x+ performance increase during "decrunching" color effects when
  no filters enabled and only background color was visible.
- Crash when loading config and specific chipset extra model was selected.
- Direct HD support improved, SyQuest removable drives detected properly.
- Minor custom chipset emulation updates.
- Rare emulator crash when running Amiga program crashed badly.
- Filter centering improved.


WinUAE 1.4.1 (18.03.2007)
=========================

Major bug fixed:

- Start-up crash introduced in 1.4.0.

Bugs fixed:

- Yet another bsdsocket crash fix.
- ASPI detection ignored NeroASPI, also ASPI detection was improved.
- Some interlaced programs had color stripes or wrong colors in right border.
- Picasso96 RTG RAM mapping error in non-JIT mode

New features:

- New input targets added. (disk swapper, input configuration 1-4)
- Quickstart-mode automatically selects best available CD access mode.
- Master (Windows main volume) volume control added to input targets.
- map "POV Hat"-type joypad control to joystick horizontal and vertical.


WinUAE 1.4.0 (03.03.2007)
=========================

New features:

- CDTV emulation, including CD controller, internal SRAM and 64KB SRAM
  expansion memory card support.
- More compatible SPTI CD32/CDTV CD support.
- Advanced Chipset configuration. Miscellaneous model specific
  hardware configuration entries like real time clock chip type, CIA-A
  TOD clock source, RAMSEY, FAT GARY register emulation..
- Rewritten harddisk configuration system. No more lost hardfile or
  virtual directory configuration entries if path was missing..
- A3000/A4000 motherboard RAM bank support.
- Added Arcadia bios rom type selection.
- New Windows Vista -style application icon added :)
- Small CIA and custom chip emulation updates.

Bugs fixed:

- FPU emulation floating point to integer conversion fixed
  (proper clamping instead of truncating)
- uaeserial.device compatibility improved
- New serial port detection didn't detect all types of serial ports
- Random sound errors after adjusting sound GUI setting on the fly
- Directory filesystem memory leaks fixed and compatibility improved
- It was not possible to disable keyboard layout C after enabling it.
- Sound panel settings were not always enabled correctly.
- -datapath command line parameter didn't work.
- Disk image drag and drop didn't work.
- Quickstart panel disk swapping is properly delayed again.
- Some Picasso96 display modes were not available.
- bsdsocket freeze fix (Aminetradio)
- Windows driver Catweasel support works again.
- "Faster RTG"-mode lockups fixed.
- External drive sound selection GUI didn't work if fdrawcmd.sys
  was not installed.


Credits:
========

- Bernd Schmidt
- Toni Wilen
- Bernd "Bernie" Meyer
- Sam Jordan
- Brian King
- Bernd Roesch
- Adil Temel
- Andreas Junghans
- Mathias Ortmann
- István Fábián
- James Bagg
- Benjamin Pahlke

______________________________________________________________________________

IMPORTANT NOTICE: Picasso96 support in (Win)UAE would not be possible without
the support and generosity of Alexander Kneer and Tobias Abt. Please donate
to the Picasso96 team if you use P96 and UAE together.  NOTE: Amiga Forever
from Cloanto includes a full Picasso96 license already, which is even more
reason to support a long-time Amiga software company. Click on the Picasso96
link in the About page of the WinUAE GUI for more information.
______________________________________________________________________________


Catweasel support
-----------------

- Windows driver installed: automatically detected
- No Windows driver installed and TVicPort
  - Windows 2000/XP/Vista: automatically detected
  - Windows 98x/ME: manual configuration required:
    Command line parameter "-directcatweasel 0xyzzzz" required.
    y = CW model (3 or 4, 3 is default), zzzz is io address in hexadecimal.
    IO address in configuration file is obsolete.


How to use hdtoolbox with full harddisk images
----------------------------------------------

Create hardfile normally or use harddisk image from your real Amiga but clear all
hardfile parameters except block size.(sectors, surfaces and reserved)

HDToolBox must be run with "uaehf.device"-parameter ("tools/hdtoolbox uaehf.device")

Amiga formatted harddisk support
--------------------------------

Requires Windows 2000 or XP with administrator privileges.

All Amiga formatted or empty drives (=zeroed partition table) are autodetected.
WinUAE does not care about interface type, drive can IDE or SCSI or even
memory card if Windows detects the drive in device manager.

Use uaehf.device to access the drive in HDToolBox.
Note that some versions of HDToolBox don't see drives with unit number > 6.
Remove some mounted harddrives (directory or hardware) to fix the problem.

WARNING: you can force all drives to be detected if you run WinUAE with
-disableharddrivesafetycheck command line parameter but be very careful.
Don't try to select and partition/format your Windows drive(s)!

NOTE: uaescsi.device or ASPI don't have anything to do with harddisk support.

Vsync-instructions
------------------
- works in fullscreen modes only
- select 50Hz or 100Hz refresh rate (PAL) or 60Hz/120Hz (NTSC)
- WinUAE skips every other frame if refresh rate is over 85Hz
- display driver must support refresh rate selection. VSync is not selectable
  if only available option in refresh rate selection box is "default"
- you can also select other refresh rates for "interesting" results :)
- your pc must be fast because missed frames will cause huge slowdown
- display emulation refresh rate must be set to "every frame"

Some display card test results:

- ATI Radeon/Radeon 8500, XP, 6052: refresh rate selection supported
- NVidia GF2, W2K, Detonator 27.52: refresh rate selection supported
- Matrox G400, W9x, 6.82.016: no refresh rate selection support (=no WinUAE vsync support)

Windows 9x/ME apparantly does not support refresh rate selection

CD32 emulation instructions:
----------------------------

Emulated:

- CDROM except CD audio fast forward and rewind (1) (2)
- 1Kb NVRAM (works just like console emulators' memory card)
- C2P
- Joypad (keys: /=RWD *=PLAY -=FFW 7=Green 9=Yellow 1=Red 3=Blue)
  You can use input-tab to configure pad mappings.

Notes:

- CD32 emulation mode is automatically activated when 512KB extended ROM is selected (ROM-tab)
- CD32 configuration: 68EC020,AGA,2MB chip,0 floppy drives
  (some games fail to load if number of floppy drives is > 0..)
- CD32's NVRAM (build-in 1024 byte flash RAM) file location can be specified in ROM-tab.
- CDXL animations looks quite bad. Better timing is needed.
- CD32 ROMs come with Amiga Forever 5.0+ or you can dump then from floppy drive extended CD32.
  Don't ask me for ROMs!
- Windows 95/98/ME users: IOS.VXD bluescreen = updated ASPI drivers required..
- If you have CD32 CD images, you can use daemon tools (http://www.daemon-tools.cc/) to mount them.
- Make sure harddrives panel is empty and uaescsi.device is disabled!

uaescsi.device instructions
---------------------------

- Makes your IDE ATAPI/SCSI CDROM drives available on Amiga side (1)
  Use Amiga CDFS, CDA players or CD burning software etc..
  (not tested with real SCSI drives)

1:
- requires working ASPI drivers (Windows 95/98/ME/2K/XP) or admin privileges (2K/XP)
  http://www.adaptec.com/worldwide/support/drivers_by_product.html?cat=%2fProduct%2fASPI-4.70&prodkey=ASPI-4.70
- no configuration option for drive selection yet.
2:
- no drive selection configuration yet, just insert disc in any drive and start WinUAE.


Action Replay 1 / 2 / 3 instructions
--------------------------------

- You need AR 1, AR 2 or 3 ROM (see below for rip instructions)
- Set path to Action Replay ROM file (ROM-tab, cartridge ROM)
- Freeze button = Page Up
- Don't use AR support to save game states, use build-in state save option instead.
  (much faster and compatible)
- WARNING: Action Replay don't like fast Amigas or 68020+ CPUs
  and max supported fast ram is 4MB.

Action Replay ROM Ripping instructions:

 Find A500 with Action replay-cardridge,
 press 'freeze'-button, write following:

 AR 1:

 lord olaf<RETURN>

 AR 2 and 3:

 may<RETURN>
 the<RETURN>
 force<RETURN>
 be<RETURN>
 with<RETURN>
 you<RETURN>
 new<RETURN> (AR 3 only)
 
 insert empty floppy disk into DF0:

 AR1: "sm ar1.rom,f00000 f10000"
 AR2: "sm ar2.rom,400000 420000"
 AR3: "sm ar3.rom,400000 440000"
 transfer ROM image to your PC


Improved debugger
-----------------

 - f-command extended:
    f without parameters = break when PC not in ROM and current instruction is not
    0x4ef9 (don't break when executing library jump tables) Great for finding start
    address of bootblock.
    f i = break when PC points to RTS/RTR/RTE-instruction
    f i <opcode> = break when PC points to instruction opcode <opcode>
    f <addr> = add/remove new breakpoint (max 8)
    fd = remove all breakpoints
    f <addr1> <addr2> = break when <addr1> <= PC <= <addr2>
 - W-command's value-parameter can be decimal 12345 or hexadecimal (0x12345 or $12345)
    write size is byte if val < 256, word if 255 > val < 65536 and long if val > 65535.
    (previous version's write size was always long and was limited to chip ram)
 - memwatch break points added, w <0-7> <address> <length> <r/w/rw> [<value>]
    break when address space between address and address + length is accessed and
    if accessed value = <value> R = break only on reads, W = writes, RW = both
 - i-command: interrups and traps combined, VBR supported
 - custom register dump -command added (e), dumps the contents of all existing registers
   between 0xdff000-0xdf1ff. ea = dump AGA color register contents.
 - CIA dump-output slightly modified, added TOD stopped status-flag and more.
 - exiting debugger automatically creates "memory state" and b-command can be used
   to "rewind"
 - bl lists all stored "state recorder" states
 - search-command s <"string">/<hexvalues> [<addr]> [<length>]
 - trace (t <cnt>) can be used to step over more than one instruction
 - wd = enable illegal access logger (all read or write accesses to nonexisting memory,
   read access to write-only memory or vice versa, accesses to "unofficial" cia and custom
   register address space etc..)
 - wd x y = disable logging between addresses x to x + y
 - H = list last 50 PC addresses (HH = addresses + flags). Only available if any breakpoint
   is enabled.

Drive sound customization
-------------------------

You can use external samples if you put files called drive_click_xxx.wav,
drive_spin_xxx.wav, drive_startup_xxx.wav and drive_snatch_xxx.wav
(xxx = whatever you want, "click" is the only mandatory sample)
to directory called <winuae path>\uae_data\

Multimouse
----------

Windows 98/98SE/ME: two or more USB mice required. PS/2 or serial mouse
can't be supported in real multimouse configuration.
Windows 2000: no real multimouse support.
Windows XP: all mice are supported.

Open Input-tab. Select any manual configuration (Configuration #1 to #4)
Open device select box. You should see "Mouse *", "Windows mouse" and
2 or more "Raw Mouse" (XP-only) or 2 or more mouse with real name
(98/98SE/ME). Make sure "Mouse *" and "Windows mouse" are disabled,
(select box next to device select box is unchecked) enable other mice
and make sure mappings are correct.

New in 0.9.90: Multimouse can be configured in "Game & I/O-Ports"-panel,
there is no need to do complex Input-panel configuration anymore.

Windows mouse?
--------------

"Windows mouse" is mouse that gets all movement events from Windows'
desktop mouse instead of DirectInput. Enable "Windows mouse" if you
think mouse feels sluggish compared to older WinUAE before DirectInput
was implemented. (and don't forget to disable "Mouse *" first or
mouse movement will be quite erratic..) Can't be used in multimouse
configuration.

Mousehack mouse?
--------------

Needed when using Tablets. Tablets only work properly if you select
"Mousehack mouse" and run Amiga-side program "mousehack". Without
mousehack "Mousehack mouse" is equal to "Windows mouse".
(mousehack-program is needed because regular mouse sends relative
movement data but Tablets are absolute devices)

WinUAE 1.3 update: mousehack-program is now built-in.

Mouse *?
--------

"Mouse *" is DirectInput system default mouse. "Mouse *" gets all
combined events from all connected physical mice. Can't be used
in multimouse configuration.


New ROM config entries in 1.1:
------------------------------

Syntax:
 kickstart_rom=v<ver>[.<rev>] [r<subver>.<subrev>] [<model>]
Only <ver> is mandatory. Model must be specified if requested
ROM file is not a regular Kickstart ROM.
Examples:
 v1.3 (select any autodetected 1.3)
 v1.2 r33.166 (must be KS1.2 revision 33.166)
 v1.2 A500 (KS1.2 rev 33.180)
 v2.05 A600HD (KS 2.05, rev 37.350 or 37.300)
 v3.1 r40.68 A1200 (KS 3.1 rev 40.68 A1200)
 v3.1 r40.68 (KS 3.1 rev 40.68, both A1200 or A4000 version allowed)
 v3.1;v3.0 (any revision of KS 3.1 or 3.0)
 v3 A1200 (A1200 KS 3.1 or 3.0)
 v2 AR (any Action Replay v2)
Multiple matches: highest available version is selected
Extended ROM config item: kickstart_ext_rom=
Cartridge ROM config item: cart=
Arcadia ROMs:
cart=Arcadia <name>, for example cart=Arcadia Xenon

---

Older changelogs:
-----------------


WinUAE 1.3.4 (30.12.2006)
=========================

Bugs fixed:

- Improved bsdsocket emulation stability
- Winuaeclipboard crash fix
- Windows Vista compatibility problems fixed
- Filesystem flag handling on FAT volumes
- Page Down-key Input panel remapping works properly
- Sound system improved
- ECS Denise/AGA borderblank feature works properly
- Dualcore/SMP random freezes properly fixed

and more minor fixes..

Bugs introduced in 1.3.3 fixed:
  
- AVIOutput out of sync fix
- CPU emulation condition code fix
- Fixed handle leak in bsdsocket and AHI
- Sound pitch shifting in VSync-mode and more..
- Catweasel MK4 mouse support

New features:

- Improved emulation of AGA sprites outside display window
- uaeserial.device introduced. Multi-port serial device, unit numbers
  are directly mapped to PC serial ports (unit 0 = COM0, 1 = COM1 etc..)
- Improved serial port detection, virtual devices also supported
- Improved Catweasel MK3/4 support without Windows driver installed
  (requires TVicPort, http://www.entechtaiwan.com/dev/port/index.shtm)
- Improved debugger features
- Sound system is not anymore reinitialized when losing/gaining focus
- 1M (1024KB) ROM image support
- Sound volume configuration setting also sets AHI audio volume
  (previously was Paula audio only)
- Custom chipset interrupt timing improved

And more..


WinUAE 1.3.3
============

- big E-UAE merge, cleanups, optimizations etc..

Bug fixed:

- Reboot loop if RTG RAM without Z3 RAM enabled (1.3.2 bug)
- Hardfile TD_GETGEOMETRY buffer overflow fix
- RDB emulation failed to mount partition(s) if RDB had one or more
  not needed filesystems and required FS was in ROM.
- Selecting "Mousehack mouse" crashed if HD emulation was not enabled.
- "Genlock connected" GUI checkbox fixed (1.3.2 bug)
- Clicking eject in GUI and immediately selecting another floppy image
  enables delayed insert instead of immediately inserting the image.
- Input panel key mapped to <none> reverted back to its default
  mapping after saving and loading the configuration.
- Directory filesystem Windows flag-AmigaOS flag handling fixes.
- Bsdsocket.library Remote Desktop compatibility fix.
- Dual core directory filesystem freeze workaround
- Some minor blitter timing and CIA emulation fixes.
- Stereo sound channel swap setting stored in configuration.

Major new features:

- Lightpen/lightgun emulation.
- Built-in 7zip decompression support.
- Unrar.dll rar archive decompression support.
- Sound emulation partially rewritten, better latency, possible
  fix for scratchy sound on some systems. Sound emulation will be
  automatically disabled when emulated audio subsystem is idle. Audio
  status led implemented.
- Better DMS error handling, encrypted DMS files are transparently
  decrypted.
- bsdsocket.library ReleaseCopyOfSocket() implemented (AmiVNC fixed)
- Improved AF rom.key support.
- ProWizard module ripper updated to latest version.
- 100% accurate sound emulation mode does not cause huge CPU usage
  anymore with specific games, for example Paradroid 90 and Rambo 3.
- Automatic direct IO Catweasel MK4 support if no Windows driver
  installed, CWMK4 can now be used under 64-bit Windows XP.
  TVicPort direct io driver required.


WinUAE 1.3.2
============

WinUAE 1.3.x bugs fixed:

- Debug window won't open automatically anymore
- HRTMon keyboard layout and WHDLoad commands fixed

New features:

- Mouse Up/Down and Left/Right input destinations supported
  simultaneously
- CD32 state save support (work in progress)
- A1000 Kickstart disk images can be used as a ROM image


WinUAE 1.3.1
============

WinUAE 1.3 bugs fixed

- Uaescsi.device freeze problem fixed.
- Boot freeze if A4000 ROM was used without AGA.
- Original extended ADF read bug.
- Larger than 1280 wide fullscreen modes work.
- Sound "led" filter configuration data was read incorrectly.
- AVIOutput does not split the AVI anymore when focus was lost.
- D3D filter fullscreen/windowed switching freeze fixed.
- Integrated mousehack access fault fixed.

New and improved features:

- AVIOutput codec settings stored in registry and other small tweaks.
- HRTMon updated to 2.30, WHDLoad-commands supported.
- Some custom chipset timing tweaks.


WinUAE 1.3
==========

New and improved features:

- Input event recording and playback (WIP)
- PC floppy drive drive sound emulation :)
- Mousehack-"driver" build-in.
- PC DD and HD floppy image support.
- Added improved audio filter and interpolation code from uade
  and other sound setting updates.
- Added build-in HRTMon debugger/monitor. (WIP)
- Action Replay for Amiga 1200 ROM image support.
- Arcadia emulation updates.
- Directory filesystem compatibility updates. (illegal characters in
  directory names work better now, some protection flag tweaks,
  more compatible disk capacity check if disk is very big,
  compatibility issues with \\server\share-directories fixed)
- Debugger updates. (improved trainer search command, fa-command,
  like in Action Replay, AGA color register dump etc..)

Bug fixes:

- Fix for random state restore freeze.
- AVIOutput crash, incorrect window size.
- Random Picasso96 screen mode switch crash.
- "Create hard disk imagefile"-option in harddisk settings fixed,
  previously it usually created corrupt hardfiles..
- Fixed garbage lines when program mixed interlace and
  non-interlace modes.
- D3D filter fullscreen freeze fixed.
- Priority-panel "pause emulation/disable sound output"-checkboxes
  were not initialized correctly.

And more smaller (and maybe bigger) changes..

WinUAE 1.2
==========

New features:

- New "lores filter" in GUI, fixes incorrect colors in programs that
  use superhires trick (eg. Virtual Karting, demo Rest-2).
- Logitech G15 keyboard LCD support.
- FPU emulation updates and fixes.
- Ability to create 1:1 HDF from Amiga formatted harddisk.
- ProWizard module ripper updated to latest version.
- Display Filter panel updates, added 1x,2x,4x,6x,8x multipliers.
  (not implemented in OGL/D3D filters yet)
- PNG screenshots.
- Light pen hardware emulated. (but no trigger or cursor emulation yet)
- Manual language selection.

Bug fixes:

- Right border color problems finally fixed.
  (Leander, T-Racer, Unreal etc..)
- Misc custom chipset emulation updates.
  (Bubba'n'Stix second level, Cover Girl Strip Poker title screen,
  Detonator, Thai Boxing, Wicked etc..)
- CIA TOD counter fix. (demo Harmony by Haujobb)
- Display was shifted by one pixel in lores-mode and horiz centering enabled.
- Overlay windowed mode one pixel position error.
- Swapped parallel port joystick adapter firebuttons.
- Toggling disk image's read-write status don't leave locked files anymore.
- Amiga Forever 2005 path detection should really work 100% now.
- Corrupted wav-files in 4-channel audio mode.


WinUAE 1.1.1
============

Bugs fixed:

- Incorrect AF 2005 path defaults.
- Blitter freeze in CE-mode if D-channel was not enabled.
- Misc/Priority panel crash when running under Windows 9x/ME.
- Parallel port emulation. (Gauntlet III)
- Two disk emulation bugs. (Xybots, Disposable Hero and others)
- Incorrect .uae extension path if -datapath -command line
  parameter was used.

New features:

- Old versions of AdaptecASPI and NeroASPI are now automatically
  rejected. No more crashes or bluescreens under Windows 9x/ME if
  Windows build-in ASPI is used.
- Full SCSI device support in SPTI-mode.
- Display panel resolution and depth moved to separate select boxes
- Disk history format changed. File name is now visible even if
  path is very long.
  

WinUAE 1.1
==========

Major bugs introduced in 1.0 fixed:

- Picasso96 graphics corruption after ALT-TAB
- Zipped Amiga Forever Kickstart ROM image decryption problem
- JIT FPU ACOS bug (incorrect result if argument was negative)

Older bugs fixed:

- More stable on the fly configuration loading
- In windowed mode Amiga window height was sometimes slightly
  larger than requested size
- "the desktop is too small for the specified window size"-check
  was not completely correct
- AHI recording mode memory leak
- Some Amiga monitor drivers work now properly (for example Euro36)
- Incorrect paths if WinUAE was run from networked drive
- Some custom chipset emulation bugs (Obliterator intro, Elfmania
  scoreboard, Warp and others)
- Directory filesystem directory modification date bug if comment
  or protection flags were modified
- Improved directory filesystem compatibility
- Rare disk emulation bug introduced in 0.9.90
- Action Replay statefile restore bug introduced in 0.9.90
- OCS/ECS color translation to native colors fixed. (this was bug
  since the beginning of UAE..) Colors are now slightly brighter.
  No effect on AGA-mode colors.

New features:

- Configurable Catweasel joystick support, MK4 mouse support added
  (NOTE: Right and middle mouse button may not work with all mice,
  requires Catweasel driver/firmware update)
- MMKeyboard support added
- Transparent "drive led status bar"
- SPTI (Windows 2K/XP) SCSI emulation includes non-CDROM SCSI devices
- Improved uaescsi.device SCSI interface selection
- Custom emulation updates (Death Trap, Loons Docs, Spanish Rose by
  Creed, Filled Perspective by Zero Defects, Himalaya by Avalanche..)
- Improved default path setting, Amiga Forever 2005 paths supported
- More missing keycodes added to input-panel
- Copper debugger: tracing, single step and breakpoint
- Disk swapper: right button doubleclick in "Disk image"-column:
  removes disk in disk swapper panel. right button singleclick in
  "Drive"-column: remove disk in drive
- New-style ROM config entries (see below)
- Compressed hardfiles supported (limitations: max 100MB, all written
  data will be lost after reset or exit, hardfile file name extension
  must be either hdz, zip, rar or 7z)
- Hardfile drag&drop to harddisk-panel

WinUAE 1.0
==========

Bug fixes:

- Fullscreen resolution reset if selected display mode's
  height was larger than width
- Sprite emulation improvements (Battle Squadron missing high
  score character and Bubba'n'Stix background mountains)
- Directory filesystem file/directory datestamp modification
  if file/directory's protection flags or comment was modified
  (broke in 0.9.92)
- Picasso96 RAM autoconfig area memory size error (16M or
  larger was always marked as 8M)
- proper AmigaForever ROM path autodetection
- AMOS filesystem freeze (workaround only, proper fix unknown)
- Kickstart 1.2 was not autodetected (wrong CRC32)
- improved JIT direct access memory area allocation (fixes JIT
  direct mode problems with some Pentium 4 or NForce 3/4 boards)
- In some cases all priority-levels were changed to "Above Normal"
- bsdsocket crash fix
- Fixed swapped audio channels
- Picasso96 compatibility problem with Directory Opus 4.12
- Random crash fixed while using external drive sounds or while
  loading new configuration on the fly
- Emulation fixes (Shinobi, Double Dragon 2.., broke in 0.9.91)

New features:

- Catweasel Windows driver support, MK1/MK3/MK4 supported
  (MK4 direct floppy support and Amiga mouse support coming later)
- Nero Burning ROM ASPI is automatically used if Nero is installed
  (better compatibility than Adaptec ASPI)
- Arcadia (Amiga 500 based Arcade system) game support
- Disk swapper-panel improved (path edit box and history added)
- bsdsocket emulation does not ask for internet connection if
  requested address is localhost
- Emulation improvements (some Digital's demos, demo Tenebra partially
  fixed, 3v Demo by Cave, New Year Demo by Phoenix, game Sci-fi
  graphics corruption, Battle Squadron highscores, Bubba'n'Stix
  background etc...)
- Sound sample ripper
- Improved debugger

--

WinUAE 0.9.92 "WinUAE 1.0 public beta #3"
======================================================

Final beta before 1.0 (?)

Bug fixes:

- Regular HDF TD_GEOMETRY returned incorrect data. (caused some
  larger HDF's fail to mount, 0.9.91 only)
- Filesystem bug fix (0.9.90-91), files with Windows
  System or Hidden -flag set didn't open properly in all cases.
- Stardust starwars-scroller in cycle-exact mode.
- SuperStardust AGA tunnel-section and Superfrog intro bee flashing
  plus other sprite emulation fixes.
- Random disk formatting verify errors when using non-turbo mode
  (was broken couple of releases ago)
- Display corruption/crashes if display width was larger than 1024
  and display depth was 32bit (only native display mode, Picasso96
  was unaffected)
- Windowed mode window close button didn't work if "Use CTRL+F11
  to quit" was enabled
- input-panel autofire yes/no-selection
- AVIOutput video recording bug in interlaced modes

New features:

- Filesystem emulation now uses NTFS named streams to store Amiga
  FS protection flags and comment instead of __UAEFSDB.__-files.
  (non-NTFS drives still use old method)
- Postscript printer emulation using Ghostscript. All Windows
  supported printers work. Amiga-side only needs standard Amiga
  Postscript printer driver.
- Automatic print job flush after user configurable timeout.
- Improved hardfile creation, filesystem selection (OFS/FFS/SFS) etc..
- Disk swapper key shortcuts. (both GUI and in emulation)
- GUI drag'n'drop. (no more ugly up/down arrows)
- screenshots are now named <name of disk image>_xxx.bmp
- user configurable emulation speed adjustment from 5 to 100 fps
- rar and 7zip -archive support (using archiveaccess.dll)
- some custom chipset emulation improvements here and there.
- improved drive click sound emulation (requires separately downloadable
  sample package)
- X-Arcade build-in key mappings
- onscreen disk and HD leds flash red while writing
- "Always on top"-windowed mode setting

--

WinUAE 0.9.91 "WinUAE 1.0 public beta #2"
=========================================

Bugs in 0.9.90 fixed:

- Multiple directory filesystem emulation bugs (files getting truncated
  to zero if opened in rw-mode, read-only files failing to open and some
  operations returning incorrect AmigaDOS error codes)
- AGA horizontal scrolling bug in some games.
- Stereo separation setting was not always set properly.
- Another task-switching Direct3D/OpenGL-mode problem.

Other fixes and updates:

- Picasso96 black screen after CTRL-ALT-DEL.
- bsdsocket update, fixes ~2 second pause on some systems and
  added internet connection off-line check (Stephen Riedelbeck)
- CPU idle calculation update. CPU Idle-setting may need re-adjusting.
- PP Hammer and Spindizzy Worlds graphics flicker fixed in non-cycle
  exact mode (again..)

New features:

- "uae-configuration" Amiga side program that can list current configuration,
  change all configuration parameters and send any inputevent on the fly.
- Both right alt and ctrl are mapped to firebutton in keyboard layout B
  (some laptops don't have right ctrl key).
- disable quickstart-mode if using -f or -config= -command
  line parameters

--

WinUAE 0.9.90 "WinUAE 1.0 public beta #1"

New features:

- New Quickstart-panel. Easy and fast way to run disk-based games or
  demos. Simply select Amiga model, compatibility level, disk image
  and click start!
- Hardware and host configuration separated. Create and use your own
  custom host configurations instead of build-in host configuration.
  data from standard configuration files.
- Kickstart ROM scanner and autodetection. (only official ROMs supported)
  Old-style ROM selection is still supported.
- User configurable graphics filter presets.
- Scaling support in all software filters.
- Paths-panel added. User configurable ROM, statefile, screenshot etc.. paths.
- Automatically return back to GUI if Kickstart ROM fails to load.
- Added help-tooltips here and there.
- More compatible paraport direct parallel port support.
- Mapped filesystem P-flag to Windows System-flag, H-flag to Hidden
  and fixed inverted archive-flag.
- Replaced "PC Joystick 0", "PC Joystick 1" and "PC Mouse" with select box
  listing all available input devices.
- Configurable stereo separation and stereo mixing delay.
- uaehf.device TD_GETGEOMETRY support.
- USB keyboard led support.
- Fullscreen mousehack (Tablet) support.
- Directory filesystem emulation Windows Recycle Bin support.

Bugs fixed:

- Ages old right border horizontal centering graphics bug.
- ECS Agnus was always reported as an OCS Agnus (0.8.26)
- 68000 cycle-exact mode compatibility (0.8.26)
- Floppy emulation writing bug (0.8.26, fixes SWOS disk error when saving).
- Dialogs in fullscreen mode.
- On the fly switching between A1000/CDTV/CD32 modes.
- Swapping disk image sometimes changed another drive's disk image.
- German keyboard #-key.
- Windowed mode DFx,Power,etc.. "leds" are now non-96DPI compatible.
- Minimized WinUAE jumping back to fullscreen by clicking on other program's
  taskbar buttons and other ALT-TAB handling updates.
- CD32 pad emulation.
- AIBB crash in 68020-mode.
- Debugger keyboard freeze on some Windows 2000 systems.


WinUAE 0.8.27
=============

Bugs in 0.8.26 fixed:

- JIT-only crash when loading state file or loading new
  config on the fly
- crash when loading config and directory or no config
  file was selected
- ports-page uninitialized joystick/mouse radio buttons
- ignore files not having .uae-extension when scanning
  configuration file directory
- GUI works now with non-96DPI fonts
- possible crash when starting emulator or inserting/ejecting
  disks
- JIT compatibility problems with some games (for example
  Alien Breed 3D II)
- debugger am-command
- "Priority=2!"-debug dialog
- disk image path/name text input

Older bugs fixed:

- centering improved
- hardfile error "tried to seek out of bounds"-message when
  hardfile was too small or blocksize was set to zero
- fullscreen D3D/OpenGL-mode ALT-TAB
- fixed forever repeating "...because desktop is too small for
  the specified window size.."
- saving config: always add (if missing) ".uae"-extension to
  config file name
- "exter_int_helper: unknown native action xxx"

New features:

- new rtg.library, 20-30 times faster Picasso96 pixel read
- don't add contents of zip file to disk history if zip only
  contains one supported disk image file
- compatibility fix for buggy programs that access non-existing
  memory in CIA address space
- MIDI can be selected without serial port
- full collision level implemented correctly (game "Rotor")
- AVIOutput tweaks
- improved compatibility (Back in Bizness, Total Triple Trouble)


WinUAE 0.8.26
=============

Bugs fixed:

- custom chipset emulation updates (Aunt Arctic Adventure
  collision detection, Warhead music and sound effects etc..)
- very old FPU emulation bug
- bsdsocket emulation (AmiTradeCenter, CTRL-C signal check)
- interrupt level 7 freeze
- uaescsi.device MODE SENSE/SELECT translation
- Picasso96 WaitForVSync fix (Fake Electronic Lightshow" by
  Ephidrena)
- Picasso96 8-bit mode palette problem (black Workbench
  background color after returning from Windows desktop)
- MIDI-IN random freeze

New features:

- new GUI!
- improved GUI pages
- systray icon and shortcut menu
- improved drop and drop support
- faster END+PAUSE warp-mode
- 68020+/JIT crash prevention
- debugger improvements
- floppy drive disk image history list
- disk swapper page for swapping quickly multi-disk games
- integrated Pro Wizard module ripper (http://asle.free.fr/prowiz/) 
- improved IPF (CAPS) and FDI support


WinUAE 0.8.25
=============

Bugs fixed:

- DirectDraw error when starting WinUAE 0.8.24 if display card supports multiple
  heads and one or more head is disabled (also depends on display driver)
- crash when starting emulation if more than 2 mouse-like devices are detected
- floppy drive sound emulation volume level was not saved to config file
- floppy drive sample rate conversion was broken, sound quality was
  very bad if selected sample rate was not 44100Hz.
- multimouse support under Windows XP
- bsdsocket emulation update, fixes CNet's SMTPd
- uaescsi.device IDE ATAPI CDROM translation support, fixes PlayCD

New features:

- right border is not clipped anymore if program uses overscan
  (Settlers, Pinball Illusions etc..)
- fixed display corruption in some older programs
  (Mystic Tunes by Vertical, Bierkrug-tro by TEK, Forgotten Realms
  Slideshow '90 by Fraxion etc..)
- AVIOutput improved, much faster recording if any software filter
  (null filter recommended) is enabled
- readme.txt updated. (custom drive sounds, how to use multimouse etc..)


WinUAE 0.8.24
=============

Bugs fixed:

- Windows 9x/ME duplicate keypresses when using USB-keyboard
- bsdsocket emulation updates (TCP:<port>, Apache)
- saving compressed state file without zlib1.dll created broken state file
- crash after saving four or more state files

New features:

- improved multimonitor compatibility
- sound volume slider and keyboard shortcuts
  (END+numpad -, END+numpad + and END+numpad *, also multimedia keys Volume +- and Mute)
- configurable floppy drive sound emulation :)
- improved debugger (new breakpoints, memwatch points etc.. see below)
- Windows XP-compatible multimouse support, improved input-support
- FDI 2.0 disk image format

and some smaller updates..


WinUAE 0.8.23
=============

Bugs fixed:

- mousebutton getting stuck randomly when WinUAE lost focus
- floppy drives' state was not restored fully
- fixed crash when switching from 68000 to JIT-mode
- bsdsocket browser freezes/slowdowns
- SPTI CDROM media change detection
- parallel port joystick adapter works properly again
- saving state in ce-mode with blitter active created broken state files
- serial port/MIDI randomly lost received characters

New features:

- maprom emulation (BlizKick support)
- first CDROM is always uaescsi.device unit zero, second is zero etc.. and then
  other non-CDROM SCSI devices.
- improved priority settings
- improved filter options
- compatibility improvements
- bsdsocket emulation improved (Jabberwocky)
- faster Picasso96 solid window moves
- improved AHI emulation
- IRQ level 7 shortcut in input-tab
- percentage of CPU in use -meter added next to FPS-counter
- immediate state save (no need to exit the GUI anymore)
- dropped release numbers :)


WinUAE 0.8.22 Release 9
==============================================================================

Bugs fixed

- compiler misoptimization of some rare instructions
  (affected 0.8.22R8 only, usually caused GURUs)
- bsdsocket emulation (connection freeze, IRCD, AmyGate etc..)
- NTSC vsync sound
- Windows 2K/XP CD detection problems in non-ASPI mode
- more compatible audio emulation
  (TBL's Tint, some demos playing only noise)
- ticking/unticking 68000 "more compatible" checkbox on the fly
  does not crash the emulated Amiga anymore
- AVI capture sound sync

New features:

- software 2x filters (Scale2x, SuperEagle, 2xSaI and Super2xSaI) and
  manual screen position adjustment.
- separate windowed and fullscreen mode width and height
- 100% exact blitter block mode cycle diagram (cycle-exact mode only)
- replaced "run at higher priority" with priority selection select box
- added CAPS support to mini-version
- automatic AVI splitting


WinUAE 0.8.22 Release 8
==============================================================================

Bugs fixed:

- stuck joypad POV directional controller
- joystick keyboard layout B and C second firebutton
- workaround for buggy sound driver (ISA SB16, maybe others)
  that report zero as minimum and maximum supported sample rate
- possible crash when copying to virtual filesystem's root
- CD32 media change detection
- extended ADF write protection check
- extended ADF HD floppy support
- fast copper works again + config file support
- JIT FPU fix (Descent Freespace -demo)
- 57600 serial bit rate was incorrectly rounded to 56000
- ~2.8GHz+ CPU clock rate calculation overflow

New features:

- all configuration file loading restrictions removed,
  load new configuration file at any time!
- display width, height, depth, lores, doubling, correct aspect
  can be changed on the fly
- bsdsocket.library updates
- Picasso96 emulation optimizations
- improved audio emulation
  (Mortville Manor, Maupiti Island speech and Fighting Soccer)
- AHI driver update
- improved and more compatible CD32 pad emulation
- improved CD32 CD autodetection
- sound capture to wav-file
- Direct3D hardware filtering and scaling
- more configurable source tree, added very simple way
  to disable features like AGA, JIT, bsdsocket, Picasso96,
  harddisk, 68020+ etc..
- separate basic A500-only WinUAE executable included (winuae_mini.exe)
- quick state save (SHIFT/CTRL + END + numpad 0-9) and restore support (END + numpad 0-9)


WinUAE 0.8.22 Release 7
==============================================================================

Bugs fixed:

- printer didn't work if serial port emulation was enabled
- palette wasn't updated properly when entering and exiting the GUI
  in fullscreen 8-bit Picasso96 mode
- button or key mapped to mouse horizontal or vertical axis
- random crash when horizontal centering was enabled
- bsdsocket emulation, ping, traceroute, AmTelnet SSH connection freeze
- config save crash and non working keyboard
- ShapeShifter-support improved, all Kickstart 2.x/3.x versions supported
- lores-mode support for "sprites outside display window"-feature
- and more..

New features:

- emulation compatibility improvements
  Elfmania, Rainbow Island (broke accidentally in R6),
  Mission Elevator (properly fixed this time...), SWIV,
  Old Timer, Inferior, Sub Rally, Sargon History, TBL demos,
  Sound of Silents, Cardamom, Cardamon etc..
- analog joystick (paddle) ports emulated
- improved hard/ZIP disk RDB detection
- Action Replay 2/3 state file support
- sound "power led" filter emulation
- freely selectable sound sample rate (8000 - 48000)
- "direct" serial port support, fixes PC to PC Lotus 2 serial link
  problems. (two player only, 3 or 4 players require lower serial
  latency that is not possible under Windows)
- zipped CAPS-image support
- updated AHI driver included

WinUAE 0.8.22 Release 6
==============================================================================

Bugs fixed:

- increased compatibility
- display emulation graphics corruption in some programs
  (NOTE: some very old games, for example Eliminator, require OCS Agnus)
- sprites outside display window emulated partially
  (Banshee AGA, Alien Breed 3D)
- audio emulation fixes (noise and random popping)
- input configuration fixes
- crash when creating new CD32 NVRAM-file
- compressed disk images can be write-enabled
- more compatible with newer CDTV extended ROMs
  (still no CDROM controller emulation)
- disk emulation fixes (writing freeze, drive type, disk eject/insert,
  more compatible disk change detection, writing to multiple drives simultaneously)
- stuck middle button when "Middle Mouse-Button -> ALT-TAB" was enabled
- don't crash if zlib.dll is missing
- lost mouse input events when using high refresh rate mouse

New features:

- compressed state files
- rewritten and more compatible serial port emulation,
  serial link game support
- more compatible blitter speed in non cycle-exact mode
  (Spindizzy Worlds, PP Hammer..)
- turbo-floppy speed enables fast writing
- disable screensaver when WinUAE is active
- improved configurable CPU idle-function
- screenshots saved to ScreenShots-directory
- input configuration joystick port swap and device
  disable-button implemented.

WinUAE 0.8.22 Release 5
==============================================================================

Bugs fixed:

- CD32-mode media change detection
- SlowRAM detection fixes (Commando and more)
- more compatible CIA keyboard emulation (Back to the Future 2 and more)
- bsdsocket.library emulation updates (Stephen Riedelbeck)
- state restore fixes
- fixed mouse problems in Space Crusade, Billy the Kid etc..
- writing to custom floppy images was unstable
- primary sound buffer-checkbox removed and disabled. It is useless and usually
  only caused huge slowdown problems.
- PC Competitor interface's second joystick works properly
- improved compatibility (fixes USGold Murder, Crack Down, Liverpool,
  Pinball Hazard, future CAPS-images etc..)
- SuperHires sprite fix (SkidMarks AGA)
- another Pentium 4 JIT-crash workaround
- improved Action Replay support (Mark Cox)

New features:

- configurable boot priority and device name for regular (non-RDB) hardfiles
  and virtual directory filesystems
- configurable filesystem for regular hardfiles. (Automount/boot for example
  SmartFileSystem formatted regular hardfiles)
- FPU state file support
- configurable keyboard leds (DF0,DF1,DF2,DF3,POWER,HD,CD)
- floppy write-protect state added to floppies-tab
- implemented write-support for images that don't support writing
  natively (compressed images, CAPS-images)
- Amiga program p96refresh for selecting mousepointer refreshrates in
  Picasso96 mode (Bernd Roesch)
- "Middle-Mouse-Button -> ALT-TAB" works now in fullscreen mode
- improved input-tab GUI, increased number of input mappings from 1 to 4
- CD32 pads are now enabled in non-cd32 mode if configured in input-tab
- state files are saved to SaveStates-directory (was Configurations..)

WinUAE 0.8.22 Release 4
==============================================================================

Bugs fixed:

- changing joystick options in ports-tab caused joystick to not respond in some cases
- bad performance on laptops with power saving enabled
- mouse handling updates
- RDB SmartFileSystem 1.58 (and older?) crash fixed
- more filesystem bug fixes
- uaescsi.device reset crash on Win9x
- some games had problems detecting slow ram (for example Lotus 3), fixed
- MIDI SYSEX buffer overflows fixed
- sound timing always defaulted back to PAL when WinUAE lost or gained focus, fixed
- more ALT-TAB switching problems fixed (I hope so..)

New features:

- improved FPS counter
- filesystem notification (ACTION_ADD_NOTIFY, ACTION_REMOVE_NOTIFY) support added and more..
- CD-led is lit when CD32 audio track is playing
- new keyboard shortcuts: PAUSE-pause emulation, PAUSE+END-turbo speed
- CAPS-image support
- Catweasel MK3 support (joystick ports, keyboard and Zorro2-board emulation for multidisk.device)
- 1.5MB slow RAM support

WinUAE 0.8.22 Release 3
==============================================================================

Bugs fixed:

- Ports-tab crash fixed
- joystick handling fixes
- hard drive configuration save fixed
  (trailing spaces are now removed from HD ID-string)
- fixed stuck keys when switching between WinUAE and Windows
- sprite fix (some games had flashing sprite garbage)
- thread priority tweaks
- setupapi.dll error when running under Windows 95
- emulation slowdown and sound stuttering in 68000 mode (finally?)
- Amithlon partition detection fixed (detection failed if drive's
  partition table contained more than 6 partitions)
- jumpy mouse fixed
- hardfile not found -bug fixed
- "The selected screen mode can't be displayed in a window, because.." now correctly
  forces fullscreen mode instead of repeating the message forever..

New feature:

- implemented harddisk and CD-leds that flash during HD/CD access

WinUAE 0.8.22 Release 2
==============================================================================

New features:

- Kickstart 1.3 RDB and regular hardfile autoboot/automount support
  KS 1.3 regular (non-RDB) HDF autoboot requires FastFileSystem from WB1.3:L in KS roms-directory
- keyboard/mouse/joystick handling rewritten for DirectInput
  Windows keys are now 100% usable as an Amiga keys and SHIFT-keys don't get stuck anymore
- mouse speed configuration
- all keyboard keys (even special "multimedia keys") are available in input-tab configuration window
- configurable floppy drive type (3.5"DD/3.5"HD/A1010 5.25"SD)
- screenshot button moved from F11 to PrintScreen. PrintScreen = copy to clipboard,
  END + PrintScreen = write to ScreenShots-directory.

Following features require Windows 2000 or Windows XP

- "unlimited" hardfile size (2G limit removed),
  uaehf.device now supports TD64 and NSD -style 64-bit addressing
  NTFS filesystem required for >4G hardfiles (FAT32 max file size is about 4G) 
  WARNING: Make sure installed AmigaOS is new enough (OS 3.9 recommended)
- ability to mount real harddisks with full RDB automount/autoboot support
- Amithlon partition support

Bugs fixed:

- Slow harddisk, CDROM, etc.. performance in non-CPU idle mode
- CPU idle tweaks, defaults to off, config file support
- disk emulation improvements
- added missing configuration file entries
- better compatibility with old config files
- 68000 "more compatible"-checkbox works again
- fixed uaehf.device crash with older HDToolBox versions
- custom chipset fixes (Chaos Engine AGA/CD32, Obliterator, Terrorpods etc..)
- GUI's screenshot-button was always disabled
- state file restore fixes (CPU type is automatically restored correctly and more)
- switch from fullscreen/no-vsync to vsync-mode crash fixed
- filesystem "ghost"-file bug fixed (but filesystem emulation still have some bugs left..)
- bsdsocket emulation compatibility fixes
- fixed serial and printer port defaults

WinUAE 0.8.22 Release 1
==============================================================================

fixes/updates:

- UAE 0.8.22 merge, bumped version number (but most changes were already included in R4)
- 68000 CHK-instruction fix (Days of Thunder) and exception 3 handling update
- real 68000 prefetch emulation ("100 most remembered C64 games" and more)
- some custom chipset fixes (sprite-playfield collisions, graphics corruption)
- keyboard fix (some key presses were missed when pressing multiple keys)
- A1000 emulation fixes
- AVIOutput update (Sane)
- input-tab updates
- vsync works properly in interlaced screen modes
- sound updates/changes (DirectSound, uses UAE timing in non-JIT/vsync modes and more...)
- filesystem bug fixes
- CD32 pad numeric keypad emulation works again
- fixed joystick bugs in compatibility mode
- fast RAM state save fix
- bsdsocket fix (Stephan Riedelbeck)
- disk emulation fixes

new features:

- full harddisk image support (hdtoolbox, RDB, custom filesystems, SFS and PFS3 confirmed working)
- uaescsi.device improvements, confirmed compatible with CacheCDFS, AmiCDFS and AsimCDFS
  (disk change support added and use of direct scsi-mode is not needed anymore)
- Action Replay 1 support (but breakpoints don't work)
- CPU idle (tries to detect use of STOP-instruction, may not be complatible with all Amiga software..)
- floppy speed slider is back
- new AHI code and driver (Bernd Roesch)
- Amiga <> Windows clipboard support (Bernd Roesch)
- on the fly switching between OpenGL and DirectDraw mode
- on the fly switching between vsync and non-vsync mode
- compressed Kickstart ROM image support
- build-in screenshot function, shortcut key: F11 (Sane)
- experimental (and much slower) cycle-exact cpu and blitter emulation mode
  WARNING: requires at least 50%+ more cpu power than "regular" mode.
  Athlon XP/Pentium IV + DDR/RAMBUS RAM highly recommended!
  WARNING2: Frameskip must be set to 1
  WARNING3: very experimental, timing is quite far from perfection
- wkeykill.dll support (disables Windows-keys)
- OpenGL scanline brightness slider added

and more..

WinUAE 0.8.21 Release 4
==============================================================================
- EXPERIMENTAL: added configurable input device (mouse, joystick, keyboard) support
- EXPERIMENTAL: added OpenGL mode (for best results set lores and disable line-doubling)
- printer support fixed (Bernd Roesch)
- MIDI updates (Bernd Roesch, Alfred J. Faust)
- custom chipset updates (Superfrog,Exile,Apocalypse,Rainbow Islands,Torvak the Warrior...)
- disk emulation fixes (Typhoon Thompson,SuperDuper,S.T.A.G...)
- CPU idle patch (no more 100% CPU usage)
- HOME + F5 opens state restore dialog and SHIFT + HOME + F5 opens state save dialog
- vsync updates
- AVIoutput improvements (can be started later, stops when re-entering GUI)
- Picasso96 updates. Mouse trails are now 100% fixed (Bernd Roesch)
- refresh rate selection only affects Amiga display modes, Picasso96 always use default refresh rate
- "16-bit mode detect" crash fixed
- removed useless 8/16-bit sound selection. Sound output is now always 16-bit
- sound lag compensation slider reimplemented. (if you have bad sound, move slider left until sound gets better)
- build-in gzip and zip support (autoselects first adf-image or Amiga executable if zip contains multiple files)
- executable to adf support, just "insert" Amiga executable in to floppy drive
- improved external decompression support (xdms.exe)
- configuration save option is now available even after emulation has been started
- HD floppy image support in disk-tab

WinUAE 0.8.21 Release 3
==============================================================================
- experimental vsync support, refresh rate selection and triple buffering implemented. (me)
  See below for instructions.
- extended CDTV ROM supported. (me)
  Note that CDROM hardware isn't emulated yet.
- joystick emulation fixes. (me)
- Picasso96 fixes. (Bernd Roesch)
- DirectX 7 or newer required. (was DX 5 or newer)
- custom chipset emulation compatibility updates. (me, Bernd Schmidt)
- Shapeshifter-checkbox fixed. (patch from WinUAE 0.8.17)
- hardfile fix, Reorg works again. (patch from WinUAE 0.8.17)
- serial port update. (Bernd Roesch)
- JIT CPU emulator update (from BasiliskII-JIT)
______________________________________________________________________________

WinUAE 0.8.21 Release 2
==============================================================================
- FIXED:   custom chipset emulation fixes (me, Bernd Schmidt)
- FIXED:   JIT FPU (Bernd Roesch)
- FIXED:   filesystem emulation (Bernd Schmidt, Stephan Riedelbeck)
           (read-only files are handled correctly, programs in WBStartup
           aren't run multiple times anymore, A-flag handling fixed)
- FIXED:   PC joystick 2 (me)
- FIXED:   mouse 2 emulation (me)
- FIXED:   multiple CD32 CDROM and uaescsi.device updates (me)
- FIXED:   bsdsocket (Bernd Roesch, Stephan Riedelbeck)
- FIXED:   configuration GUI memory leak fixed (Stephan Riedelbeck)
- FIXED:   keyboard problems (me)
           (problems with SHIFT key and Action Replay activating when exiting GUI)
- FIXED:   CD32 pad button emulation
           (some games had problems with red button)
- FIXED:   serial port updates (Bernd Roesch, me)
- CHANGED: sound emulation (me, Bernd Schmidt)
- ADDED:   CD32 media eject/insert support (me)
- ADDED:   CTRL-AMIGA-AMIGA-ALT resets and clears chipmemory (me)
           (use to remove reset proof programs)
- ADDED:   "pause emulation while minimized"-option to misc-page (me)
- ADDED:   FDI-support is back (me)
______________________________________________________________________________

WinUAE 0.8.21 Release 1
==============================================================================
- Maintainer change, new WinUAE maintainer is Toni Wilen
- CHANGED: Many custom chipset fixes and updates (Bernd Schmidt, me)
- CHANGED: Audio code replaced with SDL audio (Bernd Schmidt)
           Remember to re-adjust sound buffer size
- FIXED:   CPU emulation fixes (Bernd Schmidt, me)
- FIXED:   Filesys seek fix (Bernd Roesch)
- FIXED:   JIT compatibility fixes (Bernd Schmidt)
- FIXED:   State save fixes (Bernd Schmidt, me)
- FIXED:   Prevent notebook CPU throttling when calculating CPU speed (Bernd Roesch)
- ADDED:   New input device code (me)
- ADDED:   Full CD32 support (me)
- ADDED:   Action Replay 2 and 3 support (me)
- ADDED:   CDROM scsi.device emulation (Win32 port by me)
- ADDED:   Sane's AviOutput patch
_____________________________________________________________________________
WinUAE 0.8.17 Release 3
==============================================================================
- FIXED:   Mouse trails are gone gone gone.
- FIXED:   No longer crashes in windowed-mode on XP Themed-view.
- FIXED:   68020+ bitfield instruction fix (stuck doors in Dungeon Master AGA)
- FIXED:   Fix garbage display on Venus the Flytrap and Nightbreed Interactive
           Movie. (Toni Wilen)
- FIXED:   Trying to delete a non-empty directory will now properly return
           ERROR_DIRECTORY_NOT_EMPTY. (Bernd Roesch)
- FIXED:   Renaming a directory which was opened then closed will no longer
           crash. (Bernd Roesch)
- FIXED:   Increased the range of addresses checked for memory-mapping, in
           order to make JIT "direct" mode work on more systems. (Bernd
           Roesch)
- FIXED:   Selecting a Picasso96 8-bit mode in windowed-mode would complain
           about not matching your desktop's depth, and switch to full-screen.
- FIXED:   CD-ROM Mounting should work again.
- FIXED:   Installer won't install when WinUAE is already running.
- FIXED:   Right-click and "Editting" a .UAE config-file will now result in
           the correct config-name and config-description in the GUI.
- FIXED:   MIDI-Out won't crash external MIDI drivers like "hubies loopback".
           (Bernd Roesch)
- ADDED:   Jose's modifications to the sound routines and GUI. (Jose Gil)
           NOTE: Read doc called "SoundSyncro Readme.rtf"
- ADDED:   AHI driver support. (Bernd Roesch)
- ADDED:   Option to disable use of overlays completely.
- CHANGED: Floppy-disk emulation, including .FDI support. (Toni Wilen)
- CHANGED: Picasso96 licensing/support notice (above).
- CHANGED: Removed references to "Amiga" in the GUI.
______________________________________________________________________________
WinUAE 0.8.17 Release 2
==============================================================================
- FIXED:   Fixed the center_image() routine which was causing crashes with
           centering inside of screens less than 800x600.
- FIXED:   Remove hard dependency on RegisterDeviceNotification API so that
           WinUAE still works on Win95.
- FIXED:   Event timing works better now, and shouldn't hang any demos or
           games. (Bernd Schmidt)
- FIXED:   Max out at 512-Megs of ZorroIII RAM, since 1-Gig won't work.
- FIXED:   Merged in some CIA-related save-state changes. (Bernd Schmidt)
- FIXED:   Banshee AGA and Lemmings3 AGA are now mostly working, thanks to
           new delay-offset code.  See the "KNOWN BUGS" section above for
           further details. (Toni Wilen)
- FIXED:   Sound-syncro settings can be changed on-the-fly. (Jose Gil)
- ADDED:   New version of "uaediskchange" utility.  Put this inside your
           "Amiga" installation, and call it in your startup-sequence like
           "run >nil: c:uaediskchange cd0:" to watch cd0: for disk-changes.
           You can watch more than one drive. (Bernd Roesch)
- CHANGED: Tweaked the sound-syncro code again. (Jose Gil)
- CHANGED: Creating an AmigaDOS .adf file from the GUI will now create a
           formatted disk. (Toni Wilen)
- REMOVED: No restriction on only being able to run one instance of WinUAE.
           NOTE: USE THIS WITH CAUTION.
______________________________________________________________________________
WinUAE 0.8.17 Release 1
==============================================================================
- FIXED:   Various AGA and chipset-related fixes. (Bernd#1, Toni Wilen)
- FIXED:   .GZ support in floppy dialog doesn't cause corruption. (Timothy)
- FIXED:   Updated sprite-collision logic which fixes Leander, Archon 1 and 2,
           Menace, etc. (Toni)
- FIXED:   Updated disk-emulation code, for higher compatability.  Also now
           supports .fdi and high-density .adf images. (Toni, Adil Temel)
- FIXED:   60Hz support in Dynablaster and BC Kid (Toni Wilen)
- FIXED:   BSD-Socket emulation is mostly working, although bugs still exist.
           (Bernd#3)
- FIXED:   Picasso96 screens smaller than their display-mode would have crap
           in their left-hand-border if you grabbed the screen's title-bar and
           moved the screen to the right.
- FIXED:   Updated copy of rtg.library, including more patches. (Bernd#3)
- FIXED:   You can set the WinUAE resolution in full-screen to whatever you
           desire.  Especially useful so that you set your full-screen size to
           match your desktop size, and it will prevent all your desktop icons
           from moving around after exitting WinUAE. (me, Georg)
- FIXED:   Stupid sound_channels=0 stuff in config-files works properly.
- FIXED:   Stupid gfx_center_xxx=yes/no stuff in config-files works properly.
- FIXED:   Selecting an item in the Hard Drives page of the GUI and then
           moving its position in the list now leaves the item highlighted.
- FIXED:   Detect OS version early, and inform the user appropriately instead
           of crashing.  Windows NT is no longer a supported OS for WinUAE.
- FIXED:   Various little off-by-one pixel errors in the GUI.
- FIXED:   MIDI in/out lists in the Ports page of GUI were behaving strangely.
- FIXED:   Floppy-disc emulation change to allow Shadow of the Beast Trainer
           to work. (Toni Wilen)
- FIXED:   Small change in MIDI support so that closing MIDI and then
           reopening it will work properly. (Bernd Roesch)
- FIXED:   Call ahi_install in main.c.  No Amiga-side AHI driver yet.
- FIXED:   MIDI-input doesn't have the concept of a "default device", unlike
           MIDI-output.  Changed the GUI and programming accordingly.
- FIXED:   MIDI-output now does the right things with the serial-port after
           each written byte, which allows some other programs to finally
           work (MusicX, Deluxe Music, etc.)
- ADDED:   New hook function in uaelib for checking on removable drive state.
- ADDED:   Disk-change status is now tracked via WM_DEVICECHANGE notifications
           which allows "run >nil: uaediskchange cd0:" in the startup-sequence
           to work properly.  Eject a CD-ROM, and the Amiga knows about it.
           Insert a new CD-ROM, and the Amiga knows about it.  Woo-hoo!
           NOTE: Probably really buggy.
- ADDED:   New collision-modes, fast-copper mode (not save-able with config).
- ADDED:   State-save support. (Toni Wilen)
- ADDED:   Option in Sound page of GUI to enable/disable synchronized sound.
- ADDED:   Printing of DDCAPS info for display-driver, to help diagnostics.
- ADDED:   FDI disk-image support (Toni Wilen)
- CHANGED: Tweaked the sound-code yet again, hopefully will get less out of
           sync.  (Jose Gil, myself)
- CHANGED: Add PC Drives no longer adds the floppy-drives.  If you want access
           to A:, then you'll have to add it manually in the GUI.
- CHANGED: Added ability to allocate larger amount of ZorroIII memory. 
           (Bernd#3)
- CHANGED: Added ability to allocate larger amount of RTG (Picasso96) memory.
           (Bernd#3)
- CHANGED: Removed Vertical Blank Synchronization (VSync) support in Flip
           calls.  This should increase synchronization and performance in
           full-screen mode, but may introduce some tearing/artifacting.
- CHANGED: Use the system "hand" cursor when pointing at web-links in the
           About page (if available). (Oscar Sillani)
- CHANGED: Use Tahoma font in About page of GUI.
- CHANGED: Use up/down icons in the HardDisk page of GUI. (Oscar Sillani)
______________________________________________________________________________
WinUAE 0.8.16 Release 4
==============================================================================
- FIXED: 50Hz/60Hz switching (B.C. Kid) works again. (Toni Wilen)
- FIXED: Various Picasso96 issues. (Bernd Roesch)
- FIXED: F11 should be '\' again.
- ADDED: .GZ support in floppy dialog. (Timothy Roughton, aka Inner) 
- CHANGED: Tweaked the sound-code yet again, hopefully will be less choppy.
- CHANGED: Tweaked the exception-handling code for JIT. (Bernie Meyer)
- REMOVED: icon1.ico from the source-code archive.
______________________________________________________________________________
WinUAE 0.8.16 Release 3
==============================================================================
- FIXED: GUI DLL loader is no longer fixated on Deutsch.
- FIXED: Selecting 68000 CPU from a JIT config doesn't result in error message.
- ADDED: Sprite-collisions can be enabled/disabled during emulation, not just
         at startup.
- ADDED: Patched rtg.library added to package, which should fix the mouse trails.
         (Thanks to Tobias Abt and Alexander Kneer of P96, and Bernd Roesch).
		 This file (rtg.library) will end up in the "Amiga Programs/" directory
		 under the "WinUAE/" directory where you install to.
- ADDED: German keymap (UAE_German)
- ADDED: uaediskchange utility
- ADDED: French and German DLLs updated, Italian DLL added.  (Thanks Georg V,
         FagEmul, and Daniele G)
- CHANGED: Tweaked the sound code again, memory-leak should be gone, performance
           should be better - expect a speed decrease when using JIT and sound.
- CHANGED: Graphics glitches caused by NOVSYNC flipping should be gone in full-
           screen mode.
- REMOVED: Turkish DLL, as it was out-of-date
______________________________________________________________________________
WinUAE 0.8.16 Release 2
==============================================================================
- FIXED: Stupid shift-key issue (me)
- FIXED: Should be back to 50Hz at A500 speed emulation, so audio latency should
         be reduced or non-existant. (me)
- FIXED: Graphics-updates may work now on Voodoo cards (Toni, me)
- FIXED: Updated file-version info in WinUAE.exe resource. (Georg)
- FIXED: Bug with version-number checking and GUI DLLs (Georg)
______________________________________________________________________________
WinUAE 0.8.16 Release 1
==============================================================================
- FIXED: Better 040 compatibility (Toni, Bernd#3, Gwenole)
- FIXED: Even more 040 and debugger compatibility (Toni, Bernd#3, Gwenole)
- FIXED: Fixed the cleanup_sound() routine to not crash on some systems (Andreas)
- FIXED: AGA support (Toni)
- FIXED: Don't die on CPUs (Cyrix) which don't have rdtsc instruction
- FIXED: Printing from within FinalWriter (Bernd#3)
- FIXED: Graphics printing should work now. (Bernd#3)
- FIXED: Translated GUI libraries are only loaded if their version number is
         0.8.16.1 now, so that the GUI is consistent across languages for a
         given WinUAE version.
- FIXED: Horizontal/vertical lines are 2x faster in Picasso96 (Bernd#3)
- FIXED: Floppy disk emulation tweaks (Toni Wilen)
- FIXED: Auto-activation of WinUAE window is smarter now.
- FIXED: Bug with flipping surfaces in DirectDraw.  If the flipping-pair was
         not properly created (say the primary was in video-ram, but the
         secondary was in system-ram) and cannot be flipped, we tried to
         flip anyways.  This would fill up the log with flip-failure reports.
- FIXED: Infinite loops when GetBytesPerPixel fails.  Still looking into why
         GetBytesPerPixel fails in some weird circumstances.
- FIXED: "more compatible" string in CPU page of GUI is no longer too long.
- FIXED: Mouse-pointer reappears when message-boxes pop up.
- FIXED: Mouse-button state isn't kept across screen-mode changes (Bernd#3)
- FIXED: Clear the write-protect bit when copying files from read-only media.
         This fixes the icon overwrite problem when installing OS 3.5 and 3.9.
         (Bernd#3)
- FIXED: Added a hack for volume-names of "AmigaOS3.5" and "AmigaOS3.9" to be
         used even though Windows shows "AmigaOS35" and "AmigaOS39". (Bernd#3)
- FIXED: Make sure that the Windows mouse-pointer is not active on an Amiga
         screen-mode switch. (Bernd#3)
- FIXED: Fixed timing problems on SpeedStep mobile processors, due to their
         strange RDTSC implementation being variable.  Instead, use the OS
         provided QueryPerformanceCounter(), which actually works but
         has much lower resolution.
- FIXED: Framerate reporting. (Toni)
- FIXED: Maximum number of Picasso96 screen-modes is increased.
- FIXED: Screen refresh bug when minimizing/maximizing full-screen Amiga gfx.
- FIXED: Now use gzip.dll for .adz/.roz handling.
- FIXED: Floppy disks can be written/formatted again.
- FIXED: Disk-select logic for certain demos (Toni)
- FIXED: Bogus printer loading when printer is "none" in GUI.
- FIXED: Incorrect block-size reporting for HardDiskFiles (.hdf) in GUI
- FIXED: Keyboard stickiness during screen-switches, and/or F12 GUI. (Bernd#3)
- ADDED: JIT support for massive speed increase (Bernd#2)
- ADDED: "mixed stereo" setting in the Sound page of the GUI.
- ADDED: "CTRL-F11 to quit" setting in Misc page of the GUI.  ALT-F4 can then
         be used by the Amiga properly, and CTRL-F11 will quit WinUAE.
- ADDED: Virtual screens in Picasso96 (Bernd Roesch)
- ADDED: MIDI-In support (Bernd Roesch)
- CHANGED: Slightly different compile flags, resulting code may be faster (?)
- CHANGED: Moved the Immediate Blit option from Misc to Display page of GUI
- CHANGED: Use some of WinFellow's fsdb code in WinUAE.
- CHANGED: Picasso96 rendering/display engine (Larry, Curly, me)
- CHANGED: AIAB web-link in About page of GUI.
- REMOVED: 32-bit Blitter option is gone now (no longer applies)
- REMOVED: 24-bit display-mode support.
- REMOVED: Enforcer-logging option in Misc page of GUI
- REMOVED: DirectDraw6 option in Misc page of GUI (now the default)
- REMOVED: NT4 support.
______________________________________________________________________________
WinUAE 0.8.14 Release 3
==============================================================================
- FIXED: Stupid frames-per-second bug whenever the GUI has been displayed.
- FIXED: Graphics garbage at bottom of Amiga screens whenever the GUI is
         displayed and moved around (in windowed-mode).
- FIXED: Enabling "Show LEDs in full-screen" once running didn't actually work.
- FIXED: Speed of emulation is no longer "crazy" when sound is disabled.
- FIXED: Crashing with certain .uae config-files, including default.uae.
- FIXED: Minimizing WinUAE and then restoring it wasn't restoring sound.
- FIXED: Screen refresh bug when minimizing/maximizing full-screen Amiga gfx.
- FIXED: Now use gzip.dll (included) for .adz/.roz handling.
- ADDED: Can now adjust sound preferences while the emulation is running.
- ADDED: Turkish GUI DLL to installer
- CHANGED: Printing support in the GUI is now based on a printer-name, not a
           physical printer-port.  You MUST have a printer-driver on the Amiga
           side that matches your actual printer.
- REMOVED: Ability to adjust the floppy-disk speed.  This "feature" doesn't
           exist in the core UAE version, and can also cause incompatabilities.
______________________________________________________________________________
WinUAE 0.8.14 Release 3 (the Stupid release)
==============================================================================
- FIXED: Stupid bug with GUI (F12) when in full-screen mode.
- FIXED: Stupid Picasso96 slow-down in Release 2
- FIXED: Stupid Picasso96 bug with menu painting from Release 2
- ADDED: French GUI DLL to installer
______________________________________________________________________________
WinUAE 0.8.14 Release 2
==============================================================================
- FIXED: Picasso96 screen-modes weren't being drawn/updated correctly.
- FIXED: Sound-buffer slider gets disabled when no audio output is selected.
- FIXED: German GUI DLL is accurate now. (Thanks Georg)
- ADDED: Flicker-free Amiga screen updates when full-screen.  Doesn't affect
         Picasso96 screens, though.
- CHANGED: Sound output tweaked again, should be "slightly" better.
______________________________________________________________________________
WinUAE 0.8.14 Release 1
==============================================================================
- FIXED: When WinUAE is full-screen, the Message dialog-box no longer "hides"
         and locks up WinUAE.  Instead, WinUAE will automatically minimize
         itself and display the dialog-box on the Windows Desktop.
- FIXED: log-file no longer fills up with blit failure reports.
- FIXED: Some resources (critical-sections, threads) weren't being cleaned-up.
- FIXED: [Load From...] button now works properly.
- FIXED: .uae config-files with spaces in them are now supported when double-
         clicked.
- FIXED: Increased compatability (Bernd, Sam, Toni)
- FIXED: Copper emulation state machine (Sam)
- FIXED: Floppy emulation and DMA (Sam, Toni)
- FIXED: CPU+FPU emulation bugs (Sam, Christian Bauer, Toni, me)
- FIXED: Only allow a single instance of WinUAE to be running.
- FIXED: Joystick support under Win2K.
- FIXED: Scroll-Lock to pause screen-refreshes works.
- FIXED: About-page URL link handling.
- FIXED: File-system code, including preservation of mode-bits on a rename
         (Brian Gontowski, David Varley, me)
- FIXED: File-system code can handle more than 500-files per directory now.
- ADDED: File-system now supports and persists file-notes (comments), and
         the Script, Pure, and Delete bits.
- ADDED: Floppy disk DMA slider for control of disk DMA speed (Toni)
- ADDED: Ability to disable specific floppy disk drives (Bernd)
- ADDED: "Custom" floppy creation, for use in game-saves (Toni)
- ADDED: DirectInput support for USB and other joystick devices.
- ADDED: Sound interpolation support code (Bernd), and relevent GUI changes.
- ADDED: [Info] section on Configurations page of GUI, for linking external
         text, html, or screen-shots to a particular configuration.
- ADDED: German localization of the GUI. (Georg Veichtlbauer)
- ADDED: "Back To The Roots" link in About page of GUI. (Bobic)
- CHANGED: All audio goes through WaveOut octal-buffering now.
- CHANGED: Hard-disk to local filesystem translation-layer.  MAY BE BUGGY NOW!
- CHANGED: Native CD-ROM drives are mounted as CDx: instead of DHx:
- CHANGED: Frames-per-second are only displayed in Amiga screen-modes now.
- CHANGED: Blitter, copper, and floppy emulation (from Bernd, Sam and Toni)
------------------------------------------------------------------------------

For general information about the core UAE platform, refer to:

http://www.freiburg.linux.de/~uae/

This readme file does _not_ cover the features of UAE that are common to
all versions. If you're not familiar with UAE yet, consulting the generic
distribution before attempting to use this port might actually not be a
bad idea.

The generic UAE documentation can be found in the docs directory of this
archive. Take these docs with a grain of salt, though: Not every detail of the
Linux documentation pertains to WinUAE, and vice versa.

The latest release of UAE for Win32 is available from:
http://www.winuae.net/

Also, excellent English *and* German help-files in Compiled HTML Manual (.chm)
format can be found at http://www.winuae.net/download.htm.  Many thanks
to Georg Viechtlbauer for his help with this!

If you are using Windows 95 (shame on you!) and don't have DirectX
installed yet, you need to grab and install a copy first. UAE works
with older versions of DirectX, so chances are that you won't have
any problems if you had installed a DirectX game on your machine at
least once.

There are no problems running WinUAE under Windows 2000 and XP - in fact,
Win2K or XP is the best platform to run WinUAE on - providing the best
graphics and network performance, as well as core emulation duties.

Windows NT 4.0 is not supported

| BUG REPORTS VIA EMAIL: Please make sure that the following conditions are
| met before you report any kind of problem:
|
| (1) You are using the latest version of WinUAE
| (2) You have read the documentation (90% of all potential questions are
|     answered thoroughly in the this readme file)
| (3) You have used your brain
| (4) The graphics drivers of your systems are up-to-date 
|
| If you do write me, _always_ state what version of UAE your feedback is
| pertaining to. Include all the necessary information, e.g. the command
| line options you are using.
|
| Do _not_ send me warez of any kind, no matter how non-working they are.
| Do _NOT_ ask me for ROM-files, warez, etc.

1. Command Line Parameters
==========================
UAE's command line options are now quite hidden, since we're a true
Windows application now (and not a console-application).

The most important one is:
  -config=configfile.uae
or this will also work:
  -f configfile.uae

which will cause WinUAE to load the saved config-file (which is just
ASCII format anyways).

2. File-System Specifics
========================
UAE will try its best to bridge the gap between Microsoft and Tripos file
system semantics, but there are some inherent limitations:

1. The Windows "read only" flag controls the w and d bits on the Amiga side
2. r and e are always set
3. h, s and p cannot be set
4. The a flag is preserved
5. File comments are not supported
6. Not all file names that are "forbidden" under the lame Windows fs are
   being handled correctly yet. The most common ones, however, are.

Beware: UAE does _not_ live in a chroot-like environment! There is no
checking for accesses to directories above the mount point. Do not
assume that your data is absolutely safe from rogue Amiga programs!

3. Keyboard Emulation
=====================
Most of your keyboard retains its regular functionality under UAE, but
there are a few notable exceptions:

- if you don't have a Win95 keyboard, you'll have to use Ins/Home as a
  replacement for Left Amiga/Right Amiga (this is different from other
  versions of UAE).
- HELP has been remapped to Page-Down
- F12 brings up the GUI
- Shift+F12 brings up the GUI-based debugger
- Scroll Lock toggles screen refresh, speeding up the emulation
- Pause toggles sound, speeding up the emulation (note that you can't
  enable sound this way if you haven't configured UAE to run with sound
  from the beginning).
- End+F1, F2, F3 or F4 allows you to change disks in one of the four
  Amiga disk drives. Shift+End+F1...F4 ejects the disk.

The keyboard replacements for an Amiga joystick are as follows:

                 a              b            c
Up            Keypad 8      Cursor Up        T
Down          Keypad 2     Cursor Down       B
Left          Keypad 4     Cursor Left       F
Right         Keypad 6     Cursor Right      H
Fire          Keypad 0      Right Ctrl    Left Alt

WinUAE supports gzip-compressed disk images if you have zlib.dll.

Windows 2000/XP users: Using the compression feature of NTFS instead
of gzip is a good idea if you wish to save space and be able to write
to the ADF files at the same time.

3. Performance Issues
=====================
On a sufficiently powerful PC, UAE will give you quite an authentic
flashback into a (better?) past.

Thanks to DirectX, the raw drawing throughput of this version will be
among the highest of all Intel ports. 800x600 is only about 20% slower
than 320x200 on my Pentium 100, although it requires more than seven
times as many bytes per second to be pumped across the PCI bus. UAE's
native display depth is 16 bpp. This table shows how the net drawing
speed is affected by your display type:

16 bpp full screen - 100%
16 bpp desktop     -  98% 
24 bpp desktop     -  72%
32 bpp desktop     -  60%

Sound is a luxury. Because sound output is strictly synchronized with
video DMA, you _won't_ get clean sound _unless_ your machine is capable
of running at 50 fps at least internally.

Rule of thumb: Get a PPro or Pentium II if you want full graphics and
full sound at the same time (reportedly, the Pentium MMX 200 MHz,
overclocked to 250 MHz [83.3 MHz bus speed], is a powerful platform
for running UAE. I have no definite reports about the K6 and the M2 yet,
but these should do pretty good as well.).

On a Pentium 100 equipped with a Matrox Millennium, UAE-Win32/DirectX
is slightly faster than the Linux version under AcceleratedX for programs
that perform a _lot_ of screen updates, i.e. action games and demos.
All other things should run at roughly the same speed.

4. Compatibility
================
The number of programs that don't run properly under UAE decreases with
every new release. If you find a piece of software to require special
treatment, please let me know. I have received copies of pirated software
in my email in the past. Never ever do this to me.

Consult compatibility.txt for tips on how to get software running and a
growing collection of user-submitted parameters.

A few broken programs require instruction prefetch and/or exception 3
to be emulated (e.g.  Shadow of the Beast I, Katakis and Denaris). These
can be forced to run by playing with the "compatible-mode" CPU-flag in
the CPU-settings section of the GUI.

5. Acknowledgements
===================
to Bernd Schmidt for creating this comprehensive emulation of the most
complex home computer ever

to Mathias Ortmann, for all his pioneering WinUAE efforts, and the meat of this
document

to Microsoft for contributing an excellent IDE and an operating system that
hasn't crashed a single time during the development of this project,
although I've done some pretty nonstandard things to it repeatedly :->

to the Free Software Foundation for providing an invaluable set of tools

to Cygnus Software for porting them over to the Win32 environment

to Thomas Kessler for mercilessly tracking down and reporting even the
most subtle bug

to Andreas Schildbach for providing several hundred MIPS of raw CPU power and
demonstrating that this program will actually make sense on the entry-level
PC generation of 1998. :-)

to Cloanto for their Amiga Forever work

to JayBee for his AIAB work

to Christian Buchner (flower-power) for his work on a uaescsi.device

to all the mirror-sites and their owners

to those who have contributed to my Internet funding


6. Known Bugs/Issues:
=====================
Please see the WinUAE home-page at http://www.winuae.net/

Please use the following type of template with all bug reports:
1. Amiga OS versions (kickstart and workbench)
2. Extensions running (MagicWB, NewIcons, DirOPUS, ToolManager, etc.)
3. Settings of Amiga that caused the problem
4. HostOS (Win95, Win95-OSR2, Win2K, etc.)
5. DirectX version
6. PC Graphics card and its driver's version
7. Sound card and its driver's version
