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

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)


Credits:
========

- Bernd Schmidt
- Toni Wilen
- Bernd "Bernie" Meyer
- Sam Jordan
- Brian King
- Bernd Roesch
- Adil Temel
- Andreas Junghans
- Mathias Ortmann
- Istvn Fbin
- James Bagg
______________________________________________________________________________

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.
______________________________________________________________________________


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.

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.com/) to mount them.

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-cardrige,
 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-3> <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.
 - CIA dump-output slightly modified, added TOD stopped status-flag
 - 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


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.

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.

Mouse *?
--------

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


---

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
