Changeset 1b0d0188 for x/lib/qt5.xml

Timestamp:

06/24/2015 09:55:25 PM (9 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

8e6f4f8

Parents:

233a4949

Message:

Update qt4 and qt5 instructions
Prep for KF5
Temove some tab characters

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16163 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• x/lib/qt5.xml (modified) (14 diffs)

x/lib/qt5.xml

@@ -4 +4 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
-
-  <!-- Change for new minor releases !!! -->
 
   <!ENTITY qt5-major "5.4">
@@ -36 +34 @@
 
     <para>
-      <application>Qt5</application> is a cross-platform application
-      framework that is widely used for developing application software
-      with a graphical user interface (GUI) (in which cases
-      <application>Qt5</application> is classified as a widget toolkit), and
-      also used for developing non-GUI programs such as command-line tools
-      and consoles for servers. 
+      <application>Qt5</application> is a cross-platform application framework
+      that is widely used for developing application software with a graphical
+      user interface (GUI) (in which cases <application>Qt5</application> is
+      classified as a widget toolkit), and also used for developing non-GUI
+      programs such as command-line tools and consoles for servers. One of the
+      major users of <application>Qt</application> is <application>KDE
+      Frameworks 5 (KF5)</application>.
     </para>
 
@@ -139 +138 @@
     <title>Setting the installation prefix</title>
 
-    <bridgehead renderas="sect3">Installing in /usr</bridgehead>
-
-    <para>
-      If you want to install <application>Qt5</application>
-      in <filename class="directory">/usr</filename>, set the
+    <bridgehead renderas="sect3">Installing in /opt/qt5</bridgehead>
+
+    <para>
+      The BLFS editors recommend installing <application>Qt5</application> in a
+      directory other than <filename class="directory">/usr</filename>, ie
+      <filename class="directory">/opt/qt5</filename>.  To do this,  set the 
       following environment variable:
-    </para>
-
-<screen><userinput>export QT5PREFIX=/usr</userinput></screen>
-
-    <bridgehead renderas="sect3">Installing in /opt/qt5</bridgehead>
-
-    <para>
-      If you want to install <application>Qt5</application> in a directory
-      other than <filename class="directory">/usr</filename>, ie <filename
-      class="directory">/opt/qt4</filename>, set the following environment
-      variable:
     </para>
 
@@ -175 +164 @@
       <para>
         Later on, you may want to install other versions of
-        <application>Qt4</application>. To do that, just remove the symlink
+        <application>Qt5</application>. To do that, just remove the symlink
         and use <filename class="directory">/opt/qt5</filename> as the
         prefix again. Which version of <application>Qt5</application> you
@@ -186 +175 @@
   <sect2 role="installation">
     <title>Installation of Qt5</title>
-
-    <caution>
-      <para>
-        If you did not install some of the recommended dependencies, examine
-        <command>./configure --help</command> output to check how to disable
-        them or use internal versions bundled in the source tarball.
-      </para>
-    </caution>
 
     <warning>
@@ -206 +187 @@
     </warning>
 
-    <para>
-      Install <application>Qt5</application> by running the
-      following commands:
-    </para>
-
-<screen><userinput>./configure -prefix         $QT5PREFIX                        \
-            -sysconfdir     /etc/xdg                          \
-            -bindir         $QT5BINDIR                        \
-            -headerdir      $QT5PREFIX/include/qt5            \
-            -archdatadir    $QT5PREFIX/lib/qt5                \
-            -datadir        $QT5PREFIX/share/qt5              \
-            -docdir         $QT5PREFIX/share/doc/qt5          \
-            -translationdir $QT5PREFIX/share/qt5/translations \
-            -examplesdir    $QT5PREFIX/share/doc/qt5/examples \
-            -confirm-license  \
-            -opensource       \
-            -dbus-linked      \
-            -openssl-linked   \
-            -journald         \
-            -system-harfbuzz  \
-            -system-sqlite    \
-            -nomake examples  \
-            -no-rpath         \
-            -optimized-qmake  \
-            -skip qtwebengine &amp;&amp;
+    <caution>
+      <para>
+        If you did not install some of the recommended dependencies, examine
+        <command>./configure --help</command> output to check how to disable
+        them or use internal versions bundled in the source tarball.
+      </para>
+    </caution>
+
+    <note>
+      <para>
+        The build time and space required for the full
+        <application>Qt5</application> is quite long. The instructions below
+        do not build the tutorials and examples. Removing the
+        <parameter>-nomake</parameter> line will create a complete build.
+      </para>
+    </note>
+
+    <note>
+      <para>
+        The BLFS editors do not recommend installing <application>Qt5</application>
+        into the /usr hierarchy because it becomes difficult to find
+        components and to update to a new version.  If you do want to install
+        <application>Qt5</application> in /usr, the directories need to
+        be specified explicitly.  In this case, set QT5PREFIX=/usr and add
+        the following to the configure arguments below:</para>
+
+        <screen><userinput>-bindir         /usr/bin/qt4                \
+-plugindir      /usr/lib/qt5/plugins        \
+-importdir      /usr/lib/qt5/imports        \
+-headerdir      /usr/include/qt5            \
+-datadir        /usr/share/qt5              \
+-docdir         /usr/share/doc/qt5          \
+-translationdir /usr/share/qt5/translations \
+-demosdir       /usr/share/doc/qt5/demos    \
+-examplesdir    /usr/share/doc/qt5/examples </userinput></screen>
+    </note>
+
+    <para>
+      Install <application>Qt5</application> by running the following commands:
+    </para>
+
+<screen><userinput>./configure -prefix         $QT5PREFIX \
+            -sysconfdir     /etc/xdg   \
+            -confirm-license           \
+            -opensource                \
+            -dbus-linked               \
+            -openssl-linked            \
+            -journald                  \
+            -system-harfbuzz           \
+            -system-sqlite             \
+            -nomake examples           \
+            -no-rpath                  \
+            -optimized-qmake           \
+            -skip qtwebengine          &amp;&amp;
 
 make</userinput></screen>
@@ -239 +249 @@
 
     <para>
-      Remove references to the build directory from the
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root"><userinput>make install</userinput></screen>
+
+    <para>
+      Remove references to the build directory from the installed
       <filename class="extension">.pc</filename> files by running
       the following command:
     </para>
 
-<screen><userinput>find . -name "*.pc" -exec perl -pi -e "s, -L$PWD/?\S+,,g" {} \;</userinput></screen>
-
-    <para>
-      Now, as the <systemitem class="username">root</systemitem> user:
-    </para>
-
-<screen role="root"><userinput>make install</userinput></screen>
-
-    <para>
-      Remove references to the build directory from installed files by
-      running the following commands as the
-      <systemitem class="username">root</systemitem> user:
+<screen><userinput>find $QT5PREFIX/lib/pkgconfig -name "*.pc" -exec perl -pi -e "s, -L$PWD/?\S+,,g" {} \;</userinput></screen>
+
+    <para>
+      Remove references to the build directory from installed library dependency
+      (prl) and profile include (pri) files by running the following commands as 
+      the <systemitem class="username">root</systemitem> user:
     </para>
 
 <screen role="root"><userinput>sed -e "s:$PWD/qtbase:/usr/lib/qt5:g" \
-    -i /usr/lib/qt5/mkspecs/modules/qt_lib_bootstrap_private.pri &amp;&amp;
-
-find /usr/lib/lib{qgsttools_p,Qt5*}.prl -exec sed -i -r \
+    -i $QT5PREFIX/lib/qt5/mkspecs/modules/qt_lib_bootstrap_private.pri &amp;&amp;
+
+find $QT5PREFIX/lib/lib{qgsttools_p,Qt5*}.prl -exec sed -i -r \
      '/^QMAKE_PRL_BUILD_DIR/d;s/(QMAKE_PRL_LIBS =).*/\1/' {} \;</userinput></screen>
 
     <para>
-      Install images and create the menu entries
-      for installed applications.  Be sure that the <envar>QT5PREFIX</envar>
-      variable is defined in root's environment and
-      as the <systemitem class="username">root</systemitem> user:
-    </para>
-
-<screen role="root"><userinput>install -v -dm755 /usr/share/pixmaps/                  &amp;&amp;
+      Install images and create the menu entries for installed applications.
+      The <envar>QT4BINDIR</envar> variable is used here to point to the
+      directory for the executable programs.  If you have changed the bindir
+      above, <envar>QT4BINDIR</envar> will need to be adjusted below.  Be sure
+      that the <envar>QT5BINDIR</envar> variable is defined in root's
+      environment and as the <systemitem class="username">root</systemitem>
+      user:
+    </para>
+
+<screen role="root"><userinput>QT5BINDIR=$QT5PREFIX/bin
+
+install -v -dm755 /usr/share/pixmaps/                  &amp;&amp;
 
 install -v -Dm644 qttools/src/assistant/assistant/images/assistant-128.png \
@@ -291 +306 @@
 Name=Qt5 Assistant 
 Comment=Shows Qt5 documentation and examples
-Exec=$QT5PREFIX/bin/assistant
+Exec=$QT5BINDIR/assistant
 Icon=assistant-qt5.png
 Terminal=false
@@ -304 +319 @@
 GenericName=Interface Designer
 Comment=Design GUIs for Qt5 applications
-Exec=$QT5PREFIX/bin/designer
+Exec=$QT5BINDIR/designer
 Icon=designer-qt5.png
 MimeType=application/x-designer;
@@ -317 +332 @@
 Name=Qt5 Linguist
 Comment=Add translations to Qt5 applications
-Exec=$QT5PREFIX/bin/linguist
+Exec=$QT5BINDOR/linguist
 Icon=linguist-qt5.png
 MimeType=text/vnd.trolltech.linguist;application/x-linguist;
@@ -331 +346 @@
 GenericName=D-Bus Debugger
 Comment=Debug D-Bus applications
-Exec=$QT5PREFIX/bin/qdbusviewer
+Exec=$QT5BINDIR/qdbusviewer
 Icon=qdbusviewer-qt5.png
 Terminal=false
@@ -339 +354 @@
 EOF</userinput></screen>
 
+    <para>Some packages such as <xref linkend='vlc'/> look for certain
+    executables with a -qt5 suffix.  Run the following command as the root user
+    to create the necessary symlinks:</para>
+
+<screen role="root"><userinput>for file in moc uic rcc qmake lconvert lrelease lupdate; do
+  ln -sfrvn $QT5BINDIR/$file /usr/bin/$file-qt5
+done</userinput></screen>
+
   </sect2>
 
@@ -362 +385 @@
       <parameter>-nomake examples</parameter>: This switch
       disables building of the example programs included
-      in the source tarball. Remove it if you want to build
-      them.
-    </para>
-
-    <para>
-      <parameter>-nomake tests</parameter>: This switch
-      disables building of the test programs included
       in the source tarball. Remove it if you want to build
       them.
@@ -474 +490 @@
 QT5DIR=/opt/qt5
 
-pathappend /opt/qt5/bin           PATH
-pathappend /opt/qt5/lib/pkgconfig PKG_CONFIG_PATH
+pathappend $QT5DIR/bin           PATH
+pathappend $QT5DIR/lib/pkgconfig PKG_CONFIG_PATH
 
 export QT5DIR