now uses a relative path for dir_where_make_will_be_called
[kdevelop:kdevelop.git] / README
1 KDevelop 1.3
2
3 -------------------------------------
4
5 1. What is KDevelop ?
6
7 KDevelop is an easy to use IDE (Intergrated Development Enviroment) for
8 Unix/X11, targeting on C/C++ application development; specialized on the Qt/KDE and GNOME libraries.
9
10 2. KDevelop-Homepage
11
12 http://www.kdevelop.org
13
14
15 3. Requirements
16
17 In order to successfully compile and use KDevelop, you need following
18 programs and libraries:         
19
20 required:
21 ------------------
22 g++ 2.8/egcs 1.0.3 (or compatible)
23 GNU make
24 perl 5.004
25 autoconf 2.12
26 automake 1.4
27 Qt 1.44 NOT Qt 2.0
28 KDE 1.1.x (kdelibs) 
29 flex
30 db (berkley database)
31
32
33 optional:
34 -----------------------
35 gdb 4.18 (do not use 4.17, I've been told it has some problems)
36 KDE-SDK
37 sgmltools 1
38 Glimpse >= 4.1 or htDig 3.1.x
39 KIconEdit
40 KDbg
41 enscript
42 Gv, Ghostview, KGhostview
43 cvs >= 1.10
44
45 Note: By default, KDevelop is configured to use kdoc 1 from the kdesdk
46 to generate documentation. If you have kdoc 2 installed on your system
47 (which takes slightly different arguments), you should configure with
48 --enable-kdoc2. On a Debian system, you should use --enable-docbase.
49
50
51 4. Installation
52
53 see INSTALL in this directory.
54 If you want to use the htDig search engine please see the
55 README.htdig file.
56
57
58 5. Import of autoconf/automake-based projects
59
60 KDevelop 1.3 contains a script "kimport", contributed by Ulrich Eckhardt
61 <doomster@knuut.de>, which writes a .kdevprj file out of the analysed
62 project's makefiles. The generated .kdevprj needs some editing before
63 it can be used to build a KDevelop project.
64 For usage information please type 'kimport --help'.
65
66
67 6. Trouble shooting (please read the FAQ for more information)
68
69 If you want to compile KDevelop yourself or want to develop for X/Qt/KDE 
70 please make sure that you have installed the following packages.
71
72 xdevel.rpm (or similar)
73 qtdevel.rpm (or similar)
74 qtcompat.rpm (SuSE)
75 qtext.rpm (SuSE)
76 kde-devel.rpm (Mandrake/Redhat)
77 kde-libs-devel.rpm (Mandrake/Redhat)
78
79 Please set the KDEDIR to the correct KDE path (SuSE /opt/kde, RedHat 6.x /usr/, Slackware /opt/kde)
80 On Red Hat 6.x please set the QTDIR variable to the Qt 1.44 dir, NOT to QT 2.0
81
82 If you want to use KDE1 and KDE2 applications at the same time please look at
83 http://www.kde.org/kde1-and-kde2.html
84
85 Have fun!
86                                                          
87 The KDevelop-Team 
88 <kdevelop-team@kdevelop.org>