1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
5 | %general-entities;
|
---|
6 |
|
---|
7 | <!ENTITY qt4-major "4.8">
|
---|
8 | <!ENTITY wk-major "2.3">
|
---|
9 | <!ENTITY wk-version "2.3.4">
|
---|
10 | <!ENTITY qt4-url "http://download.qt-project.org/official_releases/qt/&qt4-major;">
|
---|
11 | <!ENTITY webkit-url "http://download.kde.org/stable/qtwebkit-&wk-major;">
|
---|
12 |
|
---|
13 | <!ENTITY qt4-download-http "&qt4-url;/&qt4-version;/qt-everywhere-opensource-src-&qt4-version;.tar.gz">
|
---|
14 | <!ENTITY qt4-download-ftp " ">
|
---|
15 | <!ENTITY qt4-md5sum "d990ee66bf7ab0c785589776f35ba6ad">
|
---|
16 | <!ENTITY qt4-size "230 MB">
|
---|
17 | <!ENTITY qt4-buildsize "2.3 GB">
|
---|
18 | <!ENTITY qt4-time "12 SBU, using parallelism=4">
|
---|
19 | <!--
|
---|
20 | <!ENTITY qtwebkit-download "&webkit-url;/&wk-version;/src/qtwebkit-&wk-version;.tar.gz">
|
---|
21 | <!ENTITY qtwebkit-md5sum "42ef76d0cf7d0c611ef83418e9f297ff">
|
---|
22 | <!ENTITY qtwebkit-size "50 MB">-->
|
---|
23 | ]>
|
---|
24 |
|
---|
25 | <sect1 id="qt4" xreflabel="Qt-&qt4-version;">
|
---|
26 | <?dbhtml filename="qt4.html" ?>
|
---|
27 |
|
---|
28 |
|
---|
29 | <title>Qt-&qt4-version;</title>
|
---|
30 |
|
---|
31 | <indexterm zone="qt4">
|
---|
32 | <primary sortas="a-Qt">Qt</primary>
|
---|
33 | </indexterm>
|
---|
34 |
|
---|
35 | <sect2 role="package">
|
---|
36 | <title>Introduction to Qt4</title>
|
---|
37 |
|
---|
38 | <para>
|
---|
39 | <application>Qt4</application> is a cross-platform application framework
|
---|
40 | that is widely used for developing application software with a graphical
|
---|
41 | user interface (GUI) (in which cases Qt4 is classified as a widget
|
---|
42 | toolkit), and also used for developing non-GUI programs such as
|
---|
43 | command-line tools and consoles for servers. One of the major users of
|
---|
44 | <application>Qt</application> is <application>KDE4</application>.
|
---|
45 | </para>
|
---|
46 |
|
---|
47 | &lfs79_checked;
|
---|
48 |
|
---|
49 | <bridgehead renderas="sect3">Package Information</bridgehead>
|
---|
50 | <itemizedlist spacing="compact">
|
---|
51 | <listitem>
|
---|
52 | <para>
|
---|
53 | Download (HTTP): <ulink url="&qt4-download-http;"/>
|
---|
54 | </para>
|
---|
55 | </listitem>
|
---|
56 | <listitem>
|
---|
57 | <para>
|
---|
58 | Download (FTP): <ulink url="&qt4-download-ftp;"/>
|
---|
59 | </para>
|
---|
60 | </listitem>
|
---|
61 | <listitem>
|
---|
62 | <para>
|
---|
63 | Download MD5 sum: &qt4-md5sum;
|
---|
64 | </para>
|
---|
65 | </listitem>
|
---|
66 | <listitem>
|
---|
67 | <para>
|
---|
68 | Download size: &qt4-size;
|
---|
69 | </para>
|
---|
70 | </listitem>
|
---|
71 | <listitem>
|
---|
72 | <para>
|
---|
73 | Estimated disk space required: &qt4-buildsize;
|
---|
74 | </para>
|
---|
75 | </listitem>
|
---|
76 | <listitem>
|
---|
77 | <para>
|
---|
78 | Estimated build time: &qt4-time;
|
---|
79 | </para>
|
---|
80 | </listitem>
|
---|
81 | </itemizedlist>
|
---|
82 | <!--
|
---|
83 | <bridgehead renderas="sect3">Additional Downloads</bridgehead>
|
---|
84 | <itemizedlist spacing="compact">
|
---|
85 | <listitem>
|
---|
86 | <para>
|
---|
87 | Recommended package: <ulink url="&qtwebkit-download;"/>
|
---|
88 | </para>
|
---|
89 | </listitem>
|
---|
90 | <listitem>
|
---|
91 | <para>
|
---|
92 | Download MD5 sum: &qtwebkit-md5sum;
|
---|
93 | </para>
|
---|
94 | </listitem>
|
---|
95 | <listitem>
|
---|
96 | <para>
|
---|
97 | Download size: &qtwebkit-size;
|
---|
98 | </para>
|
---|
99 | </listitem>
|
---|
100 | <listitem>
|
---|
101 | <para>
|
---|
102 | Recommended patch:
|
---|
103 | <ulink url="&patch-root;/qtwebkit-&wk-version;-gcc5-1.patch"/>
|
---|
104 | </para>
|
---|
105 | </listitem>
|
---|
106 | </itemizedlist>
|
---|
107 | -->
|
---|
108 | <bridgehead renderas="sect3">Qt Dependencies</bridgehead>
|
---|
109 |
|
---|
110 | <bridgehead renderas="sect4">Required</bridgehead>
|
---|
111 | <para role="required">
|
---|
112 | <xref linkend="xorg7-lib"/>
|
---|
113 | </para>
|
---|
114 |
|
---|
115 | <bridgehead renderas="sect4">Recommended</bridgehead>
|
---|
116 | <para role="recommended">
|
---|
117 | <xref linkend="alsa-lib"/>,
|
---|
118 | <xref linkend="mesa"/>,
|
---|
119 | <xref linkend="cacerts"/>,
|
---|
120 | <xref linkend="dbus"/>,
|
---|
121 | <xref linkend="glib2"/>,
|
---|
122 | <xref linkend="gst10-plugins-base"/> (For QtWebKit HTML5 Video),
|
---|
123 | <xref linkend="icu"/> (unicode support),
|
---|
124 | <xref linkend="libjpeg"/>,
|
---|
125 | <xref linkend="libmng"/>,
|
---|
126 | <xref linkend="libpng"/>,
|
---|
127 | <xref linkend="libtiff"/>,
|
---|
128 | <xref linkend="ruby"/>,
|
---|
129 | <xref linkend="openssl"/>, and
|
---|
130 | <xref linkend="sqlite"/>
|
---|
131 | </para>
|
---|
132 |
|
---|
133 | <bridgehead renderas="sect4">Optional</bridgehead>
|
---|
134 | <para role="optional">
|
---|
135 | <xref linkend="cups"/>,
|
---|
136 | <xref linkend="gtk2"/> (GTK+ 2 theme support),
|
---|
137 | <xref linkend="mariadb"/> or <ulink url="http://www.mysql.com/">MySQL</ulink>,
|
---|
138 | <xref linkend="postgresql"/>,
|
---|
139 | <xref linkend="pulseaudio"/>, and
|
---|
140 | <xref linkend="unixodbc"/>
|
---|
141 | </para>
|
---|
142 |
|
---|
143 | <para condition="html" role="usernotes">User Notes:
|
---|
144 | <ulink url="&blfs-wiki;/qt4"/>
|
---|
145 | </para>
|
---|
146 | </sect2>
|
---|
147 |
|
---|
148 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
149 | href="../../xincludes/qt-alternatives.xml"/>
|
---|
150 |
|
---|
151 | <sect2 role="qt4-prefix">
|
---|
152 | <title>Setting the installation prefix</title>
|
---|
153 |
|
---|
154 | <bridgehead renderas="sect3">Installing in /opt/qt4</bridgehead>
|
---|
155 |
|
---|
156 | <para>
|
---|
157 | The BLFS editors recommend installing <application>Qt4</application> in a
|
---|
158 | directory other than <filename class="directory">/usr</filename>, ie
|
---|
159 | <filename class="directory">/opt/qt4</filename>. To do this, set the
|
---|
160 | following environment variable:
|
---|
161 | </para>
|
---|
162 |
|
---|
163 | <screen><userinput>export QT4PREFIX=/opt/qt4</userinput></screen>
|
---|
164 |
|
---|
165 | <tip>
|
---|
166 | <para>
|
---|
167 | Sometimes, the installation paths are hardcoded into installed files.
|
---|
168 | This is the reason why <filename class="directory">/opt/qt4</filename>
|
---|
169 | is used as installation prefix instead of <filename
|
---|
170 | class="directory">/opt/qt-&qt4-version;</filename>. To create a
|
---|
171 | versioned <application>Qt4</application> directory, you may rename
|
---|
172 | the directory and create a symlink:
|
---|
173 | </para>
|
---|
174 |
|
---|
175 | <screen role="root"><userinput>mkdir -pv /opt/qt-&qt4-version;
|
---|
176 | ln -sfnv qt-&qt4-version; /opt/qt4</userinput></screen>
|
---|
177 |
|
---|
178 | <para>
|
---|
179 | Later on, you may want to install other versions of
|
---|
180 | <application>Qt4</application>. To do that, just remove the symlink
|
---|
181 | and use <filename class="directory">/opt/qt4</filename> as the
|
---|
182 | prefix again. Which version of <application>Qt4</application> you
|
---|
183 | use depends only on where the symlink points.
|
---|
184 | </para>
|
---|
185 | </tip>
|
---|
186 |
|
---|
187 | </sect2>
|
---|
188 |
|
---|
189 | <sect2 role="installation">
|
---|
190 | <title>Installation of Qt4</title>
|
---|
191 |
|
---|
192 | <warning>
|
---|
193 | <para>
|
---|
194 | If <application>Qt4</application> is being reinstalled into the
|
---|
195 | same directory as an existing instance, run the commands done by
|
---|
196 | <systemitem class="username">root</systemitem>, such as
|
---|
197 | <command>make install</command>, from a console or non-Qt4 based
|
---|
198 | window manager. It overwrites <application>Qt4</application>
|
---|
199 | libraries that should not be in use during the install process.
|
---|
200 | </para>
|
---|
201 | </warning>
|
---|
202 |
|
---|
203 | <caution>
|
---|
204 | <para>
|
---|
205 | If you did not install some of the recommended dependencies, examine
|
---|
206 | <command>./configure --help</command> output to check how to disable
|
---|
207 | them or use internal versions bundled in the source tarball.
|
---|
208 | </para>
|
---|
209 | </caution>
|
---|
210 |
|
---|
211 | <note>
|
---|
212 | <para>
|
---|
213 | The build time and space required for the full
|
---|
214 | <application>Qt4</application> is quite long. The instructions below do
|
---|
215 | not build the tutorials and examples. Removing the
|
---|
216 | <parameter>-nomake</parameter> lines will create a complete build.
|
---|
217 | </para>
|
---|
218 | </note>
|
---|
219 |
|
---|
220 | <note>
|
---|
221 | <para>
|
---|
222 | The BLFS editors do not recommend installing <application>Qt4</application>
|
---|
223 | into the /usr hierarchy because it becomes difficult to find
|
---|
224 | components and to update to a new version. If you do want to install
|
---|
225 | <application>Qt4</application> in /usr, the directories need to
|
---|
226 | be specified explicitly. In this case, set QT4PREFIX=/usr and add
|
---|
227 | the following to the configure arguments below:
|
---|
228 | </para>
|
---|
229 |
|
---|
230 | <screen role="nodump"><userinput>-bindir /usr/bin/qt4 \
|
---|
231 | -plugindir /usr/lib/qt4/plugins \
|
---|
232 | -importdir /usr/lib/qt4/imports \
|
---|
233 | -headerdir /usr/include/qt4 \
|
---|
234 | -datadir /usr/share/qt4 \
|
---|
235 | -docdir /usr/share/doc/qt4 \
|
---|
236 | -translationdir /usr/share/qt4/translations \
|
---|
237 | -demosdir /usr/share/doc/qt4/demos \
|
---|
238 | -examplesdir /usr/share/doc/qt4/examples \</userinput></screen>
|
---|
239 | </note>
|
---|
240 |
|
---|
241 | <para>
|
---|
242 | Install <application>Qt4</application> by running the following commands:
|
---|
243 | </para>
|
---|
244 |
|
---|
245 | <screen><userinput>./configure -prefix $QT4PREFIX \
|
---|
246 | -sysconfdir /etc/xdg \
|
---|
247 | -confirm-license \
|
---|
248 | -opensource \
|
---|
249 | -release \
|
---|
250 | -dbus-linked \
|
---|
251 | -openssl-linked \
|
---|
252 | -system-sqlite \
|
---|
253 | -no-phonon \
|
---|
254 | -no-phonon-backend \
|
---|
255 | -no-webkit \
|
---|
256 | -no-openvg \
|
---|
257 | -nomake demos \
|
---|
258 | -nomake examples \
|
---|
259 | -optimized-qmake &&
|
---|
260 | make</userinput></screen>
|
---|
261 |
|
---|
262 | <para>
|
---|
263 | This package does not come with a test suite.
|
---|
264 | </para>
|
---|
265 |
|
---|
266 | <para>
|
---|
267 | Now as the <systemitem class="username">root</systemitem> user:
|
---|
268 | </para>
|
---|
269 |
|
---|
270 | <screen role="root"><userinput>make install &&
|
---|
271 | rm -rf $QT4PREFIX/tests</userinput></screen>
|
---|
272 |
|
---|
273 | <para>
|
---|
274 | Remove references to the build directory from the installed
|
---|
275 | <filename class="extension">.pc</filename> files by running
|
---|
276 | the following command as the
|
---|
277 | <systemitem class="username">root</systemitem> user:
|
---|
278 | </para>
|
---|
279 |
|
---|
280 | <screen role="root"><userinput>find $QT4PREFIX/lib/pkgconfig -name "*.pc" -exec perl -pi -e "s, -L$PWD/?\S+,,g" {} \;</userinput></screen>
|
---|
281 |
|
---|
282 | <para>
|
---|
283 | Remove references to the build directory in the installed library
|
---|
284 | dependency (prl) files by running the following command as the
|
---|
285 | <systemitem class="username">root</systemitem> user:
|
---|
286 | </para>
|
---|
287 |
|
---|
288 | <screen role="root"><userinput>for file in $QT4PREFIX/lib/libQt*.prl; do
|
---|
289 | sed -r -e '/^QMAKE_PRL_BUILD_DIR/d' \
|
---|
290 | -e 's/(QMAKE_PRL_LIBS =).*/\1/' \
|
---|
291 | -i $file
|
---|
292 | done</userinput></screen>
|
---|
293 | <!--
|
---|
294 | <bridgehead renderas="sect3">Building Qtwebkit</bridgehead>
|
---|
295 |
|
---|
296 | <para>
|
---|
297 | The bundled version of qtwebkit in the main package requires an
|
---|
298 | obsolete version of the <application>gstreamer</application> package.
|
---|
299 | To overcome this, we use a more recent version available separately.
|
---|
300 | </para>
|
---|
301 |
|
---|
302 | <para>To start, the upstream package is unusual in that it does not come
|
---|
303 | in a directory, so we have to create one before unpacking the tarball.
|
---|
304 | After that, we need to make the package compatible with the latest version
|
---|
305 | of gcc and use an included script to actually complete the build. To do
|
---|
306 | this, run the following instructions:</para>
|
---|
307 |
|
---|
308 | <screen><userinput>mkdir qtwebkit-&wk-version; &&
|
---|
309 | pushd qtwebkit-&wk-version; &&
|
---|
310 |
|
---|
311 | tar -xf ../../qtwebkit-&wk-version;.tar.gz &&
|
---|
312 | patch -Np1 -i ../../qtwebkit-&wk-version;-gcc5-1.patch &&
|
---|
313 |
|
---|
314 | QTDIR=$QT4PREFIX PATH=$PATH:$QT4PREFIX/bin \
|
---|
315 | Tools/Scripts/build-webkit -i -qt \
|
---|
316 | - -no-webkit2 \
|
---|
317 | - -prefix=$QT4PREFIX</userinput></screen>
|
---|
318 |
|
---|
319 | <para>If desired, the build process can use parallel processors by
|
---|
320 | adding the option <option>- -makeargs=-j<number></option> to
|
---|
321 | the <command>build-webkit</command> instruction above.</para>
|
---|
322 |
|
---|
323 | <para>
|
---|
324 | To install the package, as the <systemitem class="username">root</systemitem> user:
|
---|
325 | </para>
|
---|
326 |
|
---|
327 | <screen role="root"><userinput>make -C WebKitBuild/Release install</userinput></screen>
|
---|
328 | -->
|
---|
329 | <bridgehead renderas="sect3">Installing Auxillary Files</bridgehead>
|
---|
330 |
|
---|
331 | <para>
|
---|
332 | The following instructions assume that your working directory is the top
|
---|
333 | of the <application>Qt4</application> source tree:
|
---|
334 | </para>
|
---|
335 |
|
---|
336 | <screen><userinput>popd</userinput></screen>
|
---|
337 |
|
---|
338 | <para>
|
---|
339 | Install images and create the menu entries for installed applications.
|
---|
340 | The <envar>QT4BINDIR</envar> variable is used here to point to the
|
---|
341 | directory for the executable programs. If you have changed the bindir
|
---|
342 | above, <envar>QT4BINDIR</envar> will need to be adjusted below. Be sure
|
---|
343 | that the <envar>QT4BINDIR</envar> variable is defined in root's
|
---|
344 | environment and as the <systemitem class="username">root</systemitem>
|
---|
345 | user:
|
---|
346 | </para>
|
---|
347 |
|
---|
348 | <screen role="root"><userinput>QT4BINDIR=$QT4PREFIX/bin
|
---|
349 |
|
---|
350 | install -v -Dm644 src/gui/dialogs/images/qtlogo-64.png \
|
---|
351 | /usr/share/pixmaps/qt4logo.png &&
|
---|
352 |
|
---|
353 | install -v -Dm644 tools/assistant/tools/assistant/images/assistant-128.png \
|
---|
354 | /usr/share/pixmaps/assistant-qt4.png &&
|
---|
355 |
|
---|
356 | install -v -Dm644 tools/designer/src/designer/images/designer.png \
|
---|
357 | /usr/share/pixmaps/designer-qt4.png &&
|
---|
358 |
|
---|
359 | install -v -Dm644 tools/linguist/linguist/images/icons/linguist-128-32.png \
|
---|
360 | /usr/share/pixmaps/linguist-qt4.png &&
|
---|
361 |
|
---|
362 | install -v -Dm644 tools/qdbus/qdbusviewer/images/qdbusviewer-128.png \
|
---|
363 | /usr/share/pixmaps/qdbusviewer-qt4.png &&
|
---|
364 |
|
---|
365 | install -dm755 /usr/share/applications &&
|
---|
366 |
|
---|
367 | cat > /usr/share/applications/assistant-qt4.desktop << EOF
|
---|
368 | <literal>[Desktop Entry]
|
---|
369 | Name=Qt4 Assistant
|
---|
370 | Comment=Shows Qt4 documentation and examples
|
---|
371 | Exec=$QT4BINDIR/assistant
|
---|
372 | Icon=assistant-qt4.png
|
---|
373 | Terminal=false
|
---|
374 | Encoding=UTF-8
|
---|
375 | Type=Application
|
---|
376 | Categories=Qt;Development;Documentation;</literal>
|
---|
377 | EOF
|
---|
378 |
|
---|
379 | cat > /usr/share/applications/designer-qt4.desktop << EOF
|
---|
380 | <literal>[Desktop Entry]
|
---|
381 | Name=Qt4 Designer
|
---|
382 | Comment=Design GUIs for Qt4 applications
|
---|
383 | Exec=$QT4BINDIR/designer
|
---|
384 | Icon=designer-qt4.png
|
---|
385 | MimeType=application/x-designer;
|
---|
386 | Terminal=false
|
---|
387 | Encoding=UTF-8
|
---|
388 | Type=Application
|
---|
389 | Categories=Qt;Development;</literal>
|
---|
390 | EOF
|
---|
391 |
|
---|
392 | cat > /usr/share/applications/linguist-qt4.desktop << EOF
|
---|
393 | <literal>[Desktop Entry]
|
---|
394 | Name=Qt4 Linguist
|
---|
395 | Comment=Add translations to Qt4 applications
|
---|
396 | Exec=$QT4BINDIR/linguist
|
---|
397 | Icon=linguist-qt4.png
|
---|
398 | MimeType=text/vnd.trolltech.linguist;application/x-linguist;
|
---|
399 | Terminal=false
|
---|
400 | Encoding=UTF-8
|
---|
401 | Type=Application
|
---|
402 | Categories=Qt;Development;</literal>
|
---|
403 | EOF
|
---|
404 |
|
---|
405 | cat > /usr/share/applications/qdbusviewer-qt4.desktop << EOF
|
---|
406 | <literal>[Desktop Entry]
|
---|
407 | Name=Qt4 QDbusViewer
|
---|
408 | GenericName=D-Bus Debugger
|
---|
409 | Comment=Debug D-Bus applications
|
---|
410 | Exec=$QT4BINDIR/qdbusviewer
|
---|
411 | Icon=qdbusviewer-qt4.png
|
---|
412 | Terminal=false
|
---|
413 | Encoding=UTF-8
|
---|
414 | Type=Application
|
---|
415 | Categories=Qt;Development;Debugger;</literal>
|
---|
416 | EOF
|
---|
417 |
|
---|
418 | cat > /usr/share/applications/qtconfig-qt4.desktop << EOF
|
---|
419 | <literal>[Desktop Entry]
|
---|
420 | Name=Qt4 Config
|
---|
421 | Comment=Configure Qt4 behavior, styles, fonts
|
---|
422 | Exec=$QT4BINDIR/qtconfig
|
---|
423 | Icon=qt4logo.png
|
---|
424 | Terminal=false
|
---|
425 | Encoding=UTF-8
|
---|
426 | Type=Application
|
---|
427 | Categories=Qt;Settings;</literal>
|
---|
428 | EOF</userinput></screen>
|
---|
429 |
|
---|
430 | <para>
|
---|
431 | Some packages such as <xref linkend='vlc'/> look for certain
|
---|
432 | executables with a -qt4 suffix. Run the following command as the
|
---|
433 | <systemitem class="username">root</systemitem> user
|
---|
434 | to create the necessary symlinks:
|
---|
435 | </para>
|
---|
436 |
|
---|
437 | <screen role="root"><userinput>for file in moc uic rcc qmake lconvert lrelease lupdate; do
|
---|
438 | ln -sfrvn $QT4BINDIR/$file /usr/bin/$file-qt4
|
---|
439 | done</userinput></screen>
|
---|
440 |
|
---|
441 | </sect2>
|
---|
442 |
|
---|
443 | <sect2 role="commands">
|
---|
444 | <title>Command Explanations</title>
|
---|
445 |
|
---|
446 | <para>
|
---|
447 | <parameter>-confirm-license</parameter>: Accept license
|
---|
448 | without prompting user during configuration.
|
---|
449 | </para>
|
---|
450 |
|
---|
451 | <para>
|
---|
452 | <parameter>-opensource</parameter>: Install the opensource
|
---|
453 | version of <application>Qt</application>.
|
---|
454 | </para>
|
---|
455 |
|
---|
456 | <para>
|
---|
457 | <parameter>-release</parameter>: This switch disables
|
---|
458 | building with debugging symbols.
|
---|
459 | </para>
|
---|
460 |
|
---|
461 | <para>
|
---|
462 | <parameter>-nomake examples -nomake demos</parameter>:
|
---|
463 | These switches disable building programs that are only of
|
---|
464 | interest to a developer using <application>Qt</application>.
|
---|
465 | </para>
|
---|
466 |
|
---|
467 | <para>
|
---|
468 | <parameter>-system-sqlite</parameter>: This switch enables use
|
---|
469 | the system version of <application>SQLite</application>.
|
---|
470 | </para>
|
---|
471 |
|
---|
472 | <para>
|
---|
473 | <parameter>-no-nis</parameter>: This switch disables support
|
---|
474 | for Network Information Service (NIS) which has been
|
---|
475 | deprecated in recent versions of <application>Glibc</application>.
|
---|
476 | </para>
|
---|
477 |
|
---|
478 | <para>
|
---|
479 | <parameter>-no-phonon -no-phonon-backend</parameter>: These
|
---|
480 | switches disable building of the bundled
|
---|
481 | <application>Phonon</application> library. Better version
|
---|
482 | is provided by <xref linkend="phonon"/> package.
|
---|
483 | </para>
|
---|
484 |
|
---|
485 | <para>
|
---|
486 | <parameter>-dbus-linked -openssl-linked</parameter>: These
|
---|
487 | switches enable explicit linking of the
|
---|
488 | <application>D-Bus</application> and
|
---|
489 | <application>OpenSSL</application> libraries into
|
---|
490 | <application>Qt</application> libraries instead of
|
---|
491 | <command>dlopen()</command>-ing them.
|
---|
492 | </para>
|
---|
493 |
|
---|
494 | <para>
|
---|
495 | <parameter>-no-openvg</parameter>: This switch disables
|
---|
496 | <application>OpenVG</application> support in
|
---|
497 | <application>Qt</application>.
|
---|
498 | </para>
|
---|
499 |
|
---|
500 | <para>
|
---|
501 | <parameter>-optimized-qmake</parameter>: This switch enables
|
---|
502 | building of the optimized <command>qmake</command> program.
|
---|
503 | </para>
|
---|
504 |
|
---|
505 | <para>
|
---|
506 | <option>-no-dbus</option>: Use this switch if you don't have
|
---|
507 | <application>D-Bus</application> installed.
|
---|
508 | </para>
|
---|
509 |
|
---|
510 | </sect2>
|
---|
511 |
|
---|
512 | <sect2 role="configuration">
|
---|
513 | <title>Configuring Qt</title>
|
---|
514 |
|
---|
515 | <sect3 id="qt4-config">
|
---|
516 | <title>Configuration Information</title>
|
---|
517 |
|
---|
518 | <para>
|
---|
519 | If you installed <application>Qt</application> in /usr,
|
---|
520 | create an environment variable needed by certain packages.
|
---|
521 | As the <systemitem class="username">root</systemitem> user:
|
---|
522 | </para>
|
---|
523 |
|
---|
524 | <screen role="root"><userinput>cat > /etc/profile.d/qt4.sh << "EOF"
|
---|
525 | <literal># Begin /etc/profile.d/qt4.sh
|
---|
526 |
|
---|
527 | QT4DIR=/usr
|
---|
528 | QTDIR=$QT4DIR
|
---|
529 | export QT4DIR QTDIR
|
---|
530 |
|
---|
531 | pathappend $$QT4DIR/qt/bin
|
---|
532 |
|
---|
533 | # End /etc/profile.d/qt4.sh</literal>
|
---|
534 | EOF</userinput></screen>
|
---|
535 |
|
---|
536 | <para>
|
---|
537 | If you installed <application>Qt4</application> in a location other
|
---|
538 | than /usr, you need to update the following configuration files so
|
---|
539 | that <application>Qt</application> is correctly found by other packages
|
---|
540 | and system processes.</para>
|
---|
541 |
|
---|
542 | <para>As the <systemitem class="username">root</systemitem> user, update
|
---|
543 | the <filename>/etc/ld.so.conf</filename> file and the dynamic linker's
|
---|
544 | run-time cache file:
|
---|
545 | </para>
|
---|
546 |
|
---|
547 | <note><para>If you installed <application>Qt4</application> in
|
---|
548 | /usr with the commands specified above, the PATH entries
|
---|
549 | in the scripts below need to be adjusted accordingly.</para></note>
|
---|
550 |
|
---|
551 | <screen role="root"><userinput>cat >> /etc/ld.so.conf << EOF
|
---|
552 | <literal># Begin Qt addition
|
---|
553 |
|
---|
554 | /opt/qt4/lib
|
---|
555 |
|
---|
556 | # End Qt addition</literal>
|
---|
557 | EOF
|
---|
558 |
|
---|
559 | ldconfig</userinput></screen>
|
---|
560 |
|
---|
561 | <indexterm zone="qt4 qt4-config">
|
---|
562 | <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
|
---|
563 | </indexterm>
|
---|
564 |
|
---|
565 | <para>
|
---|
566 | As the <systemitem class="username">root</systemitem> user, create
|
---|
567 | the <filename>/etc/profile.d/qt4.sh</filename> file:
|
---|
568 | </para>
|
---|
569 |
|
---|
570 | <screen role="root"><userinput>cat > /etc/profile.d/qt4.sh << "EOF"
|
---|
571 | <literal># Begin /etc/profile.d/qt4.sh
|
---|
572 |
|
---|
573 | QT4DIR=/opt/qt4
|
---|
574 | QTDIR=$QT4DIR
|
---|
575 |
|
---|
576 | pathappend $QT4DIR/bin PATH
|
---|
577 | pathappend $QT4DIR/lib/pkgconfig PKG_CONFIG_PATH
|
---|
578 |
|
---|
579 | export QT4DIR QTDIR
|
---|
580 |
|
---|
581 | # End /etc/profile.d/qt4.sh</literal>
|
---|
582 | EOF</userinput></screen>
|
---|
583 |
|
---|
584 |
|
---|
585 | </sect3>
|
---|
586 |
|
---|
587 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
588 | href="../../xincludes/setqt.xml"/>
|
---|
589 | </sect2>
|
---|
590 |
|
---|
591 | <sect2 role="content">
|
---|
592 | <title>Contents</title>
|
---|
593 |
|
---|
594 | <segmentedlist>
|
---|
595 | <segtitle>Installed Programs</segtitle>
|
---|
596 | <segtitle>Installed Libraries</segtitle>
|
---|
597 | <segtitle>Installed Directories</segtitle>
|
---|
598 |
|
---|
599 | <seglistitem>
|
---|
600 | <seg>
|
---|
601 | assistant, designer, lconvert, linguist,
|
---|
602 | lrelease, lupdate, moc, pixeltool,
|
---|
603 | qcollectiongenerator, qdbuscpp2xml, qdbus,
|
---|
604 | qdbusviewer, qdbusxml2cpp, qdoc3, qhelpconverter,
|
---|
605 | qhelpgenerator, qmake, qmlplugindump, qmlviewer,
|
---|
606 | qt3to4, qtconfig, qttracereplay, rcc, uic3,
|
---|
607 | uic, xmlpatterns, and xmlpatternsvalidator
|
---|
608 | </seg>
|
---|
609 | <seg>
|
---|
610 | libQtUiTools.a, libQt3Support.so, libQtCLucene.so, libQtCore.so,
|
---|
611 | libQtDBus.so, libQtDeclarative.so, libQtDesignerComponents.so,
|
---|
612 | libQtDesigner.so, libQtGui.so, libQtHelp.so, libQtMultimedia.so,
|
---|
613 | libQtNetwork.so, libQtOpenGL.so, libQtScript.so, libQtScriptTools.so,
|
---|
614 | libQtSql.so, libQtSvg.so, libQtTest.so, libQtWebKit.so,
|
---|
615 | libQtXmlPatterns.so, and libQtXml.so, and several plugins under
|
---|
616 | /opt/qt4/imports and /opt/qt4/plugins
|
---|
617 | </seg>
|
---|
618 | <seg>
|
---|
619 | /usr/include/qt4,
|
---|
620 | /usr/lib/qt4,
|
---|
621 | /usr/share/doc/qt4, and
|
---|
622 | /usr/share/qt4
|
---|
623 | OR
|
---|
624 | /opt/qt4 and
|
---|
625 | /opt/qt-&qt4-version;
|
---|
626 | </seg>
|
---|
627 | </seglistitem>
|
---|
628 | </segmentedlist>
|
---|
629 |
|
---|
630 | <variablelist>
|
---|
631 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
632 | <?dbfo list-presentation="list"?>
|
---|
633 | <?dbhtml list-presentation="table"?>
|
---|
634 |
|
---|
635 | <varlistentry id="assistant-qt4">
|
---|
636 | <term><command>assistant</command></term>
|
---|
637 | <listitem>
|
---|
638 | <para>
|
---|
639 | is a tool for presenting on-line documentation.
|
---|
640 | </para>
|
---|
641 | <indexterm zone="qt4 assistant-qt4">
|
---|
642 | <primary sortas="b-assistant-qt4">assistant</primary>
|
---|
643 | </indexterm>
|
---|
644 | </listitem>
|
---|
645 | </varlistentry>
|
---|
646 |
|
---|
647 | <varlistentry id="designer-qt4">
|
---|
648 | <term><command>designer</command></term>
|
---|
649 | <listitem>
|
---|
650 | <para>
|
---|
651 | is a full-fledged GUI builder. It includes
|
---|
652 | powerful features such as preview mode, automatic widget
|
---|
653 | layout, support for custom widgets, and an advanced
|
---|
654 | property editor.
|
---|
655 | </para>
|
---|
656 | <indexterm zone="qt4 designer-qt4">
|
---|
657 | <primary sortas="b-designer-qt4">designer</primary>
|
---|
658 | </indexterm>
|
---|
659 | </listitem>
|
---|
660 | </varlistentry>
|
---|
661 |
|
---|
662 | <varlistentry id="lconvert-qt4">
|
---|
663 | <term><command>lconvert</command></term>
|
---|
664 | <listitem>
|
---|
665 | <para>
|
---|
666 | is part of Qt4's Linguist tool chain. It can be used as a
|
---|
667 | standalone tool to convert and filter translation data files.
|
---|
668 | </para>
|
---|
669 | <indexterm zone="qt4 lconvert-qt4">
|
---|
670 | <primary sortas="b-lconvert-qt4">lconvert</primary>
|
---|
671 | </indexterm>
|
---|
672 | </listitem>
|
---|
673 | </varlistentry>
|
---|
674 |
|
---|
675 | <varlistentry id="linguist-qt4">
|
---|
676 | <term><command>linguist</command></term>
|
---|
677 | <listitem>
|
---|
678 | <para>
|
---|
679 | provides support for translating applications into
|
---|
680 | local languages.
|
---|
681 | </para>
|
---|
682 | <indexterm zone="qt4 linguist-qt4">
|
---|
683 | <primary sortas="b-linguist-qt4">linguist</primary>
|
---|
684 | </indexterm>
|
---|
685 | </listitem>
|
---|
686 | </varlistentry>
|
---|
687 |
|
---|
688 | <varlistentry id="lrelease-qt4">
|
---|
689 | <term><command>lrelease</command></term>
|
---|
690 | <listitem>
|
---|
691 | <para>
|
---|
692 | is a simple command line tool. It reads a Qt project
|
---|
693 | file and produces message files used by the application.
|
---|
694 | </para>
|
---|
695 | <indexterm zone="qt4 lrelease-qt4">
|
---|
696 | <primary sortas="b-lrelease-qt4">lrelease</primary>
|
---|
697 | </indexterm>
|
---|
698 | </listitem>
|
---|
699 | </varlistentry>
|
---|
700 |
|
---|
701 | <varlistentry id="lupdate-qt4">
|
---|
702 | <term><command>lupdate</command></term>
|
---|
703 | <listitem>
|
---|
704 | <para>
|
---|
705 | reads a Qt project file, finds the translatable
|
---|
706 | strings in the specified source, header and Qt Designer
|
---|
707 | interface files, and produces or updates the translation
|
---|
708 | files listed in the project file.
|
---|
709 | </para>
|
---|
710 | <indexterm zone="qt4 lupdate-qt4">
|
---|
711 | <primary sortas="b-lupdate-qt4">lupdate</primary>
|
---|
712 | </indexterm>
|
---|
713 | </listitem>
|
---|
714 | </varlistentry>
|
---|
715 |
|
---|
716 | <varlistentry id="moc-qt4">
|
---|
717 | <term><command>moc</command></term>
|
---|
718 | <listitem>
|
---|
719 | <para>
|
---|
720 | generates Qt meta object support code.
|
---|
721 | </para>
|
---|
722 | <indexterm zone="qt4 moc-qt4">
|
---|
723 | <primary sortas="b-moc-qt4">moc</primary>
|
---|
724 | </indexterm>
|
---|
725 | </listitem>
|
---|
726 | </varlistentry>
|
---|
727 |
|
---|
728 | <varlistentry id="pixeltool-qt4">
|
---|
729 | <term><command>pixeltool</command></term>
|
---|
730 | <listitem>
|
---|
731 | <para>
|
---|
732 | is a desktop magnifier and as you move your mouse around
|
---|
733 | the screen it will show the magnified contents in its window.
|
---|
734 | </para>
|
---|
735 | <indexterm zone="qt4 pixeltool-qt4">
|
---|
736 | <primary sortas="b-pixeltool-qt4">pixeltool</primary>
|
---|
737 | </indexterm>
|
---|
738 | </listitem>
|
---|
739 | </varlistentry>
|
---|
740 |
|
---|
741 | <varlistentry id="qcollectiongenerator-qt4">
|
---|
742 | <term><command>qcollectiongenerator</command></term>
|
---|
743 | <listitem>
|
---|
744 | <para>
|
---|
745 | is a tool used to create a Qt Help Collection.
|
---|
746 | </para>
|
---|
747 | <indexterm zone="qt4 qcollectiongenerator-qt4">
|
---|
748 | <primary sortas="b-qcollectiongenerator-qt4">qcollectiongenerator</primary>
|
---|
749 | </indexterm>
|
---|
750 | </listitem>
|
---|
751 | </varlistentry>
|
---|
752 |
|
---|
753 | <varlistentry id="qdbuscpp2xml-qt4">
|
---|
754 | <term><command>qdbuscpp2xml</command></term>
|
---|
755 | <listitem>
|
---|
756 | <para>
|
---|
757 | takes a C++ source file and generates a D-Bus XML definition
|
---|
758 | of the interface.
|
---|
759 | </para>
|
---|
760 | <indexterm zone="qt4 qdbuscpp2xml-qt4">
|
---|
761 | <primary sortas="b-qdbuscpp2xml-qt4">qdbuscpp2xml</primary>
|
---|
762 | </indexterm>
|
---|
763 | </listitem>
|
---|
764 | </varlistentry>
|
---|
765 |
|
---|
766 | <varlistentry id="qdbus-qt4">
|
---|
767 | <term><command>qdbus</command></term>
|
---|
768 | <listitem>
|
---|
769 | <para>
|
---|
770 | lists available services, object paths, methods, signals, and
|
---|
771 | properties of objects on a bus.
|
---|
772 | </para>
|
---|
773 | <indexterm zone="qt4 qdbus-qt4">
|
---|
774 | <primary sortas="b-qdbus-qt4">qdbus</primary>
|
---|
775 | </indexterm>
|
---|
776 | </listitem>
|
---|
777 | </varlistentry>
|
---|
778 |
|
---|
779 | <varlistentry id="qdbusviewer-qt4">
|
---|
780 | <term><command>qdbusviewer</command></term>
|
---|
781 | <listitem>
|
---|
782 | <para>
|
---|
783 | is a graphical D-Bus browser.
|
---|
784 | </para>
|
---|
785 | <indexterm zone="qt4 qdbusviewer-qt4">
|
---|
786 | <primary sortas="b-qdbusviewer-qt4">qdbusviewer</primary>
|
---|
787 | </indexterm>
|
---|
788 | </listitem>
|
---|
789 | </varlistentry>
|
---|
790 |
|
---|
791 | <varlistentry id="qdbusxml2cpp-qt4">
|
---|
792 | <term><command>qdbusxml2cpp</command></term>
|
---|
793 | <listitem>
|
---|
794 | <para>
|
---|
795 | is a tool that can be used to parse interface descriptions
|
---|
796 | and produce static code representing those interfaces,
|
---|
797 | </para>
|
---|
798 | <indexterm zone="qt4 qdbusxml2cpp-qt4">
|
---|
799 | <primary sortas="b-qdbusxml2cpp-qt4">qdbusxml2cpp</primary>
|
---|
800 | </indexterm>
|
---|
801 | </listitem>
|
---|
802 | </varlistentry>
|
---|
803 |
|
---|
804 | <varlistentry id="qdoc3-qt4">
|
---|
805 | <term><command>qdoc3</command></term>
|
---|
806 | <listitem>
|
---|
807 | <para>
|
---|
808 | is a tool used by <application>Qt</application> Developers to
|
---|
809 | generate documentation for software projects.
|
---|
810 | </para>
|
---|
811 | <indexterm zone="qt4 qdoc3-qt4">
|
---|
812 | <primary sortas="b-qdoc3-qt4">qdoc3</primary>
|
---|
813 | </indexterm>
|
---|
814 | </listitem>
|
---|
815 | </varlistentry>
|
---|
816 |
|
---|
817 | <varlistentry id="qhelpconverter-qt4">
|
---|
818 | <term><command>qhelpconverter</command></term>
|
---|
819 | <listitem>
|
---|
820 | <para>
|
---|
821 | is a tool used to convert files to <application>Qt</application>
|
---|
822 | help format.
|
---|
823 | </para>
|
---|
824 | <indexterm zone="qt4 qhelpconverter-qt4">
|
---|
825 | <primary sortas="b-qhelpconverter-qt4">qhelpconverter</primary>
|
---|
826 | </indexterm>
|
---|
827 | </listitem>
|
---|
828 | </varlistentry>
|
---|
829 |
|
---|
830 | <varlistentry id="qhelpgenerator-qt4">
|
---|
831 | <term><command>qhelpgenerator</command></term>
|
---|
832 | <listitem>
|
---|
833 | <para>
|
---|
834 | is a tool used to generate a <application>Qt</application>
|
---|
835 | compressed help file.
|
---|
836 | </para>
|
---|
837 | <indexterm zone="qt4 qhelpgenerator-qt4">
|
---|
838 | <primary sortas="b-qhelpgenerator-qt4">qhelpgenerator</primary>
|
---|
839 | </indexterm>
|
---|
840 | </listitem>
|
---|
841 | </varlistentry>
|
---|
842 |
|
---|
843 | <varlistentry id="qmake-qt4">
|
---|
844 | <term><command>qmake</command></term>
|
---|
845 | <listitem>
|
---|
846 | <para>
|
---|
847 | uses information stored in project files to
|
---|
848 | determine what should go in the makefiles it
|
---|
849 | generates.
|
---|
850 | </para>
|
---|
851 | <indexterm zone="qt4 qmake-qt4">
|
---|
852 | <primary sortas="b-qmake-qt4">qmake</primary>
|
---|
853 | </indexterm>
|
---|
854 | </listitem>
|
---|
855 | </varlistentry>
|
---|
856 |
|
---|
857 | <varlistentry id="qmlplugindump-qt4">
|
---|
858 | <term><command>qmlplugindump</command></term>
|
---|
859 | <listitem>
|
---|
860 | <para>
|
---|
861 | is a tool to create a qmltypes file.
|
---|
862 | </para>
|
---|
863 | <indexterm zone="qt4 qmlplugindump-qt4">
|
---|
864 | <primary sortas="b-qmlplugindump-qt4">qmlplugindump</primary>
|
---|
865 | </indexterm>
|
---|
866 | </listitem>
|
---|
867 | </varlistentry>
|
---|
868 |
|
---|
869 | <varlistentry id="qmlviewer-qt4">
|
---|
870 | <term><command>qmlviewer</command></term>
|
---|
871 | <listitem>
|
---|
872 | <para>
|
---|
873 | is a tool for loading QML documents that makes it easy to quickly
|
---|
874 | develop and debug QML applications.
|
---|
875 | </para>
|
---|
876 | <indexterm zone="qt4 qmlviewer-qt4">
|
---|
877 | <primary sortas="b-qmlviewer-qt4">qmlviewer</primary>
|
---|
878 | </indexterm>
|
---|
879 | </listitem>
|
---|
880 | </varlistentry>
|
---|
881 |
|
---|
882 | <varlistentry id="qt3to4-qt4">
|
---|
883 | <term><command>qt3to4</command></term>
|
---|
884 | <listitem>
|
---|
885 | <para>
|
---|
886 | qt3to4 is a tool to help update Qt3 code to Qt4.
|
---|
887 | </para>
|
---|
888 | <indexterm zone="qt4 qt3to4-qt4">
|
---|
889 | <primary sortas="b-qt3to4-qt4">qt3to4</primary>
|
---|
890 | </indexterm>
|
---|
891 | </listitem>
|
---|
892 | </varlistentry>
|
---|
893 |
|
---|
894 | <varlistentry id="qtconfig-qt4">
|
---|
895 | <term><command>qtconfig</command></term>
|
---|
896 | <listitem>
|
---|
897 | <para>
|
---|
898 | is used to customize the appearance of Qt applications.
|
---|
899 | </para>
|
---|
900 | <indexterm zone="qt4 qtconfig-qt4">
|
---|
901 | <primary sortas="b-qtconfig-qt4">qtconfig</primary>
|
---|
902 | </indexterm>
|
---|
903 | </listitem>
|
---|
904 | </varlistentry>
|
---|
905 |
|
---|
906 | <varlistentry id="qttracereplay">
|
---|
907 | <term><command>qttracereplay</command></term>
|
---|
908 | <listitem>
|
---|
909 | <para>
|
---|
910 | is a tool to replay all drawing operations recording with
|
---|
911 | <command>-graphicssystem trace</command> into a trace buffer.
|
---|
912 | </para>
|
---|
913 | <indexterm zone="qt4 qttracereplay">
|
---|
914 | <primary sortas="b-qttracereplay">qttracereplay</primary>
|
---|
915 | </indexterm>
|
---|
916 | </listitem>
|
---|
917 | </varlistentry>
|
---|
918 |
|
---|
919 | <varlistentry id="rcc-qt4">
|
---|
920 | <term><command>rcc</command></term>
|
---|
921 | <listitem>
|
---|
922 | <para>
|
---|
923 | is a resource compiler used in conjunction with designer.
|
---|
924 | </para>
|
---|
925 | <indexterm zone="qt4 rcc-qt4">
|
---|
926 | <primary sortas="b-rcc-qt4">rcc</primary>
|
---|
927 | </indexterm>
|
---|
928 | </listitem>
|
---|
929 | </varlistentry>
|
---|
930 |
|
---|
931 | <varlistentry id="uic-qt4">
|
---|
932 | <term><command>uic</command></term>
|
---|
933 | <listitem>
|
---|
934 | <para>
|
---|
935 | is a Qt user interface compiler.
|
---|
936 | </para>
|
---|
937 | <indexterm zone="qt4 uic-qt4">
|
---|
938 | <primary sortas="b-uic-qt4">uic</primary>
|
---|
939 | </indexterm>
|
---|
940 | </listitem>
|
---|
941 | </varlistentry>
|
---|
942 |
|
---|
943 | <varlistentry id="uic3-qt4">
|
---|
944 | <term><command>uic3</command></term>
|
---|
945 | <listitem>
|
---|
946 | <para>
|
---|
947 | is a tool to generate Qt4 code out of
|
---|
948 | user interface files generated by the Qt3
|
---|
949 | version of designer.
|
---|
950 | </para>
|
---|
951 | <indexterm zone="qt4 uic3-qt4">
|
---|
952 | <primary sortas="b-uic3-qt4">uic3</primary>
|
---|
953 | </indexterm>
|
---|
954 | </listitem>
|
---|
955 | </varlistentry>
|
---|
956 |
|
---|
957 | <varlistentry id="xmlpatterns-qt4">
|
---|
958 | <term><command>xmlpatterns</command></term>
|
---|
959 | <listitem>
|
---|
960 | <para>
|
---|
961 | provides support for XPath, XQuery, XSLT, and XML Schema
|
---|
962 | validation.
|
---|
963 | </para>
|
---|
964 | <indexterm zone="qt4 xmlpatterns-qt4">
|
---|
965 | <primary sortas="b-xmlpatterns-qt4">xmlpatterns</primary>
|
---|
966 | </indexterm>
|
---|
967 | </listitem>
|
---|
968 | </varlistentry>
|
---|
969 |
|
---|
970 | <varlistentry id="xmlpatternsvalidator-qt4">
|
---|
971 | <term><command>xmlpatternsvalidator</command></term>
|
---|
972 | <listitem>
|
---|
973 | <para>
|
---|
974 | is a tool used to validate XML documents.
|
---|
975 | </para>
|
---|
976 | <indexterm zone="qt4 xmlpatternsvalidator-qt4">
|
---|
977 | <primary sortas="b-xmlpatternsvalidator-qt4">xmlpatternsvalidator</primary>
|
---|
978 | </indexterm>
|
---|
979 | </listitem>
|
---|
980 | </varlistentry>
|
---|
981 |
|
---|
982 | </variablelist>
|
---|
983 |
|
---|
984 | </sect2>
|
---|
985 |
|
---|
986 | </sect1>
|
---|