source: x/lib/qt5.xml@ a4564466

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;


  <!ENTITY qt5-download-http "&qt5-url;/">
  <!ENTITY qt5-download-ftp  " ">
  <!ENTITY qt5-md5sum        "See below">
  <!ENTITY qt5-size          "59 MB">
  <!ENTITY qt5-buildsize     "14 GB (255 MB installed)">
  <!ENTITY qt5-time          "22 SBU (using parallelism=4)">
]>

<sect1 id="qt5" xreflabel="Qt-&qt5-version;">
  <?dbhtml filename="qt5.html" ?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>Qt-&qt5-version; Modules</title>

  <indexterm zone="qt5">
    <primary sortas="a-Qt">Qt Modules</primary>
  </indexterm>

  <para>
    After the <xref linkend="qtbase"/> has been installed, various modules
    can be added to provide more functionalities. They are divided in several
    groups, each of which depend on the precedent:
  </para>

  <itemizedlist spacing="compact">
    <listitem>
      <para>
        <xref linkend="qt-basic"/> are used in almost all
        <application>Qt5</application> based applications, and
        must be built first.
      </para>
    </listitem>
    <listitem>
      <para>
        The <xref linkend="qt-kde"/> are needed for
        <xref linkend="kf5-frameworks"/> and <xref linkend="plasma5-build"/>.
      </para>
    </listitem>
    <listitem>
      <para>
        The huge <xref linkend="qtwebengine"/> integrates
        <application>chromium</application>'s web capabilities into
        <application>Qt5</application>
      </para>
    </listitem>
    <listitem>
      <para>
        <xref linkend="qt-miscellaneous"/> are not needed for building
        packages in the book, but can be built for a complete installation
        of <application>Qt5</application>
      </para>
    </listitem>
  </itemizedlist>

  &lfs10_checked;

  <bridgehead renderas="sect3">Package Information</bridgehead>
  <itemizedlist spacing="compact">
    <listitem>
      <para>
        Download (HTTP): <ulink url="&qt5-download-http;"/>
      </para>
    </listitem>
    <listitem>
      <para>
        Download (FTP): <ulink url="&qt5-download-ftp;"/>
      </para>
    </listitem>
    <listitem>
      <para>
        Download MD5 sum: &qt5-md5sum;
      </para>
    </listitem>
    <listitem>
      <para>
        Download size: &qt5-size;
      </para>
    </listitem>
    <listitem>
      <para>
        Estimated disk space required: &qt5-buildsize;
      </para>
    </listitem>
    <listitem>
      <para>
        Estimated build time: &qt5-time;
      </para>
    </listitem>
  </itemizedlist>
