source: x/lib/qt4.xml@ 47969a6

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 47969a6 was 47969a6, checked in by Thomas Trepl <thomas@…>, 13 years ago

Add several packages in preparation for (but not only for) KDE4

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@8858 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"><xref linkend="nas"/>,
74 <xref linkend="dbus"/>,
75 <xref linkend="gst-plugins-base"/>,
76 <ulink url="http://www.pulseaudio.org/">PulseAudio</ulink>,
77 <xref linkend="glib2"/>,
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 -nomake examples \
176 -nomake demos &amp;&amp;
177make</userinput></screen>
178
179 <note><title>Phonon</title>
180 <para>If <application>KDE4</application> is intended to be installed, add
181 <option>-no-phonon</option> to the <command>./configure</command> command
182 above. While installing <application>KDE4</application>, a separate version of the
183 <application>Phonon</application> libraries will be installed which better
184 matches the needs of the <application>KDE4</application> desktop.</para></note>
185
186 <para>This package does not come with a test suite.</para>
187
188 <para>Now, as the <systemitem class="username">root</systemitem>
189 user:</para>
190
191<screen role="root"><userinput>make install</userinput></screen>
192
193 <para>If you installed <application>Qt4</application> in the /opt directory,
194 again as the <systemitem class="username">root</systemitem> user issue:</para>
195
196<screen role="root"><userinput>ln -v -sfn qt-&qt4-version; /opt/qt</userinput></screen>
197
198 </sect2>
199
200 <sect2 role="commands">
201 <title>Command Explanations</title>
202
203 <para><parameter>-nomake examples, -nomake demos</parameter>:
204 These switches disable building programs that are only of interest
205 to a <application>Qt4</application> developer.</para>
206
207 <para>There are several optional directories that can be specified in the
208 <command>./configure</command> line. These include
209 <option>-bindir</option>, <option>-libdir</option>,
210 <option>-docdir</option>, and <option>-headerdir</option>. For a complete
211 list, run <command>./configure -help</command>.</para>
212
213 <para><parameter>-plugin-sql-<replaceable>&lt;driver&gt;</replaceable></parameter>
214 or <parameter>-qt-sql-<replaceable>&lt;driver&gt;</replaceable></parameter>:
215 These switches build SQL support into the <application>Qt4</application>
216 libraries.</para>
217
218 <note>
219 <para>To check if <application>mysql</application> is autodetected
220 properly, examine the output of <command>./configure -qt-sql-mysql
221 -help</command>. Other database support will require similar
222 <command>configure</command> parameters.</para>
223 </note>
224
225 </sect2>
226
227 <sect2 role="configuration">
228 <title>Configuring Qt4</title>
229
230 <sect3 id='qt4-config'>
231 <title>Configuration Information</title>
232
233 <para>If you installed <application>Qt4</application> in a location other
234 than /usr, you also need to update the following configuration files so
235 that <application>Qt4</application> is correctly found by other packages
236 and system processes.</para>
237
238 <para>As the <systemitem class="username">root</systemitem> user, update
239 the <filename>/etc/ld.so.conf</filename> file and the dynamic linker's
240 run-time cache file:</para>
241
242<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF" &amp;&amp;
243<literal># Begin qt addition to /etc/ld.so.conf
244
245/opt/qt/lib
246
247# End qt addition</literal>
248EOF
249ldconfig</userinput></screen>
250
251 <indexterm zone="qt qt4-config">
252 <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
253 </indexterm>
254
255 <para>Update the <envar>PKG_CONFIG_PATH</envar> environment variable
256 in your <filename>~/.bash_profile</filename> or
257 <filename>/etc/profile</filename> with the following:</para>
258
259<screen><literal>PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/qt/lib/pkgconfig</literal></screen>
260
261 <para>If you want the <application>Qt4</application> executables in your
262 shell search path, update the <envar>PATH</envar> environment variable
263 in your <filename>~/.bash_profile</filename> or
264 <filename>/etc/profile</filename> to include
265 <filename class='directory'>/opt/qt/bin</filename>.</para>
266
267 </sect3>
268 </sect2>
269
270 <sect2 role="content">
271 <title>Contents</title>
272
273 <segmentedlist>
274 <segtitle>Installed Programs</segtitle>
275 <segtitle>Installed Libraries</segtitle>
276 <segtitle>Installed Directories</segtitle>
277
278 <seglistitem>
279 <seg>assistant, assistant_adp, designer, lconvert, linguist, lrelease,
280 lupdate, moc, pixeltool, qcollectiongenerator, qdbus, qdbuscpp2xml,
281 qdbusviewer, qdbusxml2cpp, qhelpconverter, qhelpgenerator,qmake,
282 qt3to4, qtconfig, qtdemo, rcc, uic, uic3, and xmlpatterns</seg>
283
284 <seg>libphonon.so, libQt3Support.so, libQtAssistantClient.so,
285 libQtCLucene.so, libQtCore.so, libQtDesigner.so, libQtDBus.so,
286 libQtDesignerComponents.so, libQtGui.so, libQtHelp.so, libQtNetwork.so,
287 libQtOpenGL.so, libQtScript.so, libQtScriptTools.so, libQtSql.so,
288 libQtSvg.so, libQtTest.so, libQtUiTools.a, libQtWebKit.so, libQtXml.so,
289 libQtXmlPatterns.so, and numerous plugin modules installed in
290 <filename class='directory'>/opt/qt/plugins</filename></seg>
291
292 <seg>/opt/qt-&qt4-version;</seg>
293 </seglistitem>
294 </segmentedlist>
295
296 <variablelist>
297 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
298 <?dbfo list-presentation="list"?>
299 <?dbhtml list-presentation="table"?>
300
301 <varlistentry id="qt4-assistant">
302 <term><command>assistant</command></term>
303 <listitem>
304 <para>is a tool for presenting on-line documentation.</para>
305 <indexterm zone="qt4 qt4-assistant">
306 <primary sortas="b-assistant">assistant</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="qt4-designer">
312 <term><command>designer</command></term>
313 <listitem>
314 <para>is a full-fledged GUI builder. It includes
315 powerful features such as preview mode, automatic widget
316 layout, support for custom widgets, and an advanced
317 property editor.</para>
318 <indexterm zone="qt4 qt4-designer">
319 <primary sortas="b-designer">designer</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 <varlistentry id="qt4-linguist">
325 <term><command>linguist</command></term>
326 <listitem>
327 <para>provides support for translating applications into
328 local languages.</para>
329 <indexterm zone="qt4 qt4-linguist">
330 <primary sortas="b-linguist">linguist</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 <varlistentry id="qt4-lrelease">
336 <term><command>lrelease</command></term>
337 <listitem>
338 <para>is a simple command line tool. It reads a Qt project
339 file and produces message files used by the application.</para>
340 <indexterm zone="qt4 qt4-lrelease">
341 <primary sortas="b-lrelease">lrelease</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="qt4-lupdate">
347 <term><command>lupdate</command></term>
348 <listitem>
349 <para>reads a Qt project file, finds the translatable
350 strings in the specified source, header and Qt Designer
351 interface files, and produces or updates the translation
352 files listed in the project file.</para>
353 <indexterm zone="qt4 qt4-lupdate">
354 <primary sortas="b-lupdate">lupdate</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="qt4-moc">
360 <term><command>moc</command></term>
361 <listitem>
362 <para>generates Qt meta object support code.</para>
363 <indexterm zone="qt4 qt4-moc">
364 <primary sortas="b-moc">moc</primary>
365 </indexterm>
366 </listitem>
367 </varlistentry>
368
369 <varlistentry id="qt4-pixeltool">
370 <term><command>pixeltool</command></term>
371 <listitem>
372 <para>is a desktop magnifier and as you move your mouse around
373 the screen it will show the magnified contents in its window.</para>
374 <indexterm zone="qt4 qt4-pixeltool">
375 <primary sortas="b-pixeltool">pixeltool</primary>
376 </indexterm>
377 </listitem>
378 </varlistentry>
379
380 <varlistentry id="qt4-qmake">
381 <term><command>qmake</command></term>
382 <listitem>
383 <para>qmake uses information stored in project files to
384 determine what should go in the makefiles it generates.</para>
385 <indexterm zone="qt4 qt4-qmake">
386 <primary sortas="b-qmake">qmake</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390
391 <varlistentry id="qt4-qt3to4">
392 <term><command>qt3to4</command></term>
393 <listitem>
394 <para>qt3to4 is a tool to help update Qt3 code to Qt4.</para>
395 <indexterm zone="qt4 qt4-qt3to4">
396 <primary sortas="b-qt3to4">qt3to4</primary>
397 </indexterm>
398 </listitem>
399 </varlistentry>
400
401 <varlistentry id="qt4-qtconfig">
402 <term><command>qtconfig</command></term>
403 <listitem>
404 <para>is used to customize the appearance of Qt applications.</para>
405 <indexterm zone="qt4 qt4-qtconfig">
406 <primary sortas="b-qtconfig">qtconfig</primary>
407 </indexterm>
408 </listitem>
409 </varlistentry>
410
411 <varlistentry id="qt4-qtdemo">
412 <term><command>qtdemo</command></term>
413 <listitem>
414 <para>is a portal into various demonstrations of Qt
415 applications.</para>
416 <indexterm zone="qt4 qt4-qtdemo">
417 <primary sortas="b-qtdemo">qtdemo</primary>
418 </indexterm>
419 </listitem>
420 </varlistentry>
421
422 <varlistentry id="qt4-rcc">
423 <term><command>rcc</command></term>
424 <listitem>
425 <para>is a resource compiler used in conjucntion with designer.</para>
426 <indexterm zone="qt4 qt4-rcc">
427 <primary sortas="b-rcc">rcc</primary>
428 </indexterm>
429 </listitem>
430 </varlistentry>
431
432 <varlistentry id="qt4-uic">
433 <term><command>uic</command></term>
434 <listitem>
435 <para>is a Qt user interface compiler.</para>
436 <indexterm zone="qt4 qt4-uic">
437 <primary sortas="b-uic">uic</primary>
438 </indexterm>
439 </listitem>
440 </varlistentry>
441
442 <varlistentry id="qt4-uic3">
443 <term><command>uic3</command></term>
444 <listitem>
445 <para>is a tool to generate Qt4 code out of
446 user interface files generated by the Qt3
447 version of <command>designer</command>.</para>
448 <indexterm zone="qt4 qt4-uic3">
449 <primary sortas="b-uic3">uic3</primary>
450 </indexterm>
451 </listitem>
452 </varlistentry>
453
454 </variablelist>
455
456 </sect2>
457
458</sect1>
Note: See TracBrowser for help on using the repository browser.