Browse Source

Update COMPILING document

Timothy Pearson 7 years ago
parent
commit
4af19d1f66
1 changed files with 4 additions and 143 deletions
  1. 4
    143
      COMPILING

+ 4
- 143
COMPILING View File

@@ -1,145 +1,6 @@
1 1
 PLEASE SEE ADDITIONAL RESOURCES AT http://www.trinitydesktop.org,
2
-including compilation instructions in the Wiki and IRC channel(s) for support!
2
+including the compilation instructions in the Wiki at
3
+http://www.trinitydesktop.org/wiki/bin/view/Developers/HowToBuild
3 4
 
4
-=========================================================================
5
-ORIGINAL TEXT
6
-MAY BE OUTDATED AS OF 07/25/2011
7
-=========================================================================
8
-
9
-THIS DOCUMENT DESCRIBES HOW YOU CAN COMPILE KDE WHEN USING SUBVERSION
10
-
11
-(If you use source tarballs, you can skip "make -f Makefile.cvs" and
12
-should use "make distclean" instead of "svn-clean")
13
-
14
-What you need
15
-=============
16
-
17
-Make sure you get the following stuff from the repository:
18
-
19
-qt-copy (This is qt-3.3.2)
20
-arts
21
-tdelibs
22
-tdebase (strongly recommended but not strictly necessary)
23
-<any other package you are interested in>
24
-
25
-It is important that you compile AND INSTALL the above packages in the 
26
-above order.
27
-
28
-Further you will need GNU make, autoconf 2.52, automake 1.5 and 
29
-a working C++ compiler (eg. gcc 2.95.2)
30
-
31
-Preparations
32
-============
33
-
34
-Before you start you must decide two things:
35
-
36
-1) Where do you want to have Qt installed? Qt is a bit lame in that it 
37
-basically installs itself in its own source-tree, but symlinks are your 
38
-friend. E.g you could link /usr/local/lib/qt3 to where you keep your Qt 
39
-source. Qt libs then end up in /usr/local/lib/qt3/lib.
40
-
41
-2) Where do you want to have KDE installed. A good candidate is /usr/local/kde
42
-
43
-Make sure you do (if using sh, ksh, or bash):
44
-export TDEDIR=/usr/local/kde
45
-
46
-With csh or tcsh the following is more appropriate:
47
-
48
-setenv TDEDIR /usr/local/kde
49
-
50
-Now you want to make sure that Qt and KDE libraries are picked up correctly.
51
-
52
-On systems that respond to environment variables something similar to the 
53
-following is appropriate:
54
-
55
-export LD_LIBRARY_PATH=$TDEDIR/lib:$QTDIR/lib
56
-
57
-On systems whose diety of choice is ldconfig, try:
58
-ldconfig -m $TDEDIR/lib
59
-ldconfig -m $QTDIR/lib
60
-
61
-You probably also want to add $TDEDIR/bin and $QTDIR/bin to your path.
62
-
63
-See http://www.kde.org/kde2-and-trinity.html for tips about setting up
64
-KDE 3.0 next to KDE 2.x.
65
-
66
-Compiling
67
-=========
68
-
69
-The magic sequence to compile & install a package is:
70
-gmake -f Makefile.cvs
71
-./configure --enable-debug
72
-gmake
73
-gmake install
74
-
75
-(On Linux, GNU make is the default make, and gmake in the above commands
76
-can be replaced with make).
77
-
78
-For Qt the magic sequence is:
79
-
80
-./configure -debug -shared -qt-gif -thread -sm -system-zlib -system-libpng -system-jpeg
81
-make
82
-
83
-Common problems
84
-===============
85
-
86
-Wrong Qt paths: 
87
-One of the biggest problems is picking up the correct version of Qt, 
88
-especially if your system has more version of Qt installed. Be aware 
89
-that information about library paths gets saved in the "config.cache" 
90
-file, "Makefile.in" as well as "Makefile" files. So it can be that after 
91
-some struggle to get QTDIR/TDEDIR setup correctly your setup is actually 
92
-correct, but old -incorrect- settings are still lying around.
93
-
94
-The best thing to do in such a case is to do a "svn-clean" (from tdesdk/scripts).
95
-This removes all files which aren't stored in the repository. You can then start all over 
96
-again with "makefile -f Makefile.cvs". Make sure you don't have any important 
97
-files lying around in your source tree any more, they will be deleted!
98
-
99
-New directories:
100
-When a new directory gets added to the repository it usually only contains a 
101
-Makefile.am but not a Makefile. If you try to compile such a directory
102
-you will get an error like:
103
-
104
-  Making all in management
105
-  make[3]: Entering directory /home/gregturp/KDE/tdelibs/tdeprint/management'
106
-  make[3]: *** No rule to make target all'.  Stop.
107
-  make[3]: Leaving directory /home/gregturp/KDE/tdelibs/tdeprint/management'
108
-  make[2]: *** [all-recursive] Error 1
109
-  make[2]: Leaving directory /home/gregturp/KDE/tdelibs/tdeprint'
110
-  make[1]: *** [all-recursive] Error 1
111
-  make[1]: Leaving directory /home/gregturp/KDE/tdelibs'
112
-  make: *** [all-recursive-am] Error 2
113
-
114
-The solution is to redo "make -f Makefile.cvs; ./configure". 
115
-
116
-You can create a single Makefile from a Makefile.am file with the
117
-tdesdk/scripts/create_makefile script. Make sure to run it from the toplevel
118
-directory. (E.g. /home/gregturp/KDE/tdelibs)
119
-
120
-Problems?
121
-=========
122
-
123
-See http://www.kde.org/compilationfaq.html for common build problems
124
-and their solution.
125
-
126
-If you encounter _LINK_ problems you are probably doing something wrong.
127
-Do a "svn-clean" and start from scratch, usually this solves the problem.
128
-
129
-If you encounter missing include files, especially if the files start with
130
-a 'q', you probably have not setup your QTDIR correct or have the wrong 
131
-version of Qt.
132
-
133
-If you encounter compile errors after updating from SVN, check whether you 
134
-need to update tdelibs as well. If the problems persists, wait a few hours,
135
-usually compile errors are fixed shortly after they have been introduced.
136
-
137
-If you still have problems read the kde-devel@kde.org mailinglist and/or
138
-post your problem there. You can subscribe by sending mail to
139
-kde-devel-request@kde.org with "subscribe" in the subject.
140
-
141
-Have fun!
142
-
143
-Cheers,
144
-Waldo Bastian
145
-bastian@kde.org
5
+The TDE developers are available on the mailing lists and IRC channel(s),
6
+so feel free to contact them for additional support!

Loading…
Cancel
Save