<!--
  <bridgehead renderas="sect3">Qt5 Dependencies</bridgehead>

  <bridgehead renderas="sect4">Required</bridgehead>
  <para role="required">
    <xref linkend="xorg7-lib"/>
  </para>

  <bridgehead renderas="sect4">Recommended</bridgehead>
  <para role="recommended">
    <xref linkend="alsa-lib"/>,
    <xref linkend="make-ca"/>,
    <xref linkend="cups"/>,
    <xref linkend="glib2"/>,
    <xref linkend="gst10-plugins-base"/> (QtMultimedia backend),
    <xref linkend="harfbuzz"/>,
    <xref linkend="icu"/>,
    <xref linkend="jasper"/>,
    <xref linkend="libjpeg"/>,
    <xref linkend="libmng"/>,
    <xref linkend="libpng"/>,
    <xref linkend="libtiff"/>,
    <xref linkend="libwebp"/>,
    <xref linkend="libxkbcommon"/>,
    <xref linkend="mesa"/>,
    <xref linkend="mitkrb"/>,
    <xref linkend="mtdev"/>,
    <xref linkend="pcre2"/>,
    <xref linkend="sqlite"/>,
    <xref linkend="wayland"/> (<application>Mesa</application>
    must be built with <application>Wayland</application> EGL
    backend),
    <xref linkend="xcb-util-image"/>,
    <xref linkend="xcb-util-keysyms"/>,
    <xref linkend="xcb-util-renderutil"/>, and
    <xref linkend="xcb-util-wm"/>
  </para>

  <bridgehead renderas="sect4">Optional</bridgehead>
  <para role="optional">
    <xref role="runtime" linkend="bluez"/> (for sdpscanner, and at runtime for
    QtConnectivity module),
    <xref linkend="ibus"/>,
    <xref linkend="libinput"/>, <!- - needs -libinput switch - ->
    <xref linkend="mariadb"/>
      or <ulink url="http://www.mysql.com/">MySQL</ulink>,
    <xref linkend="pciutils"/> (required for QtWebEngine),
    <xref linkend="postgresql"/>,
    <xref linkend="python2"/> (required for QtWebEngine),
    <xref linkend="pulseaudio"/>,
    <xref linkend="sdl2"/>,
    <xref linkend="unixodbc"/>,
    <ulink url="https://www.assimp.org/">assimp</ulink>,
    <ulink url="http://www.festvox.org/flite/">Flite</ulink>,
    <ulink url="http://www.firebirdsql.org/">Firebird</ulink>, 
    <ulink url="http://www.freetds.org/">FreeTDS</ulink>,
    <ulink url="https://libproxy.github.io/libproxy/">libproxy</ulink>,
    <ulink url="https://openal.org/">OpenAL</ulink>,
    <ulink url="https://freebsoft.org/speechd/">speech-dispatcher</ulink>,
    <ulink url="http:///www.tslib.org/">tslib</ulink>, and
    <ulink url="https://vulkan.lunarg.com/sdk/home/">Vulkan</ulink>
  </para>

  <!- - Many of the dependencies in the qmake/configure output do not apply
       to Linux-based platforms. I've selected the ones that do and put
       them in as optional dependencies. -renodr - ->
  <para condition="html" role="usernotes">
     User Notes: <ulink url="&blfs-wiki;/qt5"/>
  </para>
-->
  <sect2>
    <title>Creating the module list and utility functions</title>

    <para>
      Create the list of modules in the proper order as follows:
    </para>

<screen><userinput>cat &gt; qt5-submodules-&qt5-version;.md5 &lt;&lt; "EOF"
<literal># Begin basic group
739403634e1326a3d52902a835015a4b  qttools-everywhere-src-5.15.2.tar.xz
c0f5c1c2cc1b66e56ce4ef13a2b7093a  qtsvg-everywhere-src-5.15.2.tar.xz
92cf72015788bb4dcab14494f2835b32  qtx11extras-everywhere-src-5.15.2.tar.xz
26577fbbe0d011b7034bca3c64bc38ae  qtwayland-everywhere-src-5.15.2.tar.xz
# End basic group
# Begin KDE group
# TODO
# End KDE group
# Begin qtwebengine
c88cbe3158feb20c4feb3d54262feb23  qtwebengine-everywhere-src-5.15.2.tar.xz
# End qtwebengine
# Begin optional group
# TODO
# End optional group</literal>
EOF</userinput></screen>

    <para>
      Next create two utility functions, one for switching to user
      <systemitem class="username">root</systemitem>, the other for
      module building:
    </para>

<screen><userinput>as_root() {
  if   [ "$EUID" = 0 ];      then $*
  elif [ -x /usr/bin/sudo ]; then sudo $*
  else                            su -c \\"$*\\"
  fi
}

export -f as_root

module_build() {
  # MD5_ENTRY contains the md5sum entry from the .md5 file for this module
  echo $MD5_ENTRY | read md5 tarball

  # download
  wget &qt5-dwonload-http;$tarball
  md5sum -c - &lt;&lt;&lt; "$MD5_ENTRY" || exit 1

  packagedir=${tarball%.tar*} 

  tar -xf $file
  pushd $packagedir
    # OPTIONS contains the qmake options
    if[ -n "$OPTIONS" ]; then
      qmake -- $OPTIONS
    else
      qmake
    fi
    make
    as_root make install
  popd

  rm -rf $packagedir
  as_root /sbin/ldconfig
}

export -f module_build</userinput></screen>
  </sect2>

  <sect2 id="qt-basic">
    <title>Basic Qt5 Modules</title>

    <para role="required">
      The modules in this group only depend on <xref linkend="qtbase"/>
      and a properly set <envar>QTDIR</envar> environment variable.
    </para>

    <para>
      Install the basic modules with the following instructions:
    </para>

