--- hatari/python-ui/README	2019/04/09 08:46:58	1.1.1.1
+++ hatari/python-ui/README	2019/04/09 08:52:28	1.1.1.7
@@ -6,13 +6,14 @@ 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.
 
 The main points of this new UI over the Hatari internal one are its
-configurability and providing a GUI for the (console based) debugger
-included with the Hatari emulator.
+configurability, more usable file selector, internationalization
+support and providing a GUI for the (console based) debugger included
+with the Hatari emulator.
 
 Note: this is an additional UI, the built-in Hatari SDL UI isn't being
 replaced or going anywhere!
@@ -22,52 +23,56 @@ 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 may work
+with the Hatari Windows version, as long as it is built with socket
+support.
 
 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).
+
+Here are instructions on installing the dependencies for non-Linux
+platforms (neither tested nor supported as I don't use/have them):
+	http://pygtk.org/downloads.html
 
 
 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
 shortcuts couldn't be used with Hatari.
 
 
-URL: http://koti.mbnet.fi/tammat/hatari/hatari-ui.shtml
+A www-page with more information about Hatari UI is here:
+	http://koti.mbnet.fi/tammat/hatari/hatari-ui.shtml