--- hatari/python-ui/README	2019/04/09 08:46:58	1.1
+++ hatari/python-ui/README	2019/04/09 08:50:48	1.1.1.5
@@ -6,7 +6,7 @@ ST/STe/TT/Falcon emulator and its built-
 (optionally) embed the Hatari emulator window.
 
 Having the UI in another process allows doing it with a higher level
-language and avoiding adding GUI toolkit dependencies to Hatari
+language while avoiding adding GUI toolkit dependencies to Hatari
 itself. The UI is done with PyGtk i.e. in Python language, using the
 Gtk widget set.
 
@@ -22,48 +22,47 @@ Requirements
 ------------
 
 My guess at the required versions for the dependencies are:
-- Python >=2.4
-- PyGtk >= 2.8   (on Ubuntu PyGtk is in python-gtk2 package)
+- Python >= 2.6
+- PyGtk >= 2.12   (on Debian/Ubuntu PyGtk is in python-gtk2 package)
 
-You will need also Hatari emulator version newer than v1.0.1.
-Currently (2008-07-10) you can get it only from its CVS, like
-you got Hatari UI itself.
-
-Hatari UI has been tested only on Linux (Ubuntu v7.04) and Debian
-Etch.) I would assume it works also on other unix systems such as
-Apple OSX. It won't work on Windows (the required Windows socket
-support is missing from the Hatari emulator).
+Hatari UI is included with the Hatari sources:
+	http://hg.tuxfamily.org/mercurialroot/hatari/hatari/file/tip/python-ui
+
+Hatari UI has been tested on several Linux versions.  I would assume
+it to work also on other unix systems such as Apple OSX. It won't work
+on Windows as the required Windows socket support is missing from the
+Hatari emulator.
 
 Embedding the Hatari emulator window is currently supported only for
 systems using an X window system (from libSDL sources it would seem
 that Windows would also support window embedding, but support for that
-would need to be added both to Hatari and Hatari UI).
+would need to be added both to Hatari and Hatari UI because SDL's
+own embedding disables all keyboard events in SDL program).
 
 
 Running
 -------
 
-Hatari UI needs a Hatari configuration file to know what are
-the current Hatari version options and their default values.
-If you have never saved the options from the internal Hatari
-UI (invoked normally by F12), do it before using this
-external Hatari UI.
-
 Being a Python program, Hatari UI doesn't need to be built.
 You can just run it from where you extracted it (or checked
-it out of SF CVS) by calling its wrapper script:
+it out of TuxFamily HG repo) by calling its wrapper script:
 	/path/to/script/hatariui
 
 Or you can run just the debugger:
 	/path/to/script/debugui.py
 
-But you can also install it to system directory by using:
+But you can also install it to system along with Hatari:
 	make install
 
 
 Notes
 -----
 
+Hatari UI runs a Hatari version found on $PATH.  If you want
+to use a version of Hatari that hasn't been installed, you
+need to modify the search path, for example like this:
+	PATH=../build/src:$PATH hatariui
+
 If UI is started without the embedding option, the actions
 (in menus and toolbars) have also shortcuts.  They cannot
 be used when Hatari window is embedded because then those