source: x/lib/qt4.xml@ a8e9d06

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 a8e9d06 was a8e9d06, checked in by Bruce Dubbs <bdubbs@…>, 16 years ago

Added qt4 to the book

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