source: x/lib/qt4.xml@ fe48aa6

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 fe48aa6 was fe48aa6, checked in by Bruce Dubbs <bdubbs@…>, 12 years ago

Remove Trinity/KDE3, Qt3, and related packages from the book.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9769 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 17.5 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://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-&qt4-version;.tar.gz">
8 <!ENTITY qt4-download-ftp "ftp://ftp.trolltech.com/qt/source/qt-everywhere-opensource-src-&qt4-version;.tar.gz">
9 <!ENTITY qt4-md5sum "e8a5fdbeba2927c948d9f477a6abe904">
10 <!ENTITY qt4-size "228 MB">
11 <!ENTITY qt4-buildsize "1.8 GB (full), 619 (essential)">
12 <!ENTITY qt4-time "69 SBU (full), 54 SBU (essential)">
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-qt4">Qt4</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Qt4</title>
31
32 <para>The <application>Qt4</application> package contains several
33 <application>C++</application> libraries with both GUI and non-GUI
34 components. One of the major users of <application>Qt4</application> is
35 <application>KDE4</application>.</para>
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>Download (HTTP): <ulink url="&qt4-download-http;"/></para>
41 </listitem>
42 <listitem>
43 <para>Download (FTP): <ulink url="&qt4-download-ftp;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download MD5 sum: &qt4-md5sum;</para>
47 </listitem>
48 <listitem>
49 <para>Download size: &qt4-size;</para>
50 </listitem>
51 <listitem>
52 <para>Estimated disk space required: &qt4-buildsize;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated build time: &qt4-time;</para>
56 </listitem>
57 </itemizedlist>
58
59 <bridgehead renderas="sect3">Qt Dependencies</bridgehead>
60
61 <bridgehead renderas="sect4">Required</bridgehead>
62 <para role="required"><xref linkend="x-window-system"/></para>
63
64 <bridgehead renderas="sect4">Recommended</bridgehead>
65 <para role="recommended"><xref linkend="libjpeg"/>,
66 <xref linkend="libmng"/>,
67 <xref linkend="libtiff"/>,
68 <xref linkend="libpng"/>, and
69 <xref linkend="pkgconfig"/> (needed to use D-BUS, GLib, GTK and PulseAudio)
70 </para>
71
72 <bridgehead renderas="sect4">Optional</bridgehead>
73 <para role="optional">
74 <!--<xref linkend="nas"/>,-->
75 <xref linkend="dbus"/>,
76 <xref linkend="gst-plugins-base"/>,
77 <xref linkend='pulseaudio'/>,
78 <xref linkend="gtk2"/>,
79 <xref linkend="openssl"/>,
80 <xref linkend="cups"/>,
81 <xref linkend="mysql"/>,
82 <xref linkend="postgresql"/>,
83 <xref linkend="unixodbc"/>, and
84 <xref linkend="sqlite"/>
85 </para>
86
87 <para condition="html" role="usernotes">User Notes:
88 <ulink url="&blfs-wiki;/qt4"/></para>
89
90 </sect2>
91
92 <sect2 role="installation">
93 <title>Installation of Qt4</title>
94
95 <para>There are several ways to install a complicated package such as
96 <application>Qt4</application>. The files are not completely position
97 independent. Installation procedures execute the program
98 <command>pkg-config</command> to determine the location of package
99 executables, libraries, headers, and other files. For
100 <application>Qt4</application>, <command>pkg-config</command> will look
101 for the appropriate <filename>lib/pkgconfig/Qt*.pc</filename> files which
102 must be modified if relocating the package. These files are set up correctly
103 by the build process.</para>
104
105 <para>The default installation places the files in
106 <filename class='directory'>/usr/local/qt/</filename>. Many commercial
107 distributions place the files in the system's
108 <filename class='directory'>/usr</filename> hierarchy. The package can
109 also be installed in an arbitrary directory.</para>
110
111 <para>The advantage of this method is that no updates to the
112 <filename>/etc/ld.so.conf</filename> or
113 <filename>/etc/man_db.conf</filename> files are required. The package
114 files are distributed within several subdirectories of the
115 <filename class='directory'>/usr</filename> hierarchy.
116 This is the method that most commercial distributions use.</para>
117
118 <note>
119 <para>There is no conflict between the <application>Qt3</application>
120 and <application>Qt4</application> applications and headers so both
121 can be installed at the same time. This may be necessary to build or
122 run Qt3 applications like <application>KDE3</application> and
123 <application>Qt4</application> applications like
124 <application>Doxygen</application>'s <application>doxywizard</application>
125 on the same system.
126 </para>
127
128 <para>To set up both <application>Qt3</application> and
129 <application>Qt4</application> on the same system, choose the primary
130 version for the <filename>/opt/qt</filename> symbolic link and add
131 the explicit library directory of the other version to
132 <filename>/etc/ld.so.conf</filename>.</para>
133
134 <para>On a system with both versions of Qt, there is a name conflict with
135 Qt applications such as <filename>qmake</filename>,
136 <filename>assistant</filename>, and <filename>designer</filename>. In
137 such a case, make sure the PATH variable lists the proper
138 <filename>/opt/qt&lt;version&gt;/bin</filename> directory before the
139 other Qt bin directory. </para>
140 </note>
141
142 <caution>
143 <para>If <application>Qt4</application> is being reinstalled and the
144 <filename class='directory'>/usr</filename>
145 directory is used as the prefix, run the following commands from a
146 console or non-Qt4 based window manager. It overwrites
147 <application>Qt4</application> libraries that should not be in use during
148 the install process.</para>
149 </caution>
150
151 <note>
152 <para>The build time and space required for the full
153 <application>Qt4</application> is quite long. The instructions below do
154 not build the tutorials and examples. Removing the
155 <parameter>-nomake</parameter> lines will create a complete build.</para>
156 </note>
157
158 <para>The method recommended by the <application>Qt4</application>
159 developers does not use the /usr directory prefix. It has the advantage of
160 keeping all the package files consolidated in a dedicated directory
161 hierarchy. By using this method, an update can be made without overwriting
162 a previous installation and users can easily revert to a previous version
163 by changing one symbolic link.</para>
164
165 <para>The <application>Qt4</application> developers use a default location
166 of <filename class='directory'>/usr/local/qt/</filename>, however the
167 procedure below puts the files in <filename
168 class='directory'>/opt/qt-&qt4-version;/</filename>
169 and then creates a symbolic link to <filename>/opt/qt/</filename>.</para>
170
171 <para>Install <application>Qt4</application> by running the
172 following commands:</para>
173
174<screen><userinput>./configure -prefix /opt/qt-&qt4-version; \
175 -release \
176 -nomake examples \
177 -nomake demos \
178 -system-sqlite \
179 -no-nis \
180 &amp;&amp;
181make</userinput></screen>
182
183 <note><title>Phonon</title>
184 <para>If <application>KDE4</application> is intended to be installed, add
185 <option>-no-phonon</option> to the <command>./configure</command> command
186 above. While installing <application>KDE4</application>, a separate version of the
187 <application>Phonon</application> libraries will be installed which better
188 matches the needs of the <application>KDE4</application> desktop.</para></note>
189
190 <para>This package does not come with a test suite.</para>
191
192 <para>Now, as the <systemitem class="username">root</systemitem>
193 user:</para>
194
195<screen role="root"><userinput>make install</userinput></screen>
196
197 <para>If you installed <application>Qt4</application> in the /opt directory,
198 again as the <systemitem class="username">root</systemitem> user issue:</para>
199
200<screen role="root"><userinput>ln -v -sfn qt-&qt4-version; /opt/qt</userinput></screen>
201
202 </sect2>
203
204 <sect2 role="commands">
205 <title>Command Explanations</title>
206
207 <para><parameter>-nomake examples, -nomake demos</parameter>:
208 These switches disable building programs that are only of interest
209 to a <application>Qt4</application> developer.</para>
210
211 <para>There are several optional directories that can be specified in the
212 <command>./configure</command> line. These include
213 <option>-bindir</option>, <option>-libdir</option>,
214 <option>-docdir</option>, and <option>-headerdir</option>. For a complete
215 list, run <command>./configure -help</command>.</para>
216
217 <para><parameter>-plugin-sql-<replaceable>&lt;driver&gt;</replaceable></parameter>
218 or <parameter>-qt-sql-<replaceable>&lt;driver&gt;</replaceable></parameter>:
219 These switches build SQL support into the <application>Qt4</application>
220 libraries.</para>
221
222 <note>
223 <para>To check if <application>mysql</application> is autodetected
224 properly, examine the output of <command>./configure -qt-sql-mysql
225 -help</command>. Other database support will require similar
226 <command>configure</command> parameters.</para>
227 </note>
228
229 </sect2>
230
231 <sect2 role="configuration">
232 <title>Configuring Qt4</title>
233
234 <sect3 id='qt4-config'>
235 <title>Configuration Information</title>
236
237 <para>If you installed <application>Qt4</application> in a location other
238 than /usr, you also need to update the following configuration files so
239 that <application>Qt4</application> is correctly found by other packages
240 and system processes.</para>
241
242 <para>As the <systemitem class="username">root</systemitem> user, update
243 the <filename>/etc/ld.so.conf</filename> file and the dynamic linker's
244 run-time cache file:</para>
245
246<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF" &amp;&amp;
247<literal># Begin qt addition to /etc/ld.so.conf
248
249/opt/qt/lib
250
251# End qt addition</literal>
252EOF
253ldconfig</userinput></screen>
254
255 <indexterm zone="qt4 qt4-config">
256 <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
257 </indexterm>
258
259 <para>As the <systemitem class="username">root</systemitem> user, create
260 the <filename>/etc/profile.d/qt4.sh</filename> file:</para>
261
262<screen><userinput>cat &gt; /etc/profile.d/qt4.sh &lt;&lt; "EOF"
263# Begin /etc/profile.d/qt4.sh
264
265QT4DIR=/opt/qt
266QTDIR=/opt/qt
267
268pathappend /opt/qt/bin PATH
269pathappend /opt/qt/lib/pkgconfig PKG_CONFIG_PATH
270
271export QT4DIR QTDIR
272
273# End /etc/profile.d/qt4.sh
274EOF</userinput></screen>
275
276 </sect3>
277 </sect2>
278
279 <sect2 role="content">
280 <title>Contents</title>
281
282 <segmentedlist>
283 <segtitle>Installed Programs</segtitle>
284 <segtitle>Installed Libraries</segtitle>
285 <segtitle>Installed Directories</segtitle>
286
287 <seglistitem>
288 <seg>assistant, assistant_adp, designer, lconvert, linguist, lrelease,
289 lupdate, moc, pixeltool, qcollectiongenerator, qdbus, qdbuscpp2xml,
290 qdbusviewer, qdbusxml2cpp, qhelpconverter, qhelpgenerator,qmake,
291 qt3to4, qtconfig, qtdemo, rcc, uic, uic3, and xmlpatterns</seg>
292
293 <seg>libphonon.so, libQt3Support.so, libQtAssistantClient.so,
294 libQtCLucene.so, libQtCore.so, libQtDesigner.so, libQtDBus.so,
295 libQtDesignerComponents.so, libQtGui.so, libQtHelp.so, libQtNetwork.so,
296 libQtOpenGL.so, libQtScript.so, libQtScriptTools.so, libQtSql.so,
297 libQtSvg.so, libQtTest.so, libQtUiTools.a, libQtWebKit.so, libQtXml.so,
298 libQtXmlPatterns.so, and numerous plugin modules installed in
299 <filename class='directory'>/opt/qt/plugins</filename></seg>
300
301 <seg>/opt/qt-&qt4-version;</seg>
302 </seglistitem>
303 </segmentedlist>
304
305 <variablelist>
306 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
307 <?dbfo list-presentation="list"?>
308 <?dbhtml list-presentation="table"?>
309
310 <varlistentry id="qt4-assistant">
311 <term><command>assistant</command></term>
312 <listitem>
313 <para>is a tool for presenting on-line documentation.</para>
314 <indexterm zone="qt4 qt4-assistant">
315 <primary sortas="b-assistant">assistant</primary>
316 </indexterm>
317 </listitem>
318 </varlistentry>
319
320 <varlistentry id="qt4-designer">
321 <term><command>designer</command></term>
322 <listitem>
323 <para>is a full-fledged GUI builder. It includes
324 powerful features such as preview mode, automatic widget
325 layout, support for custom widgets, and an advanced
326 property editor.</para>
327 <indexterm zone="qt4 qt4-designer">
328 <primary sortas="b-designer">designer</primary>
329 </indexterm>
330 </listitem>
331 </varlistentry>
332
333 <varlistentry id="qt4-linguist">
334 <term><command>linguist</command></term>
335 <listitem>
336 <para>provides support for translating applications into
337 local languages.</para>
338 <indexterm zone="qt4 qt4-linguist">
339 <primary sortas="b-linguist">linguist</primary>
340 </indexterm>
341 </listitem>
342 </varlistentry>
343
344 <varlistentry id="qt4-lrelease">
345 <term><command>lrelease</command></term>
346 <listitem>
347 <para>is a simple command line tool. It reads a Qt project
348 file and produces message files used by the application.</para>
349 <indexterm zone="qt4 qt4-lrelease">
350 <primary sortas="b-lrelease">lrelease</primary>
351 </indexterm>
352 </listitem>
353 </varlistentry>
354
355 <varlistentry id="qt4-lupdate">
356 <term><command>lupdate</command></term>
357 <listitem>
358 <para>reads a Qt project file, finds the translatable
359 strings in the specified source, header and Qt Designer
360 interface files, and produces or updates the translation
361 files listed in the project file.</para>
362 <indexterm zone="qt4 qt4-lupdate">
363 <primary sortas="b-lupdate">lupdate</primary>
364 </indexterm>
365 </listitem>
366 </varlistentry>
367
368 <varlistentry id="qt4-moc">
369 <term><command>moc</command></term>
370 <listitem>
371 <para>generates Qt meta object support code.</para>
372 <indexterm zone="qt4 qt4-moc">
373 <primary sortas="b-moc">moc</primary>
374 </indexterm>
375 </listitem>
376 </varlistentry>
377
378 <varlistentry id="qt4-pixeltool">
379 <term><command>pixeltool</command></term>
380 <listitem>
381 <para>is a desktop magnifier and as you move your mouse around
382 the screen it will show the magnified contents in its window.</para>
383 <indexterm zone="qt4 qt4-pixeltool">
384 <primary sortas="b-pixeltool">pixeltool</primary>
385 </indexterm>
386 </listitem>
387 </varlistentry>
388
389 <varlistentry id="qt4-qmake">
390 <term><command>qmake</command></term>
391 <listitem>
392 <para>qmake uses information stored in project files to
393 determine what should go in the makefiles it generates.</para>
394 <indexterm zone="qt4 qt4-qmake">
395 <primary sortas="b-qmake">qmake</primary>
396 </indexterm>
397 </listitem>
398 </varlistentry>
399
400 <varlistentry id="qt4-qt3to4">
401 <term><command>qt3to4</command></term>
402 <listitem>
403 <para>qt3to4 is a tool to help update Qt3 code to Qt4.</para>
404 <indexterm zone="qt4 qt4-qt3to4">
405 <primary sortas="b-qt3to4">qt3to4</primary>
406 </indexterm>
407 </listitem>
408 </varlistentry>
409
410 <varlistentry id="qt4-qtconfig">
411 <term><command>qtconfig</command></term>
412 <listitem>
413 <para>is used to customize the appearance of Qt applications.</para>
414 <indexterm zone="qt4 qt4-qtconfig">
415 <primary sortas="b-qtconfig">qtconfig</primary>
416 </indexterm>
417 </listitem>
418 </varlistentry>
419
420 <varlistentry id="qt4-qtdemo">
421 <term><command>qtdemo</command></term>
422 <listitem>
423 <para>is a portal into various demonstrations of Qt
424 applications.</para>
425 <indexterm zone="qt4 qt4-qtdemo">
426 <primary sortas="b-qtdemo">qtdemo</primary>
427 </indexterm>
428 </listitem>
429 </varlistentry>
430
431 <varlistentry id="qt4-rcc">
432 <term><command>rcc</command></term>
433 <listitem>
434 <para>is a resource compiler used in conjucntion with designer.</para>
435 <indexterm zone="qt4 qt4-rcc">
436 <primary sortas="b-rcc">rcc</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440
441 <varlistentry id="qt4-uic">
442 <term><command>uic</command></term>
443 <listitem>
444 <para>is a Qt user interface compiler.</para>
445 <indexterm zone="qt4 qt4-uic">
446 <primary sortas="b-uic">uic</primary>
447 </indexterm>
448 </listitem>
449 </varlistentry>
450
451 <varlistentry id="qt4-uic3">
452 <term><command>uic3</command></term>
453 <listitem>
454 <para>is a tool to generate Qt4 code out of
455 user interface files generated by the Qt3
456 version of <command>designer</command>.</para>
457 <indexterm zone="qt4 qt4-uic3">
458 <primary sortas="b-uic3">uic3</primary>
459 </indexterm>
460 </listitem>
461 </varlistentry>
462
463 </variablelist>
464
465 </sect2>
466
467</sect1>
Note: See TracBrowser for help on using the repository browser.