source: x/lib/qt4.xml@ 60d53ec3

<?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 qt4-major  "4.8">
  <!ENTITY wk-major   "2.3">
  <!ENTITY wk-version "2.3.4">
  <!ENTITY qt4-url    "http://download.qt-project.org/official_releases/qt/&qt4-major;">
  <!ENTITY webkit-url "http://download.kde.org/stable/qtwebkit-&wk-major;">

  <!ENTITY qt4-download-http "&qt4-url;/&qt4-version;/qt-everywhere-opensource-src-&qt4-version;.tar.gz">
  <!ENTITY qt4-download-ftp  " ">
  <!ENTITY qt4-md5sum        "d990ee66bf7ab0c785589776f35ba6ad">
  <!ENTITY qt4-size          "230 MB">
  <!ENTITY qt4-buildsize     "2.3 GB">
  <!ENTITY qt4-time          "12 SBU, using parallelism=4">

  <!ENTITY qtwebkit-download "&webkit-url;/&wk-version;/src/qtwebkit-&wk-version;.tar.gz">
  <!ENTITY qtwebkit-md5sum   "42ef76d0cf7d0c611ef83418e9f297ff">
  <!ENTITY qtwebkit-size     "50 MB">
]>

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

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

  <title>Qt-&qt4-version;</title>

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

  <sect2 role="package">
    <title>Introduction to Qt4</title>

    <para>
      <application>Qt4</application> is a cross-platform application framework
      that is widely used for developing application software with a graphical
      user interface (GUI) (in which cases Qt4 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>KDE4</application>.
    </para>

    &lfs78_checked; 

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

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Recommended package: <ulink url="&qtwebkit-download;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &qtwebkit-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &qtwebkit-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Recommended patch:
          <ulink url="&patch-root;/qtwebkit-&wk-version;-gcc5-1.patch"/>
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Qt 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="mesalib"/>,
      <xref linkend="cacerts"/>,
      <xref linkend="dbus"/>,
      <xref linkend="glib2"/>,
      <xref linkend="gst10-plugins-base"/> (For QtWebKit HTML5 Video),
      <xref linkend="icu"/> (unicode support),
      <xref linkend="libjpeg"/>,
      <xref linkend="libmng"/>,
      <xref linkend="libpng"/>,
      <xref linkend="libtiff"/>,
      <xref linkend="ruby"/>,
      <xref linkend="openssl"/>, and
      <xref linkend="sqlite"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="cups"/>,
      <xref linkend="gtk2"/> (GTK+ 2 theme support),
      <xref linkend="mariadb"/> or <ulink url="http://www.mysql.com/">MySQL</ulink>,
      <xref linkend="postgresql"/>,
      <xref linkend="pulseaudio"/>, and
      <xref linkend="unixodbc"/>
    </para>

    <para condition="html" role="usernotes">User Notes:
      <ulink url="&blfs-wiki;/qt4"/>
    </para>
  </sect2>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
              href="../../xincludes/qt-alternatives.xml"/>

  <sect2 role="qt4-prefix">
    <title>Setting the installation prefix</title>

    <bridgehead renderas="sect3">Installing in /opt/qt4</bridgehead>

    <para>
      The BLFS editors recommend installing <application>Qt4</application> in a
      directory other than <filename class="directory">/usr</filename>, ie
      <filename class="directory">/opt/qt4</filename>.  To do this, set the
      following environment variable:
    </para>

<screen><userinput>export QT4PREFIX=/opt/qt4</userinput></screen>

    <tip>
      <para>
        Sometimes, the installation paths are hardcoded into installed files.
        This is the reason why <filename class="directory">/opt/qt4</filename>
        is used as installation prefix instead of <filename
        class="directory">/opt/qt-&qt4-version;</filename>. To create a
        versioned  <application>Qt4</application> directory, you may rename
        the directory and create a symlink:
      </para>

<screen role="root"><userinput>mkdir /opt/qt-&qt4-version;
ln -sfnv qt-&qt4-version; /opt/qt4</userinput></screen>

      <para>
        Later on, you may want to install other versions of
        <application>Qt4</application>. To do that, just remove the symlink
        and use <filename class="directory">/opt/qt4</filename> as the
        prefix again. Which version of <application>Qt4</application> you
        use depends only on where the symlink points.
      </para>
    </tip>

  </sect2>

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

    <warning>
      <para>
        If <application>Qt4</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-Qt4 based
        window manager. It overwrites <application>Qt4</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>Qt4</application> is quite long. The instructions below do
        not build the tutorials and examples. Removing the
        <parameter>-nomake</parameter> lines will create a complete build.
      </para>
    </note>

    <note>
      <para>
        The BLFS editors do not recommend installing <application>Qt4</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>Qt4</application> in /usr, the directories need to
        be specified explicitly.  In this case, set QT4PREFIX=/usr and add
        the following to the configure arguments below:
      </para>

<screen role="nodump"><userinput>-bindir         /usr/bin/qt4                \
-plugindir      /usr/lib/qt4/plugins        \
-importdir      /usr/lib/qt4/imports        \
-headerdir      /usr/include/qt4            \
-datadir        /usr/share/qt4              \
-docdir         /usr/share/doc/qt4          \
-translationdir /usr/share/qt4/translations \
-demosdir       /usr/share/doc/qt4/demos    \
-examplesdir    /usr/share/doc/qt4/examples \</userinput></screen>
    </note>

    <para>
      Install <application>Qt4</application> by running the following commands:
    </para>

<screen><userinput>./configure -prefix           $QT4PREFIX \
            -sysconfdir       /etc/xdg   \
            -confirm-license             \
            -opensource                  \
            -release                     \
            -dbus-linked                 \
            -openssl-linked              \
            -system-sqlite               \
            -no-phonon                   \
            -no-phonon-backend           \
            -no-webkit                   \
            -no-openvg                   \
            -nomake demos                \
            -nomake examples             \
            -optimized-qmake             &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 &amp;&amp;
rm -rf $QT4PREFIX/tests</userinput></screen>

    <para>
      Remove references to the build directory from the installed
      <filename class="extension">.pc</filename> files by running
      the following command as the
      <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>find $QT4PREFIX/lib/pkgconfig -name "*.pc" -exec perl -pi -e "s, -L$PWD/?\S+,,g" {} \;</userinput></screen>

    <para>
      Remove references to the build directory in the installed library
      dependency (prl) files by running the following command as the
      <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>for file in $QT4PREFIX/lib/libQt*.prl; do
     sed -r -e '/^QMAKE_PRL_BUILD_DIR/d'    \
            -e 's/(QMAKE_PRL_LIBS =).*/\1/' \
            -i $file
done</userinput></screen>

    <bridgehead renderas="sect3">Building Qtwebkit</bridgehead>

    <para>
      The bundled version of qtwebkit in the main package requires an
      obsolete version of the <application>gstreamer</application> package.
      To overcome this, we use a more recent version available separately.
    </para>

    <para>To start, the upstream package is unusual in that it does not come
    in a directory, so we have to create one before unpacking the tarball.
    After that, we need to make the package compatible with the latest version
    of gcc and use an included script to actually complete the build.  To do
    this, run the following instructions:</para>

<screen><userinput>mkdir qtwebkit-&wk-version; &amp;&amp;
cd    qtwebkit-&wk-version; &amp;&amp;

tar -xf ../../qtwebkit-&wk-version;.tar.gz             &amp;&amp;
patch -Np1 -i ../../qtwebkit-&wk-version;-gcc5-1.patch &amp;&amp;

Tools/Scripts/build-webkit --qt --no-webkit2 --prefix=$QT4PREFIX</userinput></screen>

   <para>If desired, the build process can use parallel processors by
   adding the option <option>--makeargs=-j&lt;number&gt;</option> to
   the <command>build-webkit</command> instruction above.</para>

    <para>
      To install the package, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make -C WebKitBuild/Release install</userinput></screen>

    <bridgehead renderas="sect3">Installing Auxillary Files</bridgehead>

    <para>
      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>QT4BINDIR</envar> variable is defined in root's
      environment and as the <systemitem class="username">root</systemitem>
      user:
    </para>

<screen role="root"><userinput>QT4BINDIR=$QT4PREFIX/bin

install -v -Dm644 src/gui/dialogs/images/qtlogo-64.png \
                  /usr/share/pixmaps/qt4logo.png       &amp;&amp;

install -v -Dm644 tools/assistant/tools/assistant/images/assistant-128.png \
                  /usr/share/pixmaps/assistant-qt4.png &amp;&amp;

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

install -v -Dm644 tools/linguist/linguist/images/icons/linguist-128-32.png \
                  /usr/share/pixmaps/linguist-qt4.png  &amp;&amp;

install -v -Dm644 tools/qdbus/qdbusviewer/images/qdbusviewer-128.png \
                  /usr/share/pixmaps/qdbusviewer-qt4.png &amp;&amp;

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

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

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

cat &gt; /usr/share/applications/linguist-qt4.desktop &lt;&lt; EOF
<literal>[Desktop Entry]
Name=Qt4 Linguist
Comment=Add translations to Qt4 applications
Exec=$QT4BINDIR/linguist
Icon=linguist-qt4.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-qt4.desktop &lt;&lt; EOF
<literal>[Desktop Entry]
Name=Qt4 QDbusViewer
GenericName=D-Bus Debugger
Comment=Debug D-Bus applications
Exec=$QT4BINDIR/qdbusviewer
Icon=qdbusviewer-qt4.png
Terminal=false
Encoding=UTF-8
Type=Application
Categories=Qt;Development;Debugger;</literal>
EOF

cat &gt; /usr/share/applications/qtconfig-qt4.desktop &lt;&lt; EOF
<literal>[Desktop Entry]
Name=Qt4 Config
Comment=Configure Qt4 behavior, styles, fonts
Exec=$QT4BINDIR/qtconfig
Icon=qt4logo.png
Terminal=false
Encoding=UTF-8
Type=Application
Categories=Qt;Settings;</literal>
EOF</userinput></screen>

    <para>
      Some packages such as <xref linkend='vlc'/> look for certain
      executables with a -qt4 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 $QT4BINDIR/$file /usr/bin/$file-qt4
done</userinput></screen>

  </sect2>

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

    <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>-release</parameter>: This switch disables
      building with debugging symbols.
    </para>

    <para>
      <parameter>-nomake examples -nomake demos</parameter>:
      These switches disable building programs that are only of
      interest to a developer using <application>Qt</application>.
    </para>

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

    <para>
      <parameter>-no-nis</parameter>: This switch disables support
      for Network Information Service (NIS) which has been
      deprecated in recent versions of <application>Glibc</application>.
    </para>

    <para>
      <parameter>-no-phonon -no-phonon-backend</parameter>: These
      switches disable building of the bundled
      <application>Phonon</application> library. Better version
      is provided by <xref linkend="phonon"/> package.
    </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>Qt</application> libraries instead of
      <command>dlopen()</command>-ing them.
    </para>

    <para>
      <parameter>-no-openvg</parameter>: This switch disables
      <application>OpenVG</application> support in
      <application>Qt</application>.
    </para>

    <para>
      <parameter>-optimized-qmake</parameter>: This switch enables
      building of the optimized <command>qmake</command> program.
    </para>

    <para>
      <option>-no-dbus</option>: Use this switch if you don't have
      <application>D-Bus</application> installed.
    </para>

  </sect2>

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

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

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

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

QT4DIR=/usr
QTDIR=$QT4DIR
export QT4DIR QTDIR

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

   <para>
      If you installed <application>Qt4</application> in a location other
      than /usr, you need to update the following configuration files so
      that <application>Qt</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/qt4/lib

# End Qt addition</literal>
EOF

ldconfig</userinput></screen>

   <indexterm zone="qt4 qt4-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/qt4.sh</filename> file:
   </para>

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

QT4DIR=/opt/qt4
QTDIR=$QT4DIR

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

export QT4DIR QTDIR

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


    </sect3>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
                href="../../xincludes/setqt.xml"/>
  </sect2>

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

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

      <seglistitem>
        <seg>
          assistant, designer, lconvert, linguist,
          lrelease, lupdate, moc, pixeltool,
          qcollectiongenerator, qdbuscpp2xml, qdbus,
          qdbusviewer, qdbusxml2cpp, qdoc3, qhelpconverter,
          qhelpgenerator, qmake, qmlplugindump, qmlviewer,
          qt3to4, qtconfig, qttracereplay, rcc, uic3,
          uic, xmlpatterns, and xmlpatternsvalidator
        </seg>
        <seg>
          libQtUiTools.a, libQt3Support.so, libQtCLucene.so, libQtCore.so,
          libQtDBus.so, libQtDeclarative.so, libQtDesignerComponents.so,
          libQtDesigner.so, libQtGui.so, libQtHelp.so, libQtMultimedia.so,
          libQtNetwork.so, libQtOpenGL.so, libQtScript.so, libQtScriptTools.so,
          libQtSql.so, libQtSvg.so, libQtTest.so, libQtWebKit.so,
          libQtXmlPatterns.so, and libQtXml.so, and several plugins under
          /opt/qt4/imports and /opt/qt4/plugins
        </seg>
        <seg>
          /usr/include/qt4,
          /usr/lib/qt4,
          /usr/share/doc/qt4, and
          /usr/share/qt4
          OR
          /opt/qt4 and
          /opt/qt-&qt4-version;
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="assistant-qt4">
        <term><command>assistant</command></term>
        <listitem>
          <para>
            is a tool for presenting on-line documentation.
          </para>
          <indexterm zone="qt4 assistant-qt4">
            <primary sortas="b-assistant-qt4">assistant</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="designer-qt4">
        <term><command>designer</command></term>
        <listitem>
          <para>
            is a full-fledged GUI builder. It includes
            powerful features such as preview mode, automatic widget
            layout, support for custom widgets, and an advanced
            property editor.
          </para>
          <indexterm zone="qt4 designer-qt4">
            <primary sortas="b-designer-qt4">designer</primary>
          </indexterm>
        </listitem>
      </varlistentry>

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

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

      <varlistentry id="lrelease-qt4">
        <term><command>lrelease</command></term>
        <listitem>
          <para>
            is a simple command line tool. It reads a Qt project
            file and produces message files used by the application.
          </para>
          <indexterm zone="qt4 lrelease-qt4">
            <primary sortas="b-lrelease-qt4">lrelease</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lupdate-qt4">
        <term><command>lupdate</command></term>
        <listitem>
          <para>
            reads a Qt project file, finds the translatable
            strings in the specified source, header and Qt Designer
            interface files, and produces or updates the translation
            files listed in the project file.
          </para>
          <indexterm zone="qt4 lupdate-qt4">
            <primary sortas="b-lupdate-qt4">lupdate</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="moc-qt4">
        <term><command>moc</command></term>
        <listitem>
          <para>
            generates Qt meta object support code.
          </para>
          <indexterm zone="qt4 moc-qt4">
            <primary sortas="b-moc-qt4">moc</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pixeltool-qt4">
        <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="qt4 pixeltool-qt4">
            <primary sortas="b-pixeltool-qt4">pixeltool</primary>
          </indexterm>
        </listitem>
      </varlistentry>

     <varlistentry id="qcollectiongenerator-qt4">
        <term><command>qcollectiongenerator</command></term>
        <listitem>
          <para>
            is a tool used to create a Qt Help Collection.
          </para>
          <indexterm zone="qt4 qcollectiongenerator-qt4">
            <primary sortas="b-qcollectiongenerator-qt4">qcollectiongenerator</primary>
          </indexterm>
        </listitem>
      </varlistentry>

     <varlistentry id="qdbuscpp2xml-qt4">
        <term><command>qdbuscpp2xml</command></term>
        <listitem>
          <para>
            takes a C++ source file and generates a D-Bus XML definition
            of the interface.
          </para>
          <indexterm zone="qt4 qdbuscpp2xml-qt4">
            <primary sortas="b-qdbuscpp2xml-qt4">qdbuscpp2xml</primary>
          </indexterm>
        </listitem>
      </varlistentry>

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

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

      <varlistentry id="qdbusxml2cpp-qt4">
        <term><command>qdbusxml2cpp</command></term>
        <listitem>
          <para>
            is a tool that can be used to parse interface descriptions
            and produce static code representing those interfaces,
          </para>
          <indexterm zone="qt4 qdbusxml2cpp-qt4">
            <primary sortas="b-qdbusxml2cpp-qt4">qdbusxml2cpp</primary>
          </indexterm>
        </listitem>
      </varlistentry>

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

      <varlistentry id="qhelpconverter-qt4">
        <term><command>qhelpconverter</command></term>
        <listitem>
          <para>
            is a tool used to convert files to <application>Qt</application>
            help format.
          </para>
          <indexterm zone="qt4 qhelpconverter-qt4">
            <primary sortas="b-qhelpconverter-qt4">qhelpconverter</primary>
          </indexterm>
        </listitem>
      </varlistentry>

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

      <varlistentry id="qmake-qt4">
        <term><command>qmake</command></term>
        <listitem>
          <para>
            uses information stored in project files to
            determine what should go in the makefiles it
            generates.
          </para>
          <indexterm zone="qt4 qmake-qt4">
            <primary sortas="b-qmake-qt4">qmake</primary>
          </indexterm>
        </listitem>
      </varlistentry>

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

      <varlistentry id="qmlviewer-qt4">
        <term><command>qmlviewer</command></term>
        <listitem>
          <para>
            is a tool for loading QML documents that makes it easy to quickly
            develop and debug QML applications.
          </para>
          <indexterm zone="qt4 qmlviewer-qt4">
            <primary sortas="b-qmlviewer-qt4">qmlviewer</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qt3to4-qt4">
        <term><command>qt3to4</command></term>
        <listitem>
          <para>
            qt3to4 is a tool to help update Qt3 code to Qt4.
          </para>
          <indexterm zone="qt4 qt3to4-qt4">
            <primary sortas="b-qt3to4-qt4">qt3to4</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="qtconfig-qt4">
        <term><command>qtconfig</command></term>
        <listitem>
          <para>
            is used to customize the appearance of Qt applications.
          </para>
          <indexterm zone="qt4 qtconfig-qt4">
            <primary sortas="b-qtconfig-qt4">qtconfig</primary>
          </indexterm>
        </listitem>
      </varlistentry>

     <varlistentry id="qttracereplay">
        <term><command>qttracereplay</command></term>
        <listitem>
          <para>
            is a tool to replay all drawing operations recording with 
            <command>-graphicssystem trace</command> into a trace buffer.
          </para>
          <indexterm zone="qt4 qttracereplay">
            <primary sortas="b-qttracereplay">qttracereplay</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="rcc-qt4">
        <term><command>rcc</command></term>
        <listitem>
          <para>
            is a resource compiler used in conjunction with designer.
          </para>
          <indexterm zone="qt4 rcc-qt4">
            <primary sortas="b-rcc-qt4">rcc</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="uic-qt4">
        <term><command>uic</command></term>
        <listitem>
          <para>
            is a Qt user interface compiler.
          </para>
          <indexterm zone="qt4 uic-qt4">
            <primary sortas="b-uic-qt4">uic</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="uic3-qt4">
        <term><command>uic3</command></term>
        <listitem>
          <para>
            is a tool to generate Qt4 code out of
            user interface files generated by the Qt3
            version of designer.
          </para>
          <indexterm zone="qt4 uic3-qt4">
            <primary sortas="b-uic3-qt4">uic3</primary>
          </indexterm>
        </listitem>
      </varlistentry>

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

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

    </variablelist>

  </sect2>

</sect1>