--- uae/docs/README	2018/04/24 17:08:43	1.1.1.22
+++ uae/docs/README	2018/04/24 17:18:05	1.1.1.27
@@ -1,7 +1,10 @@
-This is version 0.8.22 of UAE, the UAE Amiga Emulator.
+This is version 0.8.27 of UAE-core, the UAE Amiga Emulator.
 
-Versions numbered 0.8.x are considered beta versions, but they generally
-tend to work better than the last "stable" release 0.7.
+This package used to be the master copy of UAE; it has somewhat lagged in
+development since.  It is now intended to be a stable emulator core with a
+focus on running old A500 games and demos.  Certain extra features, such as
+a JIT compiler, will not be added - other packages such as WinUAE or E-UAE
+are available which include these patches.
 
 
 License
@@ -82,8 +85,6 @@ Not emulated:
 - An MMU (part of 68030/040 CPUs except those that Commodore used). This means
   you can't use virtual memory systems or real operating systems like Linux
   or BSD.
-- The AGA chipset (A4000/A1200). This chipset has enhanced capabilites for
-  up to 256 colors in all resolutions.
 - Serial port emulation exists but doesn't work too well.
 
 Since the PC floppy controller can't read Amiga disks (yes, that's a fact), 
@@ -697,20 +698,38 @@ press ^C at any time to enter this debug
 Each debugger command consists of a single letter and occasionally some
 parameters.
 
-g:                    Start execution at the current address. 
-c:                    Dump state of the CIA and custom chips.
-r:                    Dump state of the CPU
-m <address> <lines>:  Memory dump starting at <address>
-d <address> <lines>:  Disassembly starting at <address>
-t:                    Step one instruction
-z:                    Step through one instruction - useful for JSR, DBRA etc.
-f <address>:          Step forward until PC == <address>
-q:                    Quit the emulator. You don't want to use this command.
-M:                    hunt for sound modules
-S <filename> <address> <len>:
-                      save a sound module
-C <value>:            Search for values like energy or lifes in games
-W <address> <value>:  Write into Amiga memory
+g [<address>]         Start execution at the current address or <address>
+c                     Dump state of the CIA, disk drives and custom registers
+r                     Dump state of the CPU
+m <address> [<lines>] Memory dump starting at <address>
+d <address> [<lines>] Disassembly starting at <address>
+t [instructions]      Step one or more instructions
+z                     Step through one instruction - useful for JSR, DBRA etc
+f                     Step forward until PC in RAM
+f <address>           Add/remove breakpoint
+fi                    Step forward until PC points to RTS/RTD or RTE
+fi <opcode>           Step forward until PC points to <opcode>
+fl                    List breakpoints
+fd                    Remove all breakpoints
+f <addr1> <addr2>     Step forward until <addr1> <= PC <= <addr2>
+e                     Dump contents of all custom registers
+i                     Dump contents of interrupt and trap vectors
+o <1|2|addr> [<lines>]View memory as Copper instructions
+O                     Display bitplane offsets
+O <plane> <offset>    Offset a bitplane
+H <count>             Show PC history <count> instructions
+M                     Search for *Tracker sound modules
+C <value>             Search for values like energy or lifes in games
+W <address> <value>   Write into Amiga memory
+w <num> <address> <length> <R/W/RW> [<value>]
+                      Add/remove memory watchpoints
+wd                    Enable illegal access logger
+S <file> <addr> <n>   Save a block of Amiga memory
+s <string>/<values> [<addr>] [<length>]
+                      Search for string/bytes
+T                     Show exec tasks and their PCs
+h,?                   Show this help page
+q                     Quit the emulator. You don't want to use this command.
 
 
 Sound
@@ -807,20 +826,17 @@ Authors/Maintainers
 
 My email address is (please read the section "Before you send email" below):
 
-bernds@btinternet.com
-
-(please do not put this into your Outlook addressbook; I get enough viruses
-already)
+bernds_cb1@t-online.de
 
 or, via snailmail
 
 Bernd Schmidt
-21 St Stephen's Place
-Cambridge CB3 0JE
-UK
+Toelzer Strasse 27a
+81379 Muenchen
+Germany
 
 Email is more likely to be answered, and will definitely be answered much
-faster. Please avoid phonecalls if you can.
+faster.
 I won't distribute software, neither PD or commercial. Don't send me floppy
 disks without at least asking first, you will not get them back.