<screen><userinput>( # start a subshell
set -e # exit the subshell in case of error

unset OPTIONS
sed -n "/Begin basic/,/End basic/p" | while read MD5_ENTRY; do
  if [ -z "${MD5_ENTRY%\#*}" ]; then continue; fi
  module_build
done
)
  </sect2>

  <sect2 id="qt-kde">
    <title>Installation of Modules Needed for KDE</title>
    <para>
      Install the modules needed for KDE with the following instructions:
    </para>
  </sect2>

  <sect2 id="qtwebengine">
    <title>Installation of QTWebEngine</title>
    <para>
      Install QtWebEngine with the following instructions:
    </para>
  </sect2>

  <sect2 id="qt-miscellaneous">
    <title>Installation of Other Modules</title>
    <para>
      Install the remaining modules with the following instructions:
    </para>
  </sect2>

  <sect2 role="installation">
    <title>Installation of Qt5</title>

    <warning>
      <para>
        If <application>Qt5</application> is being reinstalled into the
        same directory as an existing instance, run the commands done by
        <systemitem class="username">root</systemitem>, such as
        <command>make install</command>, from a console or non-Qt5 based
        window manager. It overwrites <application>Qt5</application>
        libraries that should not be in use during the install process.
      </para>
    </warning>

    <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 role="nodump"><userinput>            -archdatadir    /usr/lib/qt5                \
            -bindir         /usr/bin                    \
            -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 \
            -examplesdir    /usr/share/doc/qt5/examples</userinput></screen>
    </note>
<!-- Applied upstream in 5.15.0
    <para>
      First fix an issues using gcc-10:
    </para>

<screen><userinput>patch -Np1 -i ../qt-everywhere-src-&qt5-version;-gcc10-1.patch</userinput></screen>
-->

    <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                           \
            -system-harfbuzz                          \
            -system-sqlite                            \
            -nomake examples                          \
            -no-rpath                                 \
            -skip qtwebengine                         &amp;&amp;
make</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make install</userinput></screen>

    <!-- EDITORS NOTE: This package uses INSTALL_ROOT= instead of DESTDIR= for
         installing in a temporary directory. -->

    <para>
      Remove references to the build directory from installed library
      dependency (prl) <!--and profile include (pri)--> files by running the following
      command as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>find $QT5PREFIX/ -name \*.prl \
   -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;</userinput></screen>

    <para>
      Install images and create the menu entries for installed applications.
      The <envar>QT5BINDIR</envar> variable is used here to point to the
      directory for the executable programs.  If you have changed the bindir
      above, <envar>QT5BINDIR</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 \
                  /usr/share/pixmaps/assistant-qt5.png &amp;&amp;

install -v -Dm644 qttools/src/designer/src/designer/images/designer.png \
                  /usr/share/pixmaps/designer-qt5.png  &amp;&amp;

install -v -Dm644 qttools/src/linguist/linguist/images/icons/linguist-128-32.png \
                  /usr/share/pixmaps/linguist-qt5.png  &amp;&amp;

install -v -Dm644 qttools/src/qdbus/qdbusviewer/images/qdbusviewer-128.png \
                  /usr/share/pixmaps/qdbusviewer-qt5.png &amp;&amp;

install -dm755 /usr/share/applications &amp;&amp;

cat &gt; /usr/share/applications/assistant-qt5.desktop &lt;&lt; EOF
<literal>[Desktop Entry]
Name=Qt5 Assistant
Comment=Shows Qt5 documentation and examples
Exec=$QT5BINDIR/assistant
Icon=assistant-qt5.png
Terminal=false
Encoding=UTF-8
Type=Application
Categories=Qt;Development;Documentation;</literal>
EOF

cat &gt; /usr/share/applications/designer-qt5.desktop &lt;&lt; EOF
<literal>[Desktop Entry]
Name=Qt5 Designer
GenericName=Interface Designer
Comment=Design GUIs for Qt5 applications
Exec=$QT5BINDIR/designer
Icon=designer-qt5.png
MimeType=application/x-designer;
Terminal=false
Encoding=UTF-8
Type=Application
Categories=Qt;Development;</literal>
EOF

