source: x/lib/qt4.xml@ de53c9be

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

Fixed broken HTML download URLs for both Qt packages

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