INSTALLING KXMAME:

To compile kxmame source, please make sure you have 
libxine, glib and pkg-config installed beside QT and KDE library.

If you downloaded kxmame from CVS, please run this first
make -f Makefile.cvs

To compile and install, run

./configure 
make
make install

	Note that kxmame enable video preview by default. This requires 
	xine library to be installed. If you don't have xine, or don't 
	need the video preview, run 

	./configure --disable-video
	make
	make install


RUNNING KXMAME:

To improve kxmame experience, you should download the file 
'catver.ini' (or 'catver') from http://catver.com or http://www.mameworld.net/catlist/
(kxmame accepts both files "catver.ini" and "catver").
This helps kxmame to categorize roms and helps with various kxmame
tweaks in game listings. If you prefer the Italian version, 
go to http://www.progettoemma.net/

The search toolbar can be shown or hide by pressing Ctrl+F.

You can specify xmame options in Menu "Settings"->"Configure Kxmame".

Kxmame doesn't provide game screenshots, flyers, cabinets photos, 
preview videos, ... You need to copy these files from somewhere else
to your local harddisk and specify their locations in 
Menu "Settings"->"Directories".


For Qt 3.3.5 user: 

	Qt 3.3.5 contains two severe bugs, one with kxmame compilation, one with kxmame runtime.
	Firstly, the vanilla version of Qt development tools generates wrong code
	which make the compilation of KDE programs fails. Therefore, unless your
	distribution provides qt 3.3.5 (which is likely to have this bug fixed),
	do not update Qt to 3.3.5.
	Secondly, qt contains a bug which crashes kxmame after browsing the game
	filter list for a while. You want to run kxmame with qt 3.3.5, please 
	patch the qt source with the included file
	qt-3.3.5-takeitem.diff and recompile qt. Or, you can choose a particular
	flat or tree view (Menu->View->"List, List Tree, Details, Details Tree") and
	do not change it later (each time you change view, please exit and restart kxmame).

	As far as I understand, both of these bugs don't exist in Qt 3.3.4 or earlier. 
	Both are fixed in Qt 3.3.6.

