source: x/lib/qt4.xml@ 1de3dce9

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 1de3dce9 was 1de3dce9, checked in by Igor Živković <igor@…>, 11 years ago

Qt-4.8.5

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