Introduction
------------

WARNING !!!! :	since version 0.4, older config files are not compatible, you should remove
		it and reconfigure kruiser as you want.

Features
--------

Kruiser is a File system Win95-like Explorer for KDE.

Main features are :
	- highly configurable (icons, mime types, ...)
	- tree follower (directory tree follows you when entering subdirectories)
	- configurable tree (you can add link to any folder you want : Desktop, Trash,
		Home, ...)
	- support for mountable devices (with mount and unmount operations)
	- support for FTP
	- support for archive files (Tar, Zip and Rpm)
	- support for SMB filesystems mounting
	- does not need KFM to be running (it implements its own protocols)
	- provides a set of Win95-like icons, or use KDE icons
	- use KDE mime types or personal file association
	- many features of Win95 Explorer are implemented (to much to be
		listed here).
	- internationalisation (only in french and german at this time)
	- implement threaded operation (can be killed at any time), no subprocess,
		zombies, ...
	- implement drag'n drop (XDND).
	- multiple view : with one splitted pane, or with MDI-like subwindows
	- image preview (with threaded thumbnail creation (NEW))
	- simple history and bookmark support
	- network neighborhood support
	- libpthread (libc6) and GNU pth (libc5) support
	...

To do :
	- missing Explorer features (not much)
	- more internationalisation (need translators)
	- some minor improvements

I need FEEDBACK. If you tested it and like it (or not)
just send me a e-mail to tell me what's good or not, what should
be done or removed, or just to give me your impressions.

My adress : goffioul@emic.ucl.ac.be


Requirements
------------

	- KDE 1.1
	- Qt 1.41 (or higher)
	- gcc-2.8.1 or egcs compiler
	- libpthread (libc6 systems) or GNU pth (libc5 systems)

Kruiser is tested under glibc-based Linux and Solaris 2.5.1. It is not
tested under libc5-based systems. Some problems have been reported during
compilation and execution which shows that kruiser can't be run on such
systems.
From version 0.4, kruiser can support GNU pth which allows the use of
kruiser under libc5 systems. But it has not been extensively tested. To
enable GNU pth use for kruiser, you must compile GNU pth with '--enable-pthread'
to generate wrappers for libpthread. Then use '--enable-pth' when configuring
kruiser.



Compilation
-----------

1) libpng problem

Kruiser needs the KDE image library libkimgio. Normally this library used
libraries like libjpeg, libtiff or libpng if they are installed on your
system (they are detected during configuration). However, comments from
users shows that configuration script failed to detect libpng library on
some systems (Suse for example). If you get compilation error at linking
stage in the form of "undefined reference to png_xxx", then it means that
libpng wasn't properly detected.
To solve this, edit the file "Makefile" and "src/Makefile" and replace the
line

LIBPNG =

by

LIBPNG = -lpng

Then re-make.


Installation
------------

like usual :
	./configure
	make
	make install (as root)

2 useful flags when configuring :
	--enable-optimization : "-O2" switch
	--disable-exceptions : "-fno-exceptions -fno-rtti" switch
	--enable-kfm-minidir : enable the installation of improved KDE mini
			       icons for most common files.
	--enable-pth : enable the use of GNU pth instead of libpthread, useful
		       for libc5 systems.


Contacts
--------

Send comments and bug reports to goffioul@emic.ucl.ac.be.
