you are reading the README of the 'KTurtle' project that is initiated
and maintained by Cies Breijs (cies-AT-showroommama-DOT-nl). In this
README I will tell you how to get KTurtle running on your computer.
You need to have KDE 3.2 or higher. I don't know if it will work with different
KDE versions since I did not test it. If it does not work please see
the Questions section below.
The simplest way to compile this package is:
1) `cd' to the directory containing the package's source code and type
`./configure --prefix=<PATH>' to configure the package for your
Make sure to replace <PATH> by the path wher your KDE apps are
installed. This is mostly '/usr', but sometimes (for SuSE) '/opt/kde'.
If you dont know what to do try: `./configure --prefix=/usr'. If you don't give a --prefix the default path /usr/local will be used, resulting that KTurtle will no be with your other apps, and may not run smoothly.
Running `configure' takes a while. While running, it prints some
messages telling which features it is checking for. If the
configure script exits with an error it will probably hint you
what it needs in order to succeed.
2) Type `make' to compile the package.
'make' also takes a while, and it also has the possibility to exit
with errors. Although the errors messages 'make' produces are mostly
not as clear as the error messages from 'configure', they are a hint
to what went wrong. Please see the Questions section below if you
dont know what to do with these messages.
If it succeeded a binary named 'kturtle' is made and can be find in the
'src' directory within the directory containing the package's source
Before you can run KTurtle you need to install it.
NOTE: you often need 'root' privilliges to do the following!
1) Type `make install' to install the programs and any data files and
2) You can remove the program binaries and object files from the
source code directory by typing `make clean'.
If you want to uninstall KTurtle you should type 'make uninstall' when
in the source code directory.
Please note that 'make install' will install KTurtle to the path that is provided to the './configure' command with the '--prefix' flag!
Under normal circumstances should be able to run KTurtle from the
commandline by typing 'kturtle'.
If it does not work please go to the source code directory of KTurtle
If this does not work please follow instuction form the Question section.
Check out the FAQ in the source code directory of KTurtle to see if your
question has allready been asked.
You can also mail questions to the mail address you find in the
beginning of this document. Or visit the KTurtle website:
http://kturlte.sf.net , or http://edu.kde.org/kturtle
and post it in the forum.
Thanks for reading!