cat &gt; /usr/share/applications/linguist-qt5.desktop &lt;&lt; EOF
<literal>[Desktop Entry]
Name=Qt5 Linguist
Comment=Add translations to Qt5 applications
Exec=$QT5BINDIR/linguist
Icon=linguist-qt5.png
MimeType=text/vnd.trolltech.linguist;application/x-linguist;
Terminal=false
Encoding=UTF-8
Type=Application
Categories=Qt;Development;</literal>
EOF

cat &gt; /usr/share/applications/qdbusviewer-qt5.desktop &lt;&lt; EOF
<literal>[Desktop Entry]
Name=Qt5 QDbusViewer
GenericName=D-Bus Debugger
Comment=Debug D-Bus applications
Exec=$QT5BINDIR/qdbusviewer
Icon=qdbusviewer-qt5.png
Terminal=false
Encoding=UTF-8
Type=Application
Categories=Qt;Development;Debugger;</literal>
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
      <systemitem class="username">root</systemitem> 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>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <command>sed ...</command>: Allows using
      <application>Python 3</application> instead of <application>Python
      2</application>. This command destroys the build for QtWebEngine, so do
      not use it if you remove the <parameter>-skip qtwebengine</parameter>
      switch.
    </para>

    <para>
      <parameter>-confirm-license</parameter>: Accept license
      without prompting user during configuration.
    </para>

    <para>
      <parameter>-opensource</parameter>: Install the opensource
      version of <application>Qt</application>.
    </para>

    <para>
      <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>-system-sqlite</parameter>: This switch enables use
      of the system version of <application>SQLite</application>.
    </para>

    <para>
      <parameter>-dbus-linked -openssl-linked</parameter>: These
      switches enable explicit linking of the
      <application>D-Bus</application> and
      <application>OpenSSL</application> libraries into
      <application>Qt5</application> libraries instead of
      <command>dlopen()</command>-ing them.
    </para>

    <para>
      <parameter>-skip qtwebengine</parameter>: This switch disables building
      the QtWebEngine. <!--The BLFS editors have chosen to build <xref
      linkend="qtwebengine"/> separately.-->
    </para>

    <para>
      <parameter>-system-harfbuzz</parameter>: This switch enables use
      of the system version of <application>Harfbuzz</application>.
    </para>

  </sect2>

  <sect2 role="configuration">
    <title>Configuring Qt5</title>

    <sect3 id="qt5-config">
      <title>Configuration Information</title>

      <para>
        If you installed <application>Qt5</application> in
        <filename class="directory">/usr</filename>, create an
        environment variable needed by certain packages.
        As the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="nodump"><userinput>cat &gt; /etc/profile.d/qt5.sh &lt;&lt; "EOF"
<literal># Begin /etc/profile.d/qt5.sh

QT5DIR=/usr
export QT5DIR
pathappend $QT5DIR/bin

# End /etc/profile.d/qt5.sh</literal>
EOF</userinput></screen>

      <para>
        If <xref linkend="sudo"/> is installed, QT5DIR should be available to
        the super user as well. Execute the following commands as the
        <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>cat &gt; /etc/sudoers.d/qt &lt;&lt; "EOF"
<literal>Defaults env_keep += QT5DIR</literal>
EOF</userinput></screen>

      <para>
        If you installed <application>Qt5</application> in a location other
        than <filename class="directory">/usr</filename>, you need to update the
        following configuration files so that <application>Qt5</application> is
        correctly found by other packages and system processes.
      </para>

      <para>
        As the <systemitem class="username">root</systemitem> user, update
        the <filename>/etc/ld.so.conf</filename> file and the dynamic linker's
        run-time cache file:
      </para>

<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; EOF
<literal># Begin Qt addition

/opt/qt5/lib

# End Qt addition</literal>
EOF

ldconfig</userinput></screen>

      <indexterm zone="qt5 qt5-config">
        <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
      </indexterm>

      <para>
        As the <systemitem class="username">root</systemitem> user, create
        the <filename>/etc/profile.d/qt5.sh</filename> file:
      </para>

<screen role="root"><userinput>cat &gt; /etc/profile.d/qt5.sh &lt;&lt; "EOF"
<literal># Begin /etc/profile.d/qt5.sh

