source: x/lib/qt4.xml@ ab7b9fc

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

Updated to Berkeley DB 5.1.19.

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