Kallery 1.2.0
--------------

 Kallery is an image gallery generation application for KDE 3.x, with a wizard like interface.
It's in a quite stable state (by stability I mean that it won't crash so often. The code, the interface
and the application's features will surely change in the future), but here are some hint that may
help if you run in trouble while compiling, installing or using the application.

1. Installation notes
---------------------
 	Kallery needs ImageMagick 6.0.x in order to run.
Older versions (5.2.x, 5.3.x) will not work, and it may be that even newer
6.x releases won't be good. In this case report the ImageMagick number you are using,
and until I came up with a new version, switch back to 6.3.x. I've used 6.3.0 when I've
tested the package. Earlier or later versions might work or might not work. 
 If you wish to compile the application, you also need the devel packages of
ImageMagick.
	The ./configure script will search for the Magick-config script (part of ImageMagick),
so be sure that you have it in your path. Using the returned flags compiles two test
programs: one to find out the ImageMagick version, and another to test if all the needed
functions by Kallery are present in this version of ImageMagick.
 	It's also a good thing to run the commands in the following order:

 make -f Makefile.cvs
 rm -f config.cache
 ./configure
 make
 make install

 If you want to give me useful trouble reports, use the --enable-debug=full switch for the ./configure
script. Also it is recommended to check the Kallery homepage for newer releases before
reporting. It may be the situation, that some has already reported the bug, and I corrected
it.
 If you see ./configure errors _before_ the searching for ImageMagick flags, than there
is some problem with your environment (Qt, KDE, other system programs). It means
that the compilation of almost all other KDE programs will fail on your system. In this
case it's a good idea to search on the KDE mailing lists for similar problems, but of course
you can also ask me, I will try to help you.
 On some distribution you need "devel" packages for some other libraries in order to build
Kallery. The list of this libraries is distribution dependent (and Kallery independent).

2. Runtime notes
------------------
 	If during runtime Kallery is linked towards a different version of ImageMagick than during compilation
(version missmatch between ImageMagick header files and the ImageMagick library), than it
is possible that it will crash. You can check which shared library will be used with the
"ldd kallery" command.
 	The conversion is not always possible  between every file format. It seems that if there is some
incompability between the input and output file format, ImageMagick will not do the conversion,
so you will not see any image in your gallery. You will also get an error message in this case.
  
3. Important information
------------------------
  Kallery will crash on any system (SUSE 10.2 beta releases are an example, hopefully it
will work on 10.2 final) using an unpatched ImageMagick 6.3.0 due to some wrong interaction
between Qt, ImageMagick and fontconfig in case you select to add copyright text to the
images. Bugs were reported upstream and hopefully they will be fixed in newer releases. 
 

Contact info:
 Andras Mantia
 amantia@kdewebdev.org

PS: Check out also the Quanta Plus webpage editor at http://quanta.kdewebdev.org.
    You may like it. ;-)