source: x/lib/qt4.xml@ a41f643

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

Globally removed all extraneous spaces

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