source: x/lib/qt4.xml@ a7eaa89

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 a7eaa89 was a7eaa89, checked in by Krejzi <krejzi@…>, 11 years ago

revert some parts of previous two commits

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11682 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 18.8 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
8 "http://download.qt-project.org/official_releases/qt/4.8/&qt4-version;/qt-everywhere-opensource-src-&qt4-version;.tar.gz">
9 <!ENTITY qt4-download-ftp " ">
10 <!ENTITY qt4-md5sum "1864987bdbb2f58f8ae8b350dfdbe133">
11 <!ENTITY qt4-size "231 MB">
12 <!ENTITY qt4-buildsize "1.9 GB">
13 <!ENTITY qt4-time "41 SBU">
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-Qt">Qt</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Qt</title>
32
33 <para>
34 <application>Qt</application> is a cross-platform application
35 framework that is widely used for developing application software
36 with a graphical user interface (GUI) (in which cases Qt is classified
37 as a widget toolkit), and also used for developing non-GUI programs such
38 as command-line tools and consoles for servers. One of the major users
39 of <application>Qt</application> is <application>KDE</application>.
40 </para>
41
42 &lfs73_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&qt4-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&qt4-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &qt4-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &qt4-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &qt4-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &qt4-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Qt Dependencies</bridgehead>
79
80 <bridgehead renderas="sect4">Required</bridgehead>
81 <para role="required">
82 <xref linkend="alsa-lib"/>,
83 <xref linkend="mesalib"/> and
84 <xref linkend="qtchooser"/>
85 </para>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 <xref linkend="cacerts"/>,
90 <xref linkend="dbus"/>,
91 <xref linkend="glib2"/>,
92 <xref linkend="icu"/> (unicode support),
93 <xref linkend="libjpeg"/>,
94 <xref linkend="libmng"/>,
95 <xref linkend="libpng"/>,
96 <xref linkend="libtiff"/>,
97 <xref linkend="openssl"/> and
98 <xref linkend="sqlite"/>
99 </para>
100
101 <bridgehead renderas="sect4">Optional</bridgehead>
102 <para role="optional">
103 <xref linkend="cups"/>,
104 <xref linkend="gtk2"/> (GTK+ 2 theme support),
105 <xref linkend="gst-plugins-base"/> (For QtWebKit HTML5 Video),
106 <xref linkend="mysql"/>,
107 <xref linkend="postgresql"/>,
108 <xref linkend="pulseaudio"/> and
109 <xref linkend="unixodbc"/>
110 </para>
111
112 <para condition="html" role="usernotes">User Notes:
113 <ulink url="&blfs-wiki;/qt4"/>
114 </para>
115 </sect2>
116
117 <sect2 role="installation">
118 <title>Installation of Qt</title>
119
120 <warning>
121 <para>
122 If you did not install some of the recommended dependencies, examine
123 <command>./configure --help</command> output to check how to disable
124 them or use internal versions bundled in the source tarball.
125 </para>
126 </warning>
127
128 <caution>
129 <para>
130 If <application>Qt</application> is being reinstalled, run the
131 following commands from a console or non-Qt based window manager.
132 It overwrites <application>Qt</application> libraries that should
133 not be in use during the install process.
134 </para>
135 </caution>
136
137 <note>
138 <para>
139 The build time and space required for the full
140 <application>Qt</application> is quite long. The instructions below
141 do not build the tutorials and examples. Removing the
142 <parameter>-nomake</parameter> lines will create a complete build.
143 </para>
144 </note>
145
146 <para>
147 Install <application>Qt</application> by running the
148 following commands:
149 </para>
150
151<screen><userinput>sed -i -e "/#if/d" -e "/#error/d" -e "/#endif/d" \
152 config.tests/unix/libmng/libmng.cpp &amp;&amp;
153
154./configure -confirm-license \
155 -opensource \
156 -release \
157 -prefix /usr \
158 -bindir /usr/lib/qt4/bin \
159 -headerdir /usr/include/qt4 \
160 -datadir /usr/share/qt4 \
161 -plugindir /usr/lib/qt4/plugins \
162 -importdir /usr/lib/qt4/imports \
163 -translationdir /usr/share/qt4/translations \
164 -sysconfdir /etc/xdg \
165 -docdir /usr/share/doc/qt4 \
166 -demosdir /usr/share/doc/qt4/demos \
167 -examplesdir /usr/share/doc/qt4/examples \
168 -dbus-linked \
169 -openssl-linked \
170 -system-sqlite \
171 -no-phonon \
172 -no-phonon-backend \
173 -no-nis \
174 -no-openvg \
175 -nomake demos \
176 -nomake examples \
177 -optimized-qmake &amp;&amp;
178make</userinput></screen>
179
180 <para>
181 This package does not come with a test suite.
182 </para>
183
184 <para>
185 Now, as the <systemitem class="username">root</systemitem> user:
186 </para>
187
188<screen role="root"><userinput>make install &amp;&amp;
189rm -rf /usr/tests &amp;&amp;
190install -v -Dm644 src/gui/dialogs/images/qtlogo-64.png \
191 /usr/share/pixmaps/qt4logo.png &amp;&amp;
192install -v -Dm644 tools/assistant/tools/assistant/images/assistant-128.png \
193 /usr/share/pixmaps/assistant-qt4.png &amp;&amp;
194install -v -Dm644 tools/designer/src/designer/images/designer.png \
195 /usr/share/pixmaps/designer-qt4.png &amp;&amp;
196install -v -Dm644 tools/linguist/linguist/images/icons/linguist-128-32.png \
197 /usr/share/pixmaps/linguist-qt4.png &amp;&amp;
198install -v -Dm644 tools/qdbus/qdbusviewer/images/qdbusviewer-128.png \
199 /usr/share/pixmaps/qdbusviewer-qt4.png</userinput></screen>
200
201 <para>
202 Remove references to the build directory from installed files by
203 running the following command as the
204 <systemitem class="username">root</systemitem> user:
205 </para>
206
207<screen role="root"><userinput>for file in 3Support CLucene Core DBus Declarative DesignerComponents \
208 Designer Gui Help Multimedia Network OpenGL Script \
209 ScriptTools Sql Svg Test UiTools WebKit XmlPatterns Xml
210do
211 sed -i -e '/^QMAKE_PRL_BUILD_DIR/d;s/\(QMAKE_PRL_LIBS =\).*/\1/' \
212 /usr/lib/libQt${file}.prl
213 perl -pi -e "s, -L$PWD/?\S+,,g" /usr/lib/pkgconfig/Qt${file}.pc
214done
215unset file</userinput></screen>
216
217 <para>
218 Symlink the <application>Qt</application> executables into
219 <filename class="directory">/usr/bin</filename> by running the
220 following commands as the
221 <systemitem class="username">root</systemitem> user:
222 </para>
223
224<screen role="root"><userinput>for file in /usr/lib/qt4/bin/*
225do
226 ln -sfv ../lib/qt4/bin/$(basename $file) /usr/bin/$(basename $file)-qt4
227done</userinput></screen>
228
229 </sect2>
230
231 <sect2 role="commands">
232 <title>Command Explanations</title>
233
234 <para>
235 <command>sed -i "..." ...</command>: This command fixes
236 detection of <application>libmng</application> 2.0.
237 </para>
238
239 <para>
240 <parameter>-confirm-license</parameter>: Accept license
241 without prompting user during configuration.
242 </para>
243
244 <para>
245 <parameter>-opensource</parameter>: Install the opensource
246 version of <application>Qt</application>.
247 </para>
248
249 <para>
250 <parameter>-release</parameter>: This switch disables
251 building with debugging symbols.
252 </para>
253
254 <para>
255 <parameter>-nomake examples -nomake demos</parameter>:
256 These switches disable building programs that are only of
257 interest to a <application>Qt</application> developer.
258 </para>
259
260 <para>
261 <parameter>-system-sqlite</parameter>: This switch enables use
262 the system version of <application>SQLite</application>.
263 </para>
264
265 <para>
266 <parameter>-no-nis</parameter>: This switch disables support
267 for Network Information Service (NIS) which has been
268 deprecated in recent versions of <application>Glibc</application>.
269 </para>
270
271 <para>
272 <parameter>-no-phonon -no-phonon-backend</parameter>: These
273 switches disable building of the bundled
274 <application>Phonon</application> library. Better version
275 is provided by <xref linkend="phonon"/> package.
276 </para>
277
278 <para>
279 <parameter>-dbus-linkend -openssl-linkend</parameter>: These
280 switches enable explicit linking of the
281 <application>D-Bus</application> and
282 <application>OpenSSL</application> libraries into
283 <application>Qt</application> libraries instead of
284 <command>dlopen()</command>-ing them.
285 </para>
286
287 <para>
288 <parameter>-no-openvg</parameter>: This switch disables
289 <application>OpenVG</application> support in
290 <application>Qt</application>.
291 </para>
292
293 <para>
294 <parameter>-optimized-qmake</parameter>: This switch enables
295 building of the optimized <command>qmake</command> program.
296 </para>
297
298 </sect2>
299
300 <sect2 role="configuration">
301 <title>Configuring Qt</title>
302
303 <sect3 id="qt4-config">
304 <title>Configuration Information</title>
305
306 <para>
307 Create an environment variable needed by certain packages.
308 As the <systemitem class="username">root</systemitem> user:
309 </para>
310
311<screen role="root"><userinput>cat &gt; /etc/profile.d/qt.sh &lt;&lt; EOF
312<literal># Begin /etc/profile.d/qt.sh
313
314QTDIR=/usr
315
316export QTDIR
317
318# End /etc/profile.d/qt.sh</literal>
319EOF</userinput></screen>
320
321 <para>
322 Create the menu entries for installed applications.
323 As the <systemitem class="username">root</systemitem> user:
324 </para>
325
326<screen role="root"><userinput>install -dm755 /usr/share/applications
327cat &gt; /usr/share/applications/qtconfig-qt4.desktop &lt;&lt; "EOF"
328<literal>[Desktop Entry]
329Name=Qt4 Config
330Comment=Configure Qt4 behavior, styles, fonts
331Exec=qtconfig-qt4
332Icon=qt4logo
333Terminal=false
334Encoding=UTF-8
335Type=Application
336Categories=Qt;Settings;</literal>
337EOF
338cat &gt; /usr/share/applications/assistant-qt4.desktop &lt;&lt; "EOF"
339<literal>[Desktop Entry]
340Name=Qt4 Assistant
341Comment=Shows Qt4 documentation and examples
342Exec=assistant-qt4
343Icon=assistant-qt4
344Terminal=false
345Encoding=UTF-8
346Type=Application
347Categories=Qt;Development;Documentation;</literal>
348EOF
349cat &gt; /usr/share/applications/designer-qt4.desktop &lt;&lt; "EOF"
350<literal>[Desktop Entry]
351Name=Qt4 Designer
352Comment=Design GUIs for Qt4 applications
353Exec=designer-qt4
354Icon=designer-qt4
355MimeType=application/x-designer;
356Terminal=false
357Encoding=UTF-8
358Type=Application
359Categories=Qt;Development;</literal>
360EOF
361cat &gt; /usr/share/applications/linguist-qt4.desktop &lt;&lt; "EOF"
362<literal>[Desktop Entry]
363Name=Qt4 Linguist
364Comment=Add translations to Qt4 applications
365Exec=linguist-qt4
366Icon=linguist-qt4
367MimeType=text/vnd.trolltech.linguist;application/x-linguist;
368Terminal=false
369Encoding=UTF-8
370Type=Application
371Categories=Qt;Development;</literal>
372EOF
373cat &gt; /usr/share/applications/qdbusviewer-qt4.desktop &lt;&lt; "EOF"
374<literal>[Desktop Entry]
375Name=Qt4 QDbusViewer
376GenericName=D-Bus Debugger
377Comment=Debug D-Bus applications
378Exec=qdbusviewer-qt4
379Icon=qdbusviewer-qt4
380Terminal=false
381Encoding=UTF-8
382Type=Application
383Categories=Qt;Development;Debugger;</literal>
384EOF</userinput></screen>
385
386 </sect3>
387
388 </sect2>
389
390 <sect2 role="content">
391 <title>Contents</title>
392
393 <segmentedlist>
394 <segtitle>Installed Programs</segtitle>
395 <segtitle>Installed Libraries</segtitle>
396 <segtitle>Installed Directories</segtitle>
397
398 <seglistitem>
399 <seg>
400 assistant-qt4, designer-qt4, lconvert-qt4, linguist-qt4,
401 lrelease-qt4, lupdate-qt4, moc-qt4, pixeltool-qt4,
402 qcollectiongenerator-qt4, qdbuscpp2xml-qt4, qdbus-qt4,
403 qdbusviewer-qt4, qdbusxml2cpp-qt4, qdoc3-qt4, qhelpconverter-qt4,
404 qhelpgenerator-qt4, qmake-qt4, qmlplugindump-qt4, qmlviewer-qt4,
405 qt3to4-qt4, qtconfig-qt4, qttracereplay-qt4, rcc-qt4, uic3-qt4,
406 uic-qt4, xmlpatterns-qt4 and xmlpatternsvalidator-qt4
407 </seg>
408 <seg>
409 libQt3Support.so, libQtCLucene.so, libQtCore.so, libQtDBus.so,
410 libQtDeclarative.so, libQtDesignerComponents.so,
411 libQtDesigner.so, libQtGui.so, libQtHelp.so, libQtMultimedia.so,
412 libQtNetwork.so, libQtOpenGL.so, libQtScript.so, libQtScriptTools.so,
413 libQtSql.so, libQtSvg.so, libQtTest.so, libQtWebKit.so,
414 libQtXmlPatterns.so and libQtXml.so
415 </seg>
416 <seg>
417 /usr/include/qt4,
418 /usr/lib/qt4,
419 /usr/share/doc/qt4 and
420 /usr/share/qt4
421 </seg>
422 </seglistitem>
423 </segmentedlist>
424
425 <variablelist>
426 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
427 <?dbfo list-presentation="list"?>
428 <?dbhtml list-presentation="table"?>
429
430 <varlistentry id="assistant-qt4">
431 <term><command>assistant-qt4</command></term>
432 <listitem>
433 <para>
434 is a tool for presenting on-line documentation.
435 </para>
436 <indexterm zone="qt4 assistant-qt4">
437 <primary sortas="b-assistant-qt4">assistant-qt4</primary>
438 </indexterm>
439 </listitem>
440 </varlistentry>
441
442 <varlistentry id="designer-qt4">
443 <term><command>designer-qt4</command></term>
444 <listitem>
445 <para>
446 is a full-fledged GUI builder. It includes
447 powerful features such as preview mode, automatic widget
448 layout, support for custom widgets, and an advanced
449 property editor.
450 </para>
451 <indexterm zone="qt4 designer-qt4">
452 <primary sortas="b-designer-qt4">designer-qt4</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456
457 <varlistentry id="linguist-qt4">
458 <term><command>linguist-qt4</command></term>
459 <listitem>
460 <para>
461 provides support for translating applications into
462 local languages.
463 </para>
464 <indexterm zone="qt4 linguist-qt4">
465 <primary sortas="b-linguist-qt4">linguist-qt4</primary>
466 </indexterm>
467 </listitem>
468 </varlistentry>
469
470 <varlistentry id="lrelease-qt4">
471 <term><command>lrelease-qt4</command></term>
472 <listitem>
473 <para>
474 is a simple command line tool. It reads a Qt project
475 file and produces message files used by the application.
476 </para>
477 <indexterm zone="qt4 lrelease-qt4">
478 <primary sortas="b-lrelease-qt4">lrelease-qt4</primary>
479 </indexterm>
480 </listitem>
481 </varlistentry>
482
483 <varlistentry id="lupdate-qt4">
484 <term><command>lupdate-qt4</command></term>
485 <listitem>
486 <para>
487 reads a Qt project file, finds the translatable
488 strings in the specified source, header and Qt Designer
489 interface files, and produces or updates the translation
490 files listed in the project file.
491 </para>
492 <indexterm zone="qt4 lupdate-qt4">
493 <primary sortas="b-lupdate-qt4">lupdate-qt4</primary>
494 </indexterm>
495 </listitem>
496 </varlistentry>
497
498 <varlistentry id="moc-qt4">
499 <term><command>moc-qt4</command></term>
500 <listitem>
501 <para>
502 generates Qt meta object support code.
503 </para>
504 <indexterm zone="qt4 moc-qt4">
505 <primary sortas="b-moc-qt4">moc-qt4</primary>
506 </indexterm>
507 </listitem>
508 </varlistentry>
509
510 <varlistentry id="pixeltool-qt4">
511 <term><command>pixeltool-qt4</command></term>
512 <listitem>
513 <para>
514 is a desktop magnifier and as you move your mouse around
515 the screen it will show the magnified contents in its window.
516 </para>
517 <indexterm zone="qt4 pixeltool-qt4">
518 <primary sortas="b-pixeltool-qt4">pixeltool-qt4</primary>
519 </indexterm>
520 </listitem>
521 </varlistentry>
522
523 <varlistentry id="qmake-qt4">
524 <term><command>qmake-qt4</command></term>
525 <listitem>
526 <para>
527 uses information stored in project files to
528 determine what should go in the makefiles it
529 generates.
530 </para>
531 <indexterm zone="qt4 qmake-qt4">
532 <primary sortas="b-qmake-qt4">qmake-qt4</primary>
533 </indexterm>
534 </listitem>
535 </varlistentry>
536
537 <varlistentry id="qt3to4-qt4">
538 <term><command>qt3to4-qt4</command></term>
539 <listitem>
540 <para>
541 qt3to4 is a tool to help update Qt3 code to Qt4.
542 </para>
543 <indexterm zone="qt4 qt3to4-qt4">
544 <primary sortas="b-qt3to4-qt4">qt3to4-qt4</primary>
545 </indexterm>
546 </listitem>
547 </varlistentry>
548
549 <varlistentry id="qtconfig-qt4">
550 <term><command>qtconfig-qt4</command></term>
551 <listitem>
552 <para>
553 is used to customize the appearance of Qt applications.
554 </para>
555 <indexterm zone="qt4 qtconfig-qt4">
556 <primary sortas="b-qtconfig-qt4">qtconfig-qt4</primary>
557 </indexterm>
558 </listitem>
559 </varlistentry>
560
561 <varlistentry id="rcc-qt4">
562 <term><command>rcc-qt4</command></term>
563 <listitem>
564 <para>
565 is a resource compiler used in conjunction with designer.
566 </para>
567 <indexterm zone="qt4 rcc-qt4">
568 <primary sortas="b-rcc-qt4">rcc-qt4</primary>
569 </indexterm>
570 </listitem>
571 </varlistentry>
572
573 <varlistentry id="uic-qt4">
574 <term><command>uic-qt4</command></term>
575 <listitem>
576 <para>
577 is a Qt user interface compiler.
578 </para>
579 <indexterm zone="qt4 uic-qt4">
580 <primary sortas="b-uic-qt4">uic-qt4</primary>
581 </indexterm>
582 </listitem>
583 </varlistentry>
584
585 <varlistentry id="uic3-qt4">
586 <term><command>uic3-qt4</command></term>
587 <listitem>
588 <para>
589 is a tool to generate Qt4 code out of
590 user interface files generated by the Qt3
591 version of designer.
592 </para>
593 <indexterm zone="qt4 uic3-qt4">
594 <primary sortas="b-uic3-qt4">uic3-qt4</primary>
595 </indexterm>
596 </listitem>
597 </varlistentry>
598
599 </variablelist>
600
601 </sect2>
602
603</sect1>
Note: See TracBrowser for help on using the repository browser.