QT5DIR=/opt/qt5

pathappend $QT5DIR/bin           PATH
pathappend $QT5DIR/lib/pkgconfig PKG_CONFIG_PATH

export QT5DIR

# End /etc/profile.d/qt5.sh</literal>
EOF</userinput></screen>

    </sect3>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          assistant, balsam, canbusutil, designer, fixqt4headers.pl, lconvert,
          linguist, lprodump, lrelease, lrelease-pro, lupdate, lupdate-pro,
          meshdebug, moc, pixeltool, qcollectiongenerator, qdbus, qdbuscpp2xml,
          qdbusviewer, qdbusxml2cpp, qdistancefieldgenerator, qdoc, qgltf,
          qhelpgenerator, qlalr, qmake, qml, qmlcachegen,
          qmleasing, qmlformat, qmlimportscanner, qmllint, qmlmin, qmlplugindump,
          qmlpreview, qmlprofiler, qmlscene, qmltestrunner, qscxmlc,
          qtattributionscanner, qtdiag, qtpaths, qtplugininfo,
          qtwaylandscanner, qvkgen, rcc, repc, sdpscanner, syncqt.pl, tracegen,
          uic, xmlpatterns, and xmlpatternsvalidator
        </seg>
        <seg>
          libQt53DAnimation.so, libQt53DCore.so,
          libQt53DExtras.so, libQt53DInput.so, libQt53DLogic.so,
          libQt53DQuick.so, libQt53DQuickAnimation.so, libQt53DQuickExtras.so,
          libQt53DQuickInput.so, libQt53DQuickRender.so,
          libQt53DQuickScene2D.so, libQt53DRender.so,
          libQt5AccessibilitySupport.a, libQt5Bluetooth.so, libQt5Bodymovin.so,
          libQt5Bootstrap.a, libQt5Charts.so, libQt5Concurrent.so,
          libQt5Core.so, libQt5DataVisualization.so, libQt5DBus.so,
          libQt5DesignerComponents.so, libQt5Designer.so,
          libQt5DeviceDiscoverySupport.a, libQt5EdidSupport.a,
          libQt5EglFSDeviceIntegration.so, libQt5EglFsKmsSupport.so,
          libQt5EglSupport.a, libQt5EventDispatcherSupport.a, libQt5FbSupport.a,
          libQt5FontDatabaseSupport.a, libQt5Gamepad.so, libQt5GlxSupport.a,
          libQt5Gui.so,libQt5Help.so, libQt5InputSupport.a, libQt5KmsSupport.a,
          libQt5LinuxAccessibilitySupport.a, libQt5Location.so,
          libQt5Multimedia.so, libQt5MultimediaGstTools.so,
          libQt5MultimediaQuick.so, libQt5MultimediaWidgets.so,
          libQt5Network.so, libQt5NetworkAuth.so, libQt5Nfc.so,
          libQt5OpenGLExtensions.a, libQt5OpenGL.so, libQt5PacketProtocol.a,
          libQt5PlatformCompositorSupport.a, libQt5Positioning.so,
          libQt5PositioningQuick.so, libQt5PrintSupport.so,
          libQt5Purchasing.so, libQt5Qml.so, libQt5QmlDebug.a,
          libQt5QmlDevTools.a, libQt5QmlModels.so, libQt5QmlWorkerScript.so,
          libQt5Quick.so, libQt5Quick3D.so, libQt5Quick3DAssetImport.so,
          libQt5Quick3DRender.so, libQt5Quick3DRuntimeRender.so,
          libQt5Quick3DUtils.so, libQt5QuickControls2.so,
          libQt5QuickParticles.so, libQt5QuickShapes.so,
          libQt5QuickTemplates2.so, libQt5QuickTest.so, libQt5QuickWidgets.so,
          libQt5RemoteObjects.so, libQt5Script.so, libQt5ScriptTools.so,
          libQt5Scxml.so, libQt5Sensors.so, libQt5SerialBus.so,
          libQt5SerialPort.so, libQt5ServiceSupport.a, libQt5Sql.so,
          libQt5Svg.so, libQt5Test.so, libQt5TextToSpeech.so,
          libQt5ThemeSupport.a, libQt5UiTools.a, libQt5VirtualKeyboard.so,
          libQt5WaylandClient.so, libQt5WaylandCompositor.so,
          libQt5WebChannel.so, libQt5WebSockets.so, libQt5WebView.so,
          libQt5Widgets.so, libQt5X11Extras.so, libQt5XcbQpa.so,
          libQt5XkbCommonSupport.a, libQt5Xml.so, libQt5XmlPatterns.so,
          and several plugins under /opt/qt5/{plugins,qml}
        </seg>
        <seg>
          /usr/include/qt5,
          /usr/lib/qt5,
          /usr/share/doc/qt5, and
          /usr/share/qt5
          OR
          /opt/qt5 and
          /opt/qt-&qt5-version;
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="lconvert-qt5">
        <term><command>lconvert</command></term>
        <listitem>
          <para>
            is part of Qt5's Linguist tool chain. It can be used as a
            standalone tool to convert and filter translation data files.
          </para>
          <indexterm zone="qt5 lconvert-qt5">
            <primary sortas="b-lconvert-qt5">lconvert</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="linguist-qt5">
        <term><command>linguist</command></term>
        <listitem>
          <para>
            provides support for translating applications into
            local languages.
          </para>
          <indexterm zone="qt5 linguist-qt5">
            <primary sortas="b-linguist-qt5">linguist</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lrelease-qt5">
        <term><command>lrelease</command></term>
        <listitem>
          <para>
            is a simple command line tool. It reads XML-based translation
            file in TS format and produces message files used by the
            application.
          </para>
          <indexterm zone="qt5 lrelease-qt5">
            <primary sortas="b-lrelease-qt5">lrelease</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lrelease-pro">
        <term><command>lrelease-pro</command></term>
        <listitem>
          <para>
            extracts project information from qmake projects and passes
            it to lrelease.
          </para>
          <indexterm zone="qt5 lrelease-pro">
            <primary sortas="b-lrelease-pro">lrelease-pro</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lupdate-qt5">
        <term><command>lupdate</command></term>
        <listitem>
          <para>
            finds the translatable
            strings in the specified source, header and Qt Designer
            interface files, and stores the extracted messages in
            translation files to be processed by lrelease.
          </para>
          <indexterm zone="qt5 lupdate-qt5">
            <primary sortas="b-lupdate-qt5">lupdate</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lupdate-pro">
        <term><command>lupdate-pro</command></term>
        <listitem>
          <para>
            reads a Qt project file, an passes the collected information
            to lupdate.
          </para>
          <indexterm zone="qt5 lupdate-pro">
            <primary sortas="b-lupdate-pro">lupdate-pro</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="meshdebug">
        <term><command>meshdebug</command></term>
        <listitem>
          <para>
            displays information about qtquick-3d mesh files.
          </para>
          <indexterm zone="qt5 meshdebug">
            <primary sortas="b-meshdebug">meshdebug</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pixeltool-qt5">
        <term><command>pixeltool</command></term>
        <listitem>
          <para>
            is a desktop magnifier and as you move your mouse around
            the screen it will show the magnified contents in its window.
          </para>
          <indexterm zone="qt5 pixeltool-qt5">
            <primary sortas="b-pixeltool-qt5">pixeltool</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qcollectiongenerator-qt5">
        <term><command>qcollectiongenerator</command></term>
        <listitem>
          <para>
            processes and converts Qt help files.
          </para>
          <indexterm zone="qt5 qcollectiongenerator-qt5">
            <primary sortas="b-qcollectiongenerator-qt5">qcollectiongenerator-qt5</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qdbus-qt5">
        <term><command>qdbus</command></term>
        <listitem>
          <para>
            lists available services, object paths,  methods, signals, and
            properties of objects on a bus.
          </para>
          <indexterm zone="qt5 qdbus-qt5">
            <primary sortas="b-qdbus-qt5">qdbus</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qdbusviewer-qt5">
        <term><command>qdbusviewer</command></term>
        <listitem>
          <para>
            is a graphical D-Bus browser.
          </para>
          <indexterm zone="qt5 qdbusviewer-qt5">
            <primary sortas="b-qdbusviewer-qt5">qdbusviewer</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qdistancefieldgenerator-qt5">
        <term><command>qdistancefieldgenerator</command></term>
        <listitem>
          <para>
            allows a font cache to be pregenerated for Text.QtRendering to speed
            up an application's startup if the user interface has a lot of text,
            or multiple fonts, or a large amount of distinct characters, e.g. in
            CJK writing systems.
          </para>
          <indexterm zone="qt5 qdistancefieldgenerator-qt5">
            <primary sortas="b-qdistancefieldgenerator-qt5">qdistancefieldgenerator</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qdoc-qt5">
        <term><command>qdoc</command></term>
        <listitem>
          <para>
            is a tool used by <application>Qt</application> Developers to
            generate documentation for software projects.
          </para>
          <indexterm zone="qt5 qdoc-qt5">
            <primary sortas="b-qdoc-qt5">qdoc</primary>
          </indexterm>
        </listitem>
      </varlistentry>

     <varlistentry id="qgltf">
        <term><command>qgltf</command></term>
        <listitem>
          <para>
            imports a a variety of 3D model formats and exports into fast-to-load,
            optimized glTF assets embedded into Qt resource files.
          </para>
          <indexterm zone="qt5 qgltf">
            <primary sortas="b-qgltf">qgltf</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qhelpgenerator-qt5">
        <term><command>qhelpgenerator</command></term>
        <listitem>
          <para>
            is a tool used to generate a <application>Qt</application>
            compressed help file.
          </para>
          <indexterm zone="qt5 qhelpgenerator-qt5">
            <primary sortas="b-qhelpgenerator-qt5">qhelpgenerator</primary>
          </indexterm>
        </listitem>
      </varlistentry>

     <varlistentry id="qml">
        <term><command>qml</command></term>
        <listitem>
          <para>
            executes a QML file.
          </para>
          <indexterm zone="qt5 qml">
            <primary sortas="b-qml">qml</primary>
          </indexterm>
        </listitem>
      </varlistentry>

     <varlistentry id="qmlcachegen">
        <term><command>qmlcachegen</command></term>
        <listitem>
          <para>
            supports the creation of cache files at build time.
          </para>
          <indexterm zone="qt5 qmlcachegen">
            <primary sortas="b-qmlcachegen">qmlcachegen</primary>
          </indexterm>
        </listitem>
      </varlistentry>

     <varlistentry id="qmleasing-qt5">
        <term><command>qmleasing</command></term>
        <listitem>
          <para>
            is a tool used to define the easing curves using an
            interactive curve editor.
          </para>
          <indexterm zone="qt5 qmleasing-qt5">
            <primary sortas="b-qmleasing-qt5">qmleasing</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qmlformat-qt5">
        <term><command>qmlformat</command></term>
        <listitem>
          <para>
            formats QML files according to the QML coding conventions.
          </para>
          <indexterm zone="qt5 qmlformat-qt5">
            <primary sortas="b-qmlformat-qt5">qmlformat</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qmlimportscanner-qt5">
        <term><command>qmlimportscanner</command></term>
        <listitem>
          <para>
            is a tool used to import QML files from a directory.
          </para>
          <indexterm zone="qt5 qmlimportscanner-qt5">
            <primary sortas="b-qmlimportscanner-qt5">qmlimportscanner</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qmllint-qt5">
        <term><command>qmllint</command></term>
        <listitem>
          <para>
            is a syntax checker for QML files.
          </para>
          <indexterm zone="qt5 qmllint-qt5">
            <primary sortas="b-qmllint-qt5">qmllint</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qmlmin-qt5">
        <term><command>qmlmin</command></term>
        <listitem>
          <para>
            removes comments and layout characters from a QML file.
          </para>
          <indexterm zone="qt5 qmlmin-qt5">
            <primary sortas="b-qmlmin-qt5">qmlmin</primary>
          </indexterm>
        </listitem>
      </varlistentry>

     <varlistentry id="qmlplugindump-qt5">
        <term><command>qmlplugindump</command></term>
        <listitem>
          <para>
            is a tool to create a qmltypes file.
          </para>
          <indexterm zone="qt5 qmlplugindump-qt5">
            <primary sortas="b-qmlplugindump-qt5">qmlplugindump</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qmlpreview-qt5">
        <term><command>qmlpreview</command></term>
        <listitem>
          <para>
            is a tool used to analyze QML applications.
          </para>
          <indexterm zone="qt5 qmlpreview-qt5">
            <primary sortas="b-qmlpreviewr-qt5">qmlpreview</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qmlprofiler-qt5">
        <term><command>qmlprofiler</command></term>
        <listitem>
          <para>
            is a tool which watches QML and JavaScript files on disk and
            updates the application live with any changes.
          </para>
          <indexterm zone="qt5 qmlprofiler-qt5">
            <primary sortas="b-qmlprofiler-qt5">qmlprofiler</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qmlscene-qt5">
        <term><command>qmlscene</command></term>
        <listitem>
          <para>
            is a utility that loads and displays QML documents even before
            the application is complete.
          </para>
          <indexterm zone="qt5 qmlscene-qt5">
            <primary sortas="b-qmlscene-qt5">qmlscene</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qmltestrunner-qt5">
        <term><command>qmltestrunner</command></term>
        <listitem>
          <para>
            is a tool used to make tests.
          </para>
          <indexterm zone="qt5 qmltestrunner-qt5">
            <primary sortas="b-qmltestrunner-qt5">qmltestrunner</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qscxmlc-qt5">
        <term><command>qscxml</command></term>
        <listitem>
          <para>
            converts an input.scxml file to a header and cpp file.
          </para>
          <indexterm zone="qt5 qscxmlc-qt5">
            <primary sortas="b-qscxmlc-qt5">qscxmlc</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qtattributionsscanner-qt5">
        <term><command>qtattributionsscanner</command></term>
        <listitem>
          <para>
            processes qt_attribution.json files in Qt sources.
          </para>
          <indexterm zone="qt5 qtattributionsscanner-qt5">
            <primary sortas="b-qtattributionsscanner-qt5">qtattributionsscanner</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qtdiag-qt5">
        <term><command>qtdiag</command></term>
        <listitem>
          <para>
            is a tool for reporting diagnostic information about Qt and its
            environment.
          </para>
          <indexterm zone="qt5 qtdiag-qt5">
            <primary sortas="b-qtdiag-qt5">qtdiag</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qtpaths-qt5">
        <term><command>qtpaths</command></term>
        <listitem>
          <para>
            is a tool to query Qt path information.
          </para>
          <indexterm zone="qt5 qtpaths-qt5">
            <primary sortas="b-qtpaths-qt5">qtpaths</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qtplugininfo">
        <term><command>qtplugininfo</command></term>
        <listitem>
          <para>
            dumps meta-data about Qt plugins in JSON format.
          </para>
          <indexterm zone="qt5 qtplugininfo">
            <primary sortas="b-qtplugininfo">qtplugininfo</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="repc">
        <term><command>repc</command></term>
        <listitem>
          <para>
            is the Replica Compiler, which generates QObject header files based
            on an API definition file.
          </para>
          <indexterm zone="qt5 repc">
            <primary sortas="b-repc">repc</primary>
          </indexterm>
        </listitem>
      </varlistentry>

     <varlistentry id="sdpscanner-qt5">
        <term><command>sdpscanner</command></term>
        <listitem>
          <para>
            performs a Session Description Protocol scan on a remote device,
            using the SDP server represented by the local Bluetooth device.
          </para>
          <indexterm zone="qt5 sdpscanner-qt5">
            <primary sortas="b-sdpscanner-qt5">sdpscanner</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xmlpatterns-qt5">
        <term><command>xmlpatterns</command></term>
        <listitem>
          <para>
            provides support for XPath, XQuery, XSLT, and XML Schema
            validation.
          </para>
          <indexterm zone="qt5 xmlpatterns-qt5">
            <primary sortas="b-xmlpatterns-qt5">xmlpatterns</primary>
          </indexterm>
        </listitem>
      </varlistentry>

     <varlistentry id="xmlpatternsvalidator-qt5">
        <term><command>xmlpatternsvalidator</command></term>
        <listitem>
          <para>
            is a tool used to validate XML documents.
          </para>
          <indexterm zone="qt5 xmlpatternsvalidator-qt5">
            <primary sortas="b-xmlpatternsvalidator-qt5">xmlpatternsvalidator</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>