source: x/lib/qt4.xml@ 685a5ca

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 685a5ca was 685a5ca, checked in by Igor Živković <igor@…>, 11 years ago

Qt: mention -no-dbus configure switch

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11298 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 18.4 KB
Line 
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-download-http "http://releases.qt-project.org/qt4/source/qt-everywhere-opensource-src-&qt4-version;.tar.gz">
8 <!ENTITY qt4-download-ftp " ">
9 <!ENTITY qt4-md5sum "89c5ecba180cae74c66260ac732dc5cb">
10 <!ENTITY qt4-size "226 MB">
11 <!ENTITY qt4-buildsize "1.9 GB">
12 <!ENTITY qt4-time "70 SBU">
13]>
14
15<sect1 id="qt4" xreflabel="Qt-&qt4-version;">
16 <?dbhtml filename="qt4.html" ?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Qt-&qt4-version;</title>
24
25 <indexterm zone="qt4">
26 <primary sortas="a-Qt">Qt</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Qt</title>
31
32 <para>
33 <application>Qt</application> is a cross-platform application
34 framework that is widely used for developing application software
35 with a graphical user interface (GUI) (in which cases Qt is classified
36 as a widget toolkit), and also used for developing non-GUI programs such
37 as command-line tools and consoles for servers. One of the major users
38 of <application>Qt</application> is <application>KDE</application>.
39 </para>
40
41 &lfs73_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&qt4-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&qt4-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &qt4-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &qt4-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &qt4-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &qt4-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Qt Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="mesalib"/>
82 </para>
83
84 <bridgehead renderas="sect4">Recommended</bridgehead>
85 <para role="recommended">
86 <xref linkend="cacerts"/>,
87 <xref linkend="dbus"/>,
88 <xref linkend="glib2"/>,
89 <xref linkend="icu"/> (unicode support),
90 <xref linkend="libjpeg"/>,
91 <xref linkend="libmng"/>,
92 <xref linkend="libpng"/>,
93 <xref linkend="libtiff"/>,
94 <xref linkend="openssl"/> and
95 <xref linkend="sqlite"/>
96 </para>
97
98 <bridgehead renderas="sect4">Optional</bridgehead>
99 <para role="optional">
100 <xref linkend="cups"/>,
101 <xref linkend="gtk2"/> (GTK+ 2 theme support),
102 <xref linkend="gst-plugins-base"/> (For QtWebKit HTML5 Video),
103 <xref linkend="mysql"/>,
104 <xref linkend="postgresql"/>,
105 <xref linkend="pulseaudio"/> and
106 <xref linkend="unixodbc"/>
107 </para>
108
109 <para condition="html" role="usernotes">User Notes:
110 <ulink url="&blfs-wiki;/qt4"/>
111 </para>
112 </sect2>
113
114 <sect2 role="installation">
115 <title>Installation of Qt</title>
116
117 <caution>
118 <para>
119 If <application>Qt</application> is being reinstalled, run the
120 following commands from a console or non-Qt based window manager.
121 It overwrites <application>Qt</application> libraries that should
122 not be in use during the install process.
123 </para>
124 </caution>
125
126 <note>
127 <para>
128 The build time and space required for the full
129 <application>Qt</application> is quite long. The instructions below
130 do not build the tutorials and examples. Removing the
131 <parameter>-nomake</parameter> lines will create a complete build.
132 </para>
133 </note>
134
135 <para>
136 Install <application>Qt</application> by running the
137 following commands:
138 </para>
139
140<screen><userinput>./configure -confirm-license \
141 -opensource \
142 -release \
143 -prefix /usr \
144 -bindir /usr/lib/qt4/bin \
145 -headerdir /usr/include/qt4 \
146 -datadir /usr/share/qt4 \
147 -plugindir /usr/lib/qt4/plugins \
148 -importdir /usr/lib/qt4/imports \
149 -translationdir /usr/share/qt4/translations \
150 -sysconfdir /etc/xdg \
151 -docdir /usr/share/doc/qt4 \
152 -demosdir /usr/share/doc/qt4/demos \
153 -examplesdir /usr/share/doc/qt4/examples \
154 -dbus-linked \
155 -openssl-linked \
156 -system-sqlite \
157 -plugin-sql-sqlite \
158 -no-phonon \
159 -no-phonon-backend \
160 -no-nis \
161 -no-openvg \
162 -nomake demos \
163 -nomake examples \
164 -optimized-qmake &amp;&amp;
165make</userinput></screen>
166
167 <para>
168 This package does not come with a test suite.
169 </para>
170
171 <para>
172 Now, as the <systemitem class="username">root</systemitem> user:
173 </para>
174
175<screen role="root"><userinput>make install &amp;&amp;
176rm -rf /usr/tests &amp;&amp;
177install -v -Dm644 src/gui/dialogs/images/qtlogo-64.png \
178 /usr/share/pixmaps/qt4logo.png &amp;&amp;
179install -v -Dm644 tools/assistant/tools/assistant/images/assistant-128.png \
180 /usr/share/pixmaps/assistant-qt4.png &amp;&amp;
181install -v -Dm644 tools/designer/src/designer/images/designer.png \
182 /usr/share/pixmaps/designer-qt4.png &amp;&amp;
183install -v -Dm644 tools/linguist/linguist/images/icons/linguist-128-32.png \
184 /usr/share/pixmaps/linguist-qt4.png &amp;&amp;
185install -v -Dm644 tools/qdbus/qdbusviewer/images/qdbusviewer-128.png \
186 /usr/share/pixmaps/qdbusviewer-qt4.png</userinput></screen>
187
188 <para>
189 Remove references to the build directory from installed files by
190 running the following commands as the
191 <systemitem class="username">root</systemitem> user:
192 </para>
193
194<screen role="root"><userinput>find /usr/lib/libQt*.prl -exec sed -i -e \
195 '/^QMAKE_PRL_BUILD_DIR/d;s/\(QMAKE_PRL_LIBS =\).*/\1/' {} \;
196find /usr/lib/pkgconfig/Qt*.pc -exec perl -pi -e \
197 "s, -L$(basename $PWD)/?\S+,,g" {} \;</userinput></screen>
198
199 <para>
200 Fix pkg-config files to point to the correct bindir by
201 running the following command as the
202 <systemitem class="username">root</systemitem> user:
203 </para>
204
205<screen role="root"><userinput>find /usr/lib/pkgconfig/Qt*.pc -exec sed -i -e \
206 "s@/usr/bin/@/usr/lib/qt4/bin/@g" {} \;</userinput></screen>
207
208 <para>
209 Symlink the <application>Qt</application> executables into
210 <filename class="directory">/usr/bin</filename> by running the
211 following commands as the
212 <systemitem class="username">root</systemitem> user:
213 </para>
214
215<!-- This will be handled by qtchooser -->
216<screen role="root"><userinput>for file in /usr/lib/qt4/bin/*
217do
218 ln -sfv ../lib/qt4/bin/$(basename $file) /usr/bin/$(basename $file)
219 ln -sfv ../lib/qt4/bin/$(basename $file) /usr/bin/$(basename $file)-qt4
220done</userinput></screen>
221
222 </sect2>
223
224 <sect2 role="commands">
225 <title>Command Explanations</title>
226
227 <para>
228 <parameter>-confirm-license</parameter>: Accept license
229 without prompting user during configuration.
230 </para>
231
232 <para>
233 <parameter>-opensource</parameter>: Install the opensource
234 version of <application>Qt</application>.
235 </para>
236
237 <para><parameter>-release</parameter>:
238 This switch disables building with debugging symbols.</para>
239
240 <para>
241 <parameter>-nomake examples -nomake demos</parameter>:
242 These switches disable building programs that are only of
243 interest to a <application>Qt</application> developer.
244 </para>
245
246 <para>
247 <parameter>-system-sqlite</parameter>: This switch enables use
248 the system version of <application>SQLite</application>.
249 </para>
250
251 <para>
252 <parameter>-no-nis</parameter>: This switch disables support
253 for Network Information Service (NIS) which has been
254 deprecated in recent versions of <application>Glibc</application>.
255 </para>
256
257 <para>
258 <parameter>-no-phonon -no-phonon-backend</parameter>: These
259 switches disable building of the bundled
260 <application>Phonon</application> library. Better version
261 is provided by <xref linkend="phonon"/> package.
262 </para>
263
264 <para>
265 <parameter>-dbus-linkend -openssl-linkend</parameter>: These
266 switches enable explicit linking of the
267 <application>D-Bus</application> and
268 <application>OpenSSL</application> libraries into
269 <application>Qt</application> libraries instead of
270 <command>dlopen()</command>-ing them.
271 </para>
272
273 <para>
274 <parameter>-no-openvg</parameter>: This switch disables
275 <application>OpenVG</application> support in
276 <application>Qt</application>.
277 </para>
278
279 <para>
280 <parameter>-plugin-sql-<replaceable>&lt;driver&gt;</replaceable></parameter>:
281 These switches enable SQL support in the
282 <application>Qt</application> libraries. Available drivers are:
283 ibase, mysql, psql, sqlite and odbc.
284 </para>
285
286 <para>
287 <parameter>-no-dbus</parameter>: Use this switch if you don't have
288 <application>D-Bus</application> installed.
289 </para>
290
291 </sect2>
292
293 <sect2 role="configuration">
294 <title>Configuring Qt</title>
295
296 <sect3 id="qt4-config">
297 <title>Configuration Information</title>
298
299 <para>
300 Create an environment variable needed by certain packages.
301 As the <systemitem class="username">root</systemitem> user:
302 </para>
303
304<screen role="root"><userinput>cat &gt; /etc/profile.d/qt.sh &lt;&lt; EOF
305<literal># Begin /etc/profile.d/qt.sh
306
307QTDIR=/usr
308
309export QTDIR
310
311# End /etc/profile.d/qt.sh</literal>
312EOF</userinput></screen>
313
314 <para>
315 Create the menu entries for installed applications.
316 As the <systemitem class="username">root</systemitem> user:
317 </para>
318
319<screen role="root">install -dm755 /usr/share/applications
320<userinput>cat &gt; /usr/share/applications/qtconfig-qt4.desktop &lt;&lt; "EOF"
321<literal>[Desktop Entry]
322Name=Qt4 Config
323Comment=Configure Qt4 behavior, styles, fonts
324Exec=qtconfig-qt4
325Icon=qt4logo
326Terminal=false
327Encoding=UTF-8
328Type=Application
329Categories=Qt;Settings;</literal>
330EOF
331cat &gt; /usr/share/applications/assistant-qt4.desktop &lt;&lt; "EOF"
332<literal>[Desktop Entry]
333Name=Qt4 Assistant
334Comment=Shows Qt4 documentation and examples
335Exec=assistant-qt4
336Icon=assistant-qt4
337Terminal=false
338Encoding=UTF-8
339Type=Application
340Categories=Qt;Development;Documentation;</literal>
341EOF
342cat &gt; /usr/share/applications/designer-qt4.desktop &lt;&lt; "EOF"
343<literal>[Desktop Entry]
344Name=Qt4 Designer
345Comment=Design GUIs for Qt4 applications
346Exec=designer-qt4
347Icon=designer-qt4
348MimeType=application/x-designer;
349Terminal=false
350Encoding=UTF-8
351Type=Application
352Categories=Qt;Development;</literal>
353EOF
354cat &gt; /usr/share/applications/linguist-qt4.desktop &lt;&lt; "EOF"
355<literal>[Desktop Entry]
356Name=Qt4 Linguist
357Comment=Add translations to Qt4 applications
358Exec=linguist-qt4
359Icon=linguist-qt4
360MimeType=text/vnd.trolltech.linguist;application/x-linguist;
361Terminal=false
362Encoding=UTF-8
363Type=Application
364Categories=Qt;Development;</literal>
365EOF
366cat &gt; /usr/share/applications/qdbusviewer-qt4.desktop &lt;&lt; "EOF"
367<literal>[Desktop Entry]
368Name=Qt4 QDbusViewer
369GenericName=D-Bus Debugger
370Comment=Debug D-Bus applications
371Exec=qdbusviewer-qt4
372Icon=qdbusviewer-qt4
373Terminal=false
374Encoding=UTF-8
375Type=Application
376Categories=Qt;Development;Debugger;</literal>
377EOF</userinput></screen>
378
379 </sect3>
380
381 </sect2>
382
383 <sect2 role="content">
384 <title>Contents</title>
385
386 <segmentedlist>
387 <segtitle>Installed Programs</segtitle>
388 <segtitle>Installed Libraries</segtitle>
389 <segtitle>Installed Directories</segtitle>
390
391 <seglistitem>
392 <seg>
393 assistant, designer, lconvert, linguist, lrelease, lupdate,
394 moc, pixeltool, qcollectiongenerator, qdbus, qdbuscpp2xml,
395 qdbusviewer, qdbusxml2cpp, qdoc3, qhelpconverter, qhelpgenerator,
396 qmake, qmlplugindump, qmlviewer, qt3to4, qtconfig, qttracereplay,
397 rcc, uic, uic3, xmlpatterns and xmlpatternsvalidator
398 </seg>
399 <seg>
400 libQt3Support.so, libQtCLucene.so, libQtCore.so, libQtDBus.so,
401 libQtDeclarative.so, libQtDesignerComponents.so, libQtDesigner.so,
402 libQtGui.so, libQtHelp.so, libQtMultimedia.so, libQtNetwork.so,
403 libQtOpenGL.so, libQtScript.so, libQtScriptTools.so, libQtSql.so,
404 libQtSvg.so, libQtTest.so, libQtWebKit.so, libQtXmlPatterns.so and
405 libQtXml.so
406 </seg>
407 <seg>
408 /usr/include/qt4,
409 /usr/lib/qt4,
410 /usr/share/qt4 and
411 /usr/share/doc/qt4
412 </seg>
413 </seglistitem>
414 </segmentedlist>
415
416 <variablelist>
417 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
418 <?dbfo list-presentation="list"?>
419 <?dbhtml list-presentation="table"?>
420
421 <varlistentry id="qt-assistant">
422 <term><command>assistant</command></term>
423 <listitem>
424 <para>
425 is a tool for presenting on-line documentation.
426 </para>
427 <indexterm zone="qt4 qt-assistant">
428 <primary sortas="b-assistant">assistant</primary>
429 </indexterm>
430 </listitem>
431 </varlistentry>
432
433 <varlistentry id="qt-designer">
434 <term><command>designer</command></term>
435 <listitem>
436 <para>
437 is a full-fledged GUI builder. It includes
438 powerful features such as preview mode, automatic widget
439 layout, support for custom widgets, and an advanced
440 property editor.
441 </para>
442 <indexterm zone="qt4 qt-designer">
443 <primary sortas="b-designer">designer</primary>
444 </indexterm>
445 </listitem>
446 </varlistentry>
447
448 <varlistentry id="qt-linguist">
449 <term><command>linguist</command></term>
450 <listitem>
451 <para>
452 provides support for translating applications into
453 local languages.
454 </para>
455 <indexterm zone="qt4 qt-linguist">
456 <primary sortas="b-linguist">linguist</primary>
457 </indexterm>
458 </listitem>
459 </varlistentry>
460
461 <varlistentry id="qt-lrelease">
462 <term><command>lrelease</command></term>
463 <listitem>
464 <para>
465 is a simple command line tool. It reads a Qt project
466 file and produces message files used by the application.
467 </para>
468 <indexterm zone="qt4 qt-lrelease">
469 <primary sortas="b-lrelease">lrelease</primary>
470 </indexterm>
471 </listitem>
472 </varlistentry>
473
474 <varlistentry id="qt-lupdate">
475 <term><command>lupdate</command></term>
476 <listitem>
477 <para>
478 reads a Qt project file, finds the translatable
479 strings in the specified source, header and Qt Designer
480 interface files, and produces or updates the translation
481 files listed in the project file.
482 </para>
483 <indexterm zone="qt4 qt-lupdate">
484 <primary sortas="b-lupdate">lupdate</primary>
485 </indexterm>
486 </listitem>
487 </varlistentry>
488
489 <varlistentry id="qt-moc">
490 <term><command>moc</command></term>
491 <listitem>
492 <para>
493 generates Qt meta object support code.
494 </para>
495 <indexterm zone="qt4 qt-moc">
496 <primary sortas="b-moc">moc</primary>
497 </indexterm>
498 </listitem>
499 </varlistentry>
500
501 <varlistentry id="qt-pixeltool">
502 <term><command>pixeltool</command></term>
503 <listitem>
504 <para>
505 is a desktop magnifier and as you move your mouse around
506 the screen it will show the magnified contents in its window.
507 </para>
508 <indexterm zone="qt4 qt-pixeltool">
509 <primary sortas="b-pixeltool">pixeltool</primary>
510 </indexterm>
511 </listitem>
512 </varlistentry>
513
514 <varlistentry id="qt-qmake">
515 <term><command>qmake</command></term>
516 <listitem>
517 <para>
518 uses information stored in project files to
519 determine what should go in the makefiles it
520 generates.
521 </para>
522 <indexterm zone="qt4 qt-qmake">
523 <primary sortas="b-qmake">qmake</primary>
524 </indexterm>
525 </listitem>
526 </varlistentry>
527
528 <varlistentry id="qt-qt3to4">
529 <term><command>qt3to4</command></term>
530 <listitem>
531 <para>
532 qt3to4 is a tool to help update Qt3 code to Qt4.
533 </para>
534 <indexterm zone="qt4 qt-qt3to4">
535 <primary sortas="b-qt3to4">qt3to4</primary>
536 </indexterm>
537 </listitem>
538 </varlistentry>
539
540 <varlistentry id="qt-qtconfig">
541 <term><command>qtconfig</command></term>
542 <listitem>
543 <para>
544 is used to customize the appearance of Qt applications.
545 </para>
546 <indexterm zone="qt4 qt-qtconfig">
547 <primary sortas="b-qtconfig">qtconfig</primary>
548 </indexterm>
549 </listitem>
550 </varlistentry>
551
552 <varlistentry id="qt-rcc">
553 <term><command>rcc</command></term>
554 <listitem>
555 <para>
556 is a resource compiler used in conjunction with designer.
557 </para>
558 <indexterm zone="qt4 qt-rcc">
559 <primary sortas="b-rcc">rcc</primary>
560 </indexterm>
561 </listitem>
562 </varlistentry>
563
564 <varlistentry id="qt-uic">
565 <term><command>uic</command></term>
566 <listitem>
567 <para>
568 is a Qt user interface compiler.
569 </para>
570 <indexterm zone="qt4 qt-uic">
571 <primary sortas="b-uic">uic</primary>
572 </indexterm>
573 </listitem>
574 </varlistentry>
575
576 <varlistentry id="qt-uic3">
577 <term><command>uic3</command></term>
578 <listitem>
579 <para>
580 is a tool to generate Qt4 code out of
581 user interface files generated by the Qt3
582 version of designer.
583 </para>
584 <indexterm zone="qt4 qt-uic3">
585 <primary sortas="b-uic3">uic3</primary>
586 </indexterm>
587 </listitem>
588 </varlistentry>
589
590 </variablelist>
591
592 </sect2>
593
594</sect1>
Note: See TracBrowser for help on using the repository browser.