Installation requirements
-------------------------

You will need to have the following software installed: (The package names may
differ for your distribution.)

* libqt4
* kdelibs4 or libkde4
* libkdegames4
* libqtopengl4 (optional; sometimes contained within libqt4)

Additionally, you need the header packages; these do usually have the same
names, followed by "-dev" or "-devel".

Installation instructions
-------------------------

Open a terminal and `cd` to the directory which contains this file. Execute the
following commands:

    mkdir build
    cd build
    cmake ..
    make
    sudo make install
    kbuildsycoca4

Trouble shooting
----------------

Problem: Palapeli starts, but no game can be loaded, and no patterns are
available in the "New puzzle" dialog.

Diagnosis: The patterns can not be located due to the behavior of your KDE
System Configuration Cache (abbreviated SyCoCa). The SyCoCa is used within KDE
to locate configuration and data files as well as (in this case) Palapeli's
patterns. In your case, the patterns have not yet been found by the SyCoCa.

Solution: As a first step, close Palapeli, and execute the following command:

    kbuildsycoca4 --noincremental

This may take some seconds as your whole SyCoCa is rebuilt. Now, start Palapeli
again and look if the problem persists. If yes, open a shell and go to the
subdirectory build in the directory containing this text file, and execute:

    sudo make install

Look in the output for lines like the following:

    -- Up-to-date: /usr/local/share/apps/palapeli/jigsaw-pics/something.svg

Everything between "Up-to-date:" and "/share/apps/" is the so-called
installation prefix used by Palapeli. In this case, it is "/usr/local". We need
to tell KSyCoCa that this directory contains system configuration. Open the file
".bashrc" in your home directory (create it if necessary) and add:

    export KDEDIRS=/usr/local:$KDEDIRS

Replace "/usr/local" with your installation prefix. After saving the .bashrc,
close and reopen your terminal and reexecute:

    kbuildsycoca4 --noincremental

Palapeli should work now. If not, try rebooting as this should flush your
environment and adapt the changes everywhere. If this does still not work,
contact the Palapeli developers for individual help.

Note for advanced users: If your not using bash (which is the default shell
nearly everywhere), you will of course have to adjust the last step. I'm quite
confident that anyone who uses another shell is experienced enough to adapt this
step to his own setup.)
