source: x/lib/qt4.xml@ fd7e0ed6

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.3 6.3-rc1 6.3-rc2 6.3-rc3 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 fd7e0ed6 was fd7e0ed6, checked in by Randy McMurchy <randy@…>, 16 years ago

Changed all lines with nothing but whitespace to blank lines

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