source: x/lib/qt4.xml@ c67fbf64

systemd-11177
Last change on this file since c67fbf64 was c67fbf64, checked in by Krejzi <krejzi@…>, 11 years ago

Remove packages that are now in lfs systemd from blfs.

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