source: x/lib/qt4.xml@ 6a056c63

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 6a056c63 was 6a056c63, checked in by Igor Živković <igor@…>, 11 years ago

Separate qdbusviewer-qt4 menu entry creation instructions

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