source: x/lib/qt4.xml@ ea0d62a

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 ea0d62a was ea0d62a, checked in by Randy McMurchy <randy@…>, 13 years ago

Updated to Qt-4.7.1

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