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