source: x/lib/qt4.xml@ 217e25a1

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

Updated qt4 to version 4.4.3.

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