source: x/lib/qt5-alternate.xml@ 23c4cec1

12.1 ken/TL2024 lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since 23c4cec1 was 157f1352, checked in by Bruce Dubbs <bdubbs@…>, 7 months ago

Update to libdrm-2.4.117.
  • Property mode set to 100644
File size: 22.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 qt5-major "5.15">
8 <!ENTITY qt5-url "https://download.qt.io/archive/qt/&qt5-major;/&qt5-version;/single">
9
10 <!ENTITY qt5-download-http "&qt5-url;/qt-everywhere-opensource-src-&qt5-version;.tar.xz">
11 <!ENTITY qt5-download-ftp " ">
12 <!ENTITY qt5-md5sum "37b79a3764b0c9157fa3686df209b25a">
13 <!ENTITY qt5-size "630 MB">
14 <!ENTITY qt5-buildsize "8.6 GB (153 MB installed)">
15 <!ENTITY qt5-time "4.8 SBU (using parallelism=8)">
16]>
17
18<sect1 id="qt5-alternate" xreflabel="qt-alternate-&qt5-version;">
19 <?dbhtml filename="qt5-alternate.html" ?>
20
21 <title>qt-alternate-&qt5-version;</title>
22
23 <indexterm zone="qt5">
24 <primary sortas="a-Qt">Qt</primary>
25 </indexterm>
26
27 <sect2 role="package">
28 <title>Introduction to qt5 (alternate)</title>
29
30 <para>
31 <application>Qt5</application> is a cross-platform application framework
32 that is widely used for developing application software with a graphical
33 user interface (GUI) (in which cases <application>qt5</application> is
34 classified as a widget toolkit), and also used for developing non-GUI
35 programs such as command-line tools and consoles for servers. Two of the
36 major users of <application>qt</application> are <application>KDE
37 Frameworks 5 (KF5)</application> and <application>LXQt</application>.
38 </para>
39
40 <important>
41 <para>
42 The full <application>qt5</application> package consists of 43 separate
43 components. These instructions use a small subset of the full
44 <application>qt5</application> installation instructions above.
45 They cover most, but not all, of the components needed to build
46 packages in BLFS. This page, and the next, are provided to
47 reduce the amount of time, space, and dependencies needed
48 to build these packages. They are not recommended if you will build
49 the <xref linkend="kf5-frameworks"/> based <xref linkend="plasma5-build"/> desktop
50 environment.
51 </para>
52 </important>
53
54 &lfs120_checked;
55
56 <bridgehead renderas="sect3">Package Information</bridgehead>
57 <itemizedlist spacing="compact">
58 <listitem>
59 <para>
60 Download (HTTP): <ulink url="&qt5-download-http;"/>
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download (FTP): <ulink url="&qt5-download-ftp;"/>
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Download MD5 sum: &qt5-md5sum;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Download size: &qt5-size;
76 </para>
77 </listitem>
78 <listitem>
79 <para>
80 Estimated disk space required: &qt5-buildsize;
81 </para>
82 </listitem>
83 <listitem>
84 <para>
85 Estimated build time: &qt5-time;
86 </para>
87 </listitem>
88 </itemizedlist>
89
90 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
91 <itemizedlist spacing="compact">
92 <listitem>
93 <para>
94 Now that <application>qt5</application> updates are restricted to
95 commercial customers, upstream patches for the various modules are
96 being curated at kde.
97 Patches for the modules required by packages in BLFS have been
98 aggregated for the non-modular qt5 build we use.
99 </para>
100 <para>
101 Required patch:
102 <ulink url="&patch-root;/qt-everywhere-opensource-src-&qt5-version;-kf5-1.patch"/>
103 </para>
104 <para>
105 Details of the kde curation can be found at
106 <ulink url="https://dot.kde.org/2021/04/06/announcing-kdes-qt-5-patch-collection"/>
107 and <ulink url="https://community.kde.org/Qt5PatchCollection"/>.
108 </para>
109 </listitem>
110 </itemizedlist>
111
112 <bridgehead renderas="sect3">qt5 Dependencies</bridgehead>
113
114 <bridgehead renderas="sect4">Required</bridgehead>
115 <para role="required">
116 <xref linkend="xorg7-lib"/>
117 </para>
118
119 <bridgehead renderas="sect4">Recommended</bridgehead>
120 <para role="recommended">
121 <xref linkend="alsa-lib"/>,
122 <xref linkend="cups"/>,
123 <phrase revision='sysv'><xref linkend="dbus"/>,</phrase>
124 <xref linkend="double-conversion"/>,
125 <xref linkend="glib2"/>,
126 <xref linkend="harfbuzz"/>,
127 <xref linkend="icu"/>,
128 <xref linkend="hicolor-icon-theme"/>,
129 <xref linkend="mesa"/>,
130 <xref linkend="libjpeg"/>,
131 <xref linkend="libxkbcommon"/>,
132 <xref linkend="sqlite"/>,
133 <xref linkend="wayland"/> (<application>Mesa</application>
134 must be built with <application>Wayland</application> EGL
135 backend),
136 <xref linkend="xcb-util-image"/>,
137 <xref linkend="xcb-util-keysyms"/>,
138 <xref linkend="xcb-util-renderutil"/>, and
139 <xref linkend="xcb-util-wm"/>
140 </para>
141
142 <bridgehead renderas="sect4">Optional</bridgehead>
143 <para role="optional">
144 <xref linkend="gtk3"/>,
145 <xref linkend="libinput"/>
146 <xref linkend="mariadb"/>
147 or <ulink url="https://www.mysql.com/">MySQL</ulink>,
148 <xref linkend="mitkrb"/>,
149 <xref linkend="mtdev"/>
150 <xref linkend="postgresql"/>, and
151 <xref linkend="unixodbc"/>
152 </para>
153
154 <para condition="html" role="usernotes">
155 Editor Notes: <ulink url="&blfs-wiki;/qt5"/>
156 </para>
157
158 </sect2>
159
160 <sect2 role="qt5-prefix">
161 <title>Setting the installation prefix</title>
162
163 <bridgehead renderas="sect3">Installing in /opt/qt5</bridgehead>
164
165 <para>
166 The BLFS editors recommend installing <application>qt5</application> in a
167 directory other than <filename class="directory">/usr</filename>, i.e.
168 <filename class="directory">/opt/qt5</filename>. To do this, set the
169 following environment variable:
170 </para>
171
172<screen><userinput>export QT5PREFIX=/opt/qt5</userinput></screen>
173
174 <tip>
175 <para>
176 Sometimes, the installation paths are hardcoded into installed files.
177 This is the reason why <filename class="directory">/opt/qt5</filename>
178 is used as installation prefix instead of <filename
179 class="directory">/opt/qt-&qt5-version;</filename>. To create a
180 versioned <application>qt5</application> directory after the
181 installation is complete, you may rename the directory and create a symlink:
182 </para>
183
184<screen role="root"><userinput>mkdir -pv /opt/qt-&qt5-version;
185ln -sfnv qt-&qt5-version; /opt/qt5</userinput></screen>
186
187 <para>
188 Later on, you may want to install other versions of
189 <application>qt5</application>. To do that, just remove the symlink
190 and use <filename class="directory">/opt/qt5</filename> as the
191 prefix again. Which version of <application>qt5</application> you
192 use depends only on where the symlink points.
193 </para>
194 </tip>
195
196 </sect2>
197
198 <sect2 role="installation">
199 <title>Installation of qt5</title>
200
201 <warning>
202 <para>
203 If <application>qt5</application> is being reinstalled into the
204 same directory as an existing instance, run the commands done by
205 <systemitem class="username">root</systemitem>, such as
206 <command>make install</command>, from a console or non-qt5 based
207 window manager. It overwrites <application>qt5</application>
208 libraries that should not be in use during the install process.
209 </para>
210 </warning>
211
212 <caution>
213 <para>
214 If you did not install some of the recommended dependencies, examine
215 <command>./configure --help</command> output to check how to disable
216 them or use internal versions bundled in the source tarball.
217 </para>
218 </caution>
219
220 <note>
221 <para>
222 The BLFS editors do not recommend installing <application>qt5</application>
223 into the /usr hierarchy because it becomes difficult to find
224 components and to update to a new version. If you do want to install
225 <application>qt5</application> in /usr, the directories need to
226 be specified explicitly. In this case, set QT5PREFIX=/usr and add
227 the following to the configure arguments below:
228 </para>
229
230<screen role="nodump"><userinput> -archdatadir /usr/lib/qt5 \
231 -bindir /usr/bin \
232 -plugindir /usr/lib/qt5/plugins \
233 -importdir /usr/lib/qt5/imports \
234 -headerdir /usr/include/qt5 \
235 -datadir /usr/share/qt5 \
236 -docdir /usr/share/doc/qt5 \
237 -translationdir /usr/share/qt5/translations \
238 -examplesdir /usr/share/doc/qt5/examples</userinput></screen>
239 </note>
240
241 <para>
242 The libxkbcommon-1.6.0 package removes some definitions that are not
243 used. Remove those here also:
244 </para>
245
246 <screen><userinput>sed -i '276,279d' qtbase/src/platformsupport/input/xkbcommon/qxkbcommon.cpp</userinput></screen>
247
248 <para>
249 Now apply a patch to pull in the fixes curated by kde for those
250 modules which are required by packages mentioned in this book:
251 </para>
252
253<screen><userinput remap="pre">patch -Np1 -i ../qt-everywhere-opensource-src-&qt5-version;-kf5-1.patch</userinput></screen>
254
255 <para>
256 The patch is supposed to be used in a git repository. Otherwise some
257 files that should be modified by <command>configure</command> after
258 applying the patch are not touched. Fortunately, it is enough to create a
259 <filename class="directory">.git</filename> directory in the
260 <filename class="directory">qmake</filename> directory where the
261 <command>configure</command> script is run:
262 </para>
263
264 <screen><userinput remap="pre">mkdir -pv qtbase/.git</userinput></screen>
265
266 <para>
267 At this point we want to set up skipping most components. Do that with:
268 </para>
269
270<screen><userinput>ls -Fd qt* | grep / | sed 's/^/-skip /;s@/@@' > tempconf &amp;&amp;
271sed -i -r '/base|tools|x11extras|svg|declarative|wayland/d' tempconf</userinput></screen>
272
273 <para>
274 Now, install <application>qt5</application> by running the following commands:
275 </para>
276
277<screen revision="sysv"><userinput>./configure -prefix $QT5PREFIX \
278 -sysconfdir /etc/xdg \
279 -confirm-license \
280 -opensource \
281 -dbus-linked \
282 -openssl-linked \
283 -system-harfbuzz \
284 -system-sqlite \
285 -nomake examples \
286 -no-rpath \
287 -syslog \
288 $(cat tempconf) \
289 &amp;&amp;
290make</userinput></screen>
291
292<screen revision="systemd"><userinput>./configure -prefix $QT5PREFIX \
293 -sysconfdir /etc/xdg \
294 -confirm-license \
295 -opensource \
296 -dbus-linked \
297 -openssl-linked \
298 -system-harfbuzz \
299 -system-sqlite \
300 -nomake examples \
301 -no-rpath \
302 -journald \
303 $(cat tempconf) \
304 &amp;&amp;
305make</userinput></screen>
306
307 <para>
308 This package does not come with a test suite.
309 </para>
310
311 <para>
312 Now, as the <systemitem class="username">root</systemitem> user:
313 </para>
314
315<screen role="root"><userinput>make install</userinput></screen>
316
317 <!-- EDITORS NOTE: This package uses INSTALL_ROOT= instead of DESTDIR= for
318 installing in a temporary directory. -->
319
320 <para>
321 Remove references to the build directory from installed library
322 dependency (prl) <!--and profile include (pri)--> files by running the following
323 command as the <systemitem class="username">root</systemitem> user:
324 </para>
325
326<screen role="root"><userinput>find $QT5PREFIX/ -name \*.prl \
327 -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;</userinput></screen>
328
329 <para>
330 Install images and create the menu entries for installed applications.
331 The <envar>QT5BINDIR</envar> variable is used here to point to the
332 directory for the executable programs. If you have changed the bindir
333 above, <envar>QT5BINDIR</envar> will need to be adjusted below. Be sure
334 that the <envar>QT5BINDIR</envar> variable is defined in root's
335 environment and as the <systemitem class="username">root</systemitem>
336 user:
337 </para>
338
339<screen role="root"><userinput>QT5BINDIR=$QT5PREFIX/bin
340
341install -v -dm755 /usr/share/pixmaps/ &amp;&amp;
342
343install -v -Dm644 qttools/src/assistant/assistant/images/assistant-128.png \
344 /usr/share/pixmaps/assistant-qt5.png &amp;&amp;
345
346install -v -Dm644 qttools/src/designer/src/designer/images/designer.png \
347 /usr/share/pixmaps/designer-qt5.png &amp;&amp;
348
349install -v -Dm644 qttools/src/linguist/linguist/images/icons/linguist-128-32.png \
350 /usr/share/pixmaps/linguist-qt5.png &amp;&amp;
351
352install -v -Dm644 qttools/src/qdbus/qdbusviewer/images/qdbusviewer-128.png \
353 /usr/share/pixmaps/qdbusviewer-qt5.png &amp;&amp;
354
355install -dm755 /usr/share/applications &amp;&amp;
356
357cat &gt; /usr/share/applications/assistant-qt5.desktop &lt;&lt; EOF
358<literal>[Desktop Entry]
359Name=Qt5 Assistant
360Comment=Shows Qt5 documentation and examples
361Exec=$QT5BINDIR/assistant
362Icon=assistant-qt5.png
363Terminal=false
364Encoding=UTF-8
365Type=Application
366Categories=Qt;Development;Documentation;</literal>
367EOF
368
369cat &gt; /usr/share/applications/designer-qt5.desktop &lt;&lt; EOF
370<literal>[Desktop Entry]
371Name=Qt5 Designer
372GenericName=Interface Designer
373Comment=Design GUIs for Qt5 applications
374Exec=$QT5BINDIR/designer
375Icon=designer-qt5.png
376MimeType=application/x-designer;
377Terminal=false
378Encoding=UTF-8
379Type=Application
380Categories=Qt;Development;</literal>
381EOF
382
383cat &gt; /usr/share/applications/linguist-qt5.desktop &lt;&lt; EOF
384<literal>[Desktop Entry]
385Name=Qt5 Linguist
386Comment=Add translations to Qt5 applications
387Exec=$QT5BINDIR/linguist
388Icon=linguist-qt5.png
389MimeType=text/vnd.trolltech.linguist;application/x-linguist;
390Terminal=false
391Encoding=UTF-8
392Type=Application
393Categories=Qt;Development;</literal>
394EOF
395
396cat &gt; /usr/share/applications/qdbusviewer-qt5.desktop &lt;&lt; EOF
397<literal>[Desktop Entry]
398Name=Qt5 QDbusViewer
399GenericName=D-Bus Debugger
400Comment=Debug D-Bus applications
401Exec=$QT5BINDIR/qdbusviewer
402Icon=qdbusviewer-qt5.png
403Terminal=false
404Encoding=UTF-8
405Type=Application
406Categories=Qt;Development;Debugger;</literal>
407EOF</userinput></screen>
408
409 <para>
410 Some packages such as <xref linkend='vlc'/> look for certain
411 executables with a -qt5 suffix. Run the following command as the
412 <systemitem class="username">root</systemitem> user
413 to create the necessary symlinks:
414 </para>
415
416<screen role="root"><userinput>for file in moc uic rcc qmake lconvert lrelease lupdate; do
417 ln -sfvn $QT5BINDIR/$file /usr/bin/$file-qt5
418done</userinput></screen>
419
420 </sect2>
421
422 <sect2 role="commands">
423 <title>Command Explanations</title>
424
425 <para>
426 <parameter>-confirm-license</parameter>: Accept license
427 without prompting user during configuration.
428 </para>
429
430 <para>
431 <parameter>-opensource</parameter>: Install the opensource
432 version of <application>qt</application>.
433 </para>
434
435 <para>
436 <parameter>-nomake examples</parameter>: This switch
437 disables building of the example programs included
438 in the source tarball. Remove it if you want to build
439 them.
440 </para>
441
442 <para>
443 <parameter>-system-sqlite</parameter>: This switch enables use
444 of the system version of <application>SQLite</application>.
445 </para>
446
447 <para>
448 <parameter>-system-harfbuzz</parameter>: This switch enables use
449 of the system version of <application>Harfbuzz</application>.
450 </para>
451
452 <para>
453 <parameter>-dbus-linked -openssl-linked</parameter>: These
454 switches enable explicit linking of the
455 <application>D-Bus</application> and
456 <application>OpenSSL</application> libraries into
457 <application>qt5</application> libraries instead of
458 <command>dlopen()</command>-ing them.
459 </para>
460
461 <para revision="sysv">
462 <parameter>-syslog</parameter>: This switch allows to send qt messages
463 to the <command>syslog</command> logging system.
464 </para>
465
466 <para revision="systemd">
467 <parameter>-journald</parameter>: This switch allows to send qt messages
468 to the <command>journald</command> logging system.
469 </para>
470
471 <para>
472 <command>$(cat tempconf)</command>: This command provides a list of
473 components that should not be built. These entries are in the form of
474 "-skip &lt;component&gt;".
475 </para>
476
477 </sect2>
478
479 <sect2 role="configuration">
480 <title>Configuring qt5</title>
481
482 <sect3 id="qt5-alt-config">
483 <title>Configuration Information</title>
484
485 <para>
486 If <xref linkend="sudo"/> is installed, QT5DIR should be available to
487 the super user as well. Execute the following commands as the
488 <systemitem class="username">root</systemitem> user:
489 </para>
490
491<screen role="root"><userinput>cat &gt; /etc/sudoers.d/qt &lt;&lt; "EOF"
492<literal>Defaults env_keep += QT5DIR</literal>
493EOF</userinput></screen>
494
495 <bridgehead renderas="sect4">If you installed qt5 in /usr</bridgehead>
496
497 <para>
498 If you installed <application>qt5</application> in
499 <filename class="directory">/usr</filename>, create an
500 environment variable needed by certain packages.
501 As the <systemitem class="username">root</systemitem> user:
502 </para>
503
504<screen role="nodump"><userinput>cat &gt; /etc/profile.d/qt5.sh &lt;&lt; "EOF"
505<literal># Begin /etc/profile.d/qt5.sh
506
507QT5DIR=/usr
508export QT5DIR
509
510# End /etc/profile.d/qt5.sh</literal>
511EOF</userinput></screen>
512
513 <bridgehead renderas="sect4">If you did not install qt5 in /usr</bridgehead>
514
515 <para>
516 If you installed <application>qt5</application> in a location other
517 than <filename class="directory">/usr</filename>, you need to update the
518 following configuration files so that <application>qt5</application> is
519 correctly found by other packages and system processes.
520 </para>
521
522 <para>
523 As the <systemitem class="username">root</systemitem> user, update
524 the <filename>/etc/ld.so.conf</filename> file and the dynamic linker's
525 run-time cache file:
526 </para>
527
528<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; EOF
529<literal># Begin Qt addition
530
531/opt/qt5/lib
532
533# End Qt addition</literal>
534EOF
535
536ldconfig</userinput></screen>
537
538 <indexterm zone="qt5 qt5-config">
539 <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
540 </indexterm>
541
542 <para>
543 As the <systemitem class="username">root</systemitem> user, create
544 the <filename>/etc/profile.d/qt5.sh</filename> file:
545 </para>
546
547<screen role="root"><userinput>cat &gt; /etc/profile.d/qt5.sh &lt;&lt; "EOF"
548<literal># Begin /etc/profile.d/qt5.sh
549
550QT5DIR=/opt/qt5
551
552pathappend $QT5DIR/bin PATH
553pathappend $QT5DIR/lib/pkgconfig PKG_CONFIG_PATH
554
555export QT5DIR
556
557# End /etc/profile.d/qt5.sh</literal>
558EOF</userinput></screen>
559
560 </sect3>
561
562 </sect2>
563
564 <sect2 role="content">
565 <title>Contents</title>
566
567 <segmentedlist>
568 <segtitle>Installed Programs</segtitle>
569 <segtitle>Installed Libraries</segtitle>
570 <segtitle>Installed Directories</segtitle>
571
572 <seglistitem>
573 <seg>
574 assistant, designer, fixqt4headers.pl, lconvert,
575 linguist, lprodump, lrelease, lrelease-pro, lupdate, lupdate-pro,
576 moc, pixeltool, qcollectiongenerator, qdbus, qdbuscpp2xml,
577 qdbusviewer, qdbusxml2cpp, qdistancefieldgenerator, qdoc,
578 qhelpgenerator, qlalr, qmake, qml, qmlcachegen, qmleasing,
579 qmlformat, qmlimportscanner, qmllint, qmlmin, qmlplugindump,
580 qmlpreview, qmlprofiler, qmlscene, qmltestrunner, qmltime,
581 qmltyperegistrar,
582 qtattributionscanner, qtdiag, qtpaths, qtplugininfo,
583 qtwaylandscanner, qvkgen, rcc, syncqt.pl, tracegen, and
584 uic
585 </seg>
586 <seg>
587 libQt5AccessibilitySupport.a,
588 libQt5Bootstrap.a,
589 libQt5Concurrent.so,
590 libQt5Core.so,
591 libQt5DBus.so,
592 libQt5Designer.so,
593 libQt5DesignerComponents.so,
594 libQt5DeviceDiscoverySupport.a,
595 libQt5EdidSupport.a,
596 libQt5EglFSDeviceIntegration.so,
597 libQt5EglFsKmsSupport.so,
598 libQt5EglSupport.a,
599 libQt5EventDispatcherSupport.a,
600 libQt5FbSupport.a,
601 libQt5FontDatabaseSupport.a,
602 libQt5GlxSupport.a,
603 libQt5Gui.so,
604 libQt5Help.so,
605 libQt5InputSupport.a,
606 libQt5KmsSupport.a,
607 libQt5LinuxAccessibilitySupport.a,
608 libQt5Network.so,
609 libQt5OpenGL.so,
610 libQt5OpenGLExtensions.a,
611 libQt5PacketProtocol.a,
612 libQt5PlatformCompositorSupport.a,
613 libQt5PrintSupport.so,
614 libQt5Qml.so,
615 libQt5QmlDebug.a,
616 libQt5QmlDevTools.a,
617 libQt5QmlModels.so,
618 libQt5QmlWorkerScript.so,
619 libQt5Quick.so,
620 libQt5QuickParticles.so,
621 libQt5QuickShapes.so,
622 libQt5QuickTest.so,
623 libQt5QuickWidgets.so,
624 libQt5ServiceSupport.a,
625 libQt5Sql.so,
626 libQt5Svg.so,
627 libQt5Test.so,
628 libQt5ThemeSupport.a,
629 libQt5UiTools.a,
630 libQt5WaylandClient.so,
631 libQt5WaylandCompositor.so,
632 libQt5Widgets.so,
633 libQt5X11Extras.so,
634 libQt5XcbQpa.so,
635 libQt5XkbCommonSupport.a,
636 libQt5Xml.so,
637 and several plugins under /opt/qt5/{plugins,qml}
638 </seg>
639 <seg>
640 /usr/include/qt5,
641 /usr/lib/qt5,
642 /usr/share/doc/qt5, and
643 /usr/share/qt5
644 OR
645 /opt/qt5 and
646 /opt/qt-&qt5-version;
647 </seg>
648 </seglistitem>
649 </segmentedlist>
650
651 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
652 <para>See <xref linkend="qt5-descriptions"/></para>
653
654 </sect2>
655
656</sect1>
Note: See TracBrowser for help on using the repository browser.