source: x/lib/qt4.xml@ 6122386

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 6122386 was 6122386, checked in by DJ Lucas <dj@…>, 13 years ago

Removed NAS and RMan from the book.

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