Changes in / [a6f50ce4:f7e12a95]


Ignore:
Files:
1 added
3 edited

Legend:

Unmodified
Added
Removed

  • packages.ent

    ra6f50ce4 rf7e12a95  
    839839<!ENTITY pango-version                "&pango-minor;.14">
    840840<!ENTITY pangomm-version              "2.46.3">
    841 <!ENTITY qt5-version                  "5.15.9">
    842 <!ENTITY qtwebengine-version          "5.15.13">
     841<!ENTITY qt5-major                    "5.15">
     842<!ENTITY qt5-version                  "&qt5-major;.9">
     843<!ENTITY qt5-url "https://download.qt.io/archive/qt/&qt5-major;/&qt5-version;/submodules">
     844<!ENTITY qtwebengine-version          "&qt5-major;.13">
    843845<!ENTITY startup-notification-version "0.12">
    844846<!ENTITY tepl-version                 "6.4.0">

  • x/lib/lib.xml

    ra6f50ce4 rf7e12a95  
    7171  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pangomm.xml"/>
    7272<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qscintilla.xml"/> -->
     73  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qtbase.xml"/>
    7374  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qt5.xml"/>
    74   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qtwebengine.xml"/>
    7575  <!--
    7676  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qtwebkit5.xml"/> -->

  • x/lib/qt5.xml

    ra6f50ce4 rf7e12a95  
    55  %general-entities;
    66
    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        "b748aec1cb8ca0610859e5f63707ad67">
    13   <!ENTITY qt5-size          "629 MB">
    14   <!ENTITY qt5-buildsize     "15 GB (258 MB installed)">
    15   <!ENTITY qt5-time          "27 SBU (using parallelism=4)">
     7  <!ENTITY qt5-qtactiveqt-md5         "0e083bf188f79f9467f4124d2de1b683">
     8  <!ENTITY qt5-qtdeclarative-md5      "7a811f6ee3b05320d5ae6fffbadc8136">
     9  <!ENTITY qt5-qtgraphicaleffects-md5 "0f528e3c1bf0e81befb7c1037c2200de">
     10  <!ENTITY qt5-qtquickcontrols2-md5   "5e4b1b8145a738a36d6f14d2d6cb32ec">
     11  <!ENTITY qt5-qtsvg-md5              "5fc7f98d8ba2078446c538a461566d4b">
     12  <!ENTITY qt5-qttools-md5            "6b1918dc24e0a56c9fd48d69e78b13fa">
     13  <!ENTITY qt5-qtwayland-md5          "decc31455e124036dce9644b5d8bd754">
     14  <!ENTITY qt5-qtx11extras-md5        "3646de5ffd3cf29c7a3b266d3a9b7a02">
     15  <!ENTITY qt5-qtxmlpatterns-md5      "438c2f84b44ee681e13e2ebe13360338">
     16  <!ENTITY qt5-download-http          "&qt5-url;/">
     17  <!ENTITY qt5-download-ftp           " ">
     18  <!ENTITY qt5-md5sum                 "See below">
     19  <!ENTITY qt5-size                   "11 MB for basic modules, 59 MB for qtwebengine,">
     20  <!ENTITY qt5-buildsize              "930 MB (23 MB installed) for basic modules">
     21  <!ENTITY qt5-time                   "Using parallelism=4: 3.4 SBU for basic modules">
    1622]>
    1723
    … …  
    2026
    2127
    22   <title>Qt-&qt5-version;</title>
     28  <title>Qt-&qt5-version; Modules</title>
    2329
    2430  <indexterm zone="qt5">
    25     <primary sortas="a-Qt">Qt</primary>
     31    <primary sortas="a-Qt">Qt Modules</primary>
    2632  </indexterm>
    2733
    28   <sect2 role="package">
    29     <title>Introduction to Qt5</title>
    30 
    31     <para>
    32       <application>Qt5</application> is a cross-platform application framework
    33       that is widely used for developing application software with a graphical
    34       user interface (GUI) (in which cases <application>Qt5</application> is
    35       classified as a widget toolkit), and also used for developing non-GUI
    36       programs such as command-line tools and consoles for servers. One of the
    37       major users of <application>Qt</application> is <application>KDE
    38       Frameworks 5 (KF5)</application>.
    39     </para>
     34  <para>
     35    After the <xref linkend="qtbase"/> has been installed, various modules
     36    can be added to provide more functionalities. They are divided in several
     37    groups, each of which depends on the precedent:
     38  </para>
     39
     40  <itemizedlist spacing="compact">
     41    <listitem>
     42      <para>
     43        <xref linkend="qt-basic"/> are used in almost all
     44        <application>Qt5</application> based applications, and
     45        must be built first.
     46      </para>
     47    </listitem>
     48    <listitem>
     49      <para>
     50        <xref linkend="qt-kde"/> are needed for
     51        <xref linkend="kf5-frameworks"/> and <xref linkend="plasma5-build"/>.
     52      </para>
     53    </listitem>
     54    <listitem>
     55      <para>
     56        <xref linkend="qtwebengine"/> is a huge module that integrates
     57        <application>chromium</application>'s web capabilities into
     58        <application>Qt5</application>
     59      </para>
     60    </listitem>
     61    <listitem>
     62      <para>
     63        <xref linkend="qt-miscellaneous"/> are not needed for building
     64        packages in the book, but can be built for a complete installation
     65        of <application>Qt5</application>
     66      </para>
     67    </listitem>
     68  </itemizedlist>
    4069
    4170    &lfs113_checked;
    4271
    43     <bridgehead renderas="sect3">Package Information</bridgehead>
    44     <itemizedlist spacing="compact">
    45       <listitem>
    46         <para>
    47           Download (HTTP): <ulink url="&qt5-download-http;"/>
    48         </para>
    49       </listitem>
    50       <listitem>
    51         <para>
    52           Download (FTP): <ulink url="&qt5-download-ftp;"/>
    53         </para>
    54       </listitem>
    55       <listitem>
    56         <para>
    57           Download MD5 sum: &qt5-md5sum;
    58         </para>
    59       </listitem>
    60       <listitem>
    61         <para>
    62           Download size: &qt5-size;
    63         </para>
    64       </listitem>
    65       <listitem>
    66         <para>
    67           Estimated disk space required: &qt5-buildsize;
    68         </para>
    69       </listitem>
    70       <listitem>
    71         <para>
    72           Estimated build time: &qt5-time;
    73         </para>
    74       </listitem>
    75     </itemizedlist>
     72  <bridgehead renderas="sect3">Package Information</bridgehead>
     73  <itemizedlist spacing="compact">
     74    <listitem>
     75      <para>
     76        Download (HTTP): <ulink url="&qt5-download-http;"/>
     77      </para>
     78    </listitem>
     79    <listitem>
     80      <para>
     81        Download (FTP): <ulink url="&qt5-download-ftp;"/>
     82      </para>
     83    </listitem>
     84    <listitem>
     85      <para>
     86        Download MD5 sum: &qt5-md5sum;
     87      </para>
     88    </listitem>
     89    <listitem>
     90      <para>
     91        Download size: &qt5-size;
     92      </para>
     93    </listitem>
     94    <listitem>
     95      <para>
     96        Estimated disk space required: &qt5-buildsize;
     97      </para>
     98    </listitem>
     99    <listitem>
     100      <para>
     101        Estimated build time: &qt5-time;
     102      </para>
     103    </listitem>
     104  </itemizedlist>
    76105
    77106    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    … …  
    97126    </itemizedlist>
    98127
    99     <bridgehead renderas="sect3">Qt5 Dependencies</bridgehead>
    100 
    101     <bridgehead renderas="sect4">Required</bridgehead>
     128<!--
     129  <bridgehead renderas="sect3">Qt5 Dependencies</bridgehead>
     130
     131  <bridgehead renderas="sect4">Required</bridgehead>
     132  <para role="required">
     133    <xref linkend="xorg7-lib"/>
     134  </para>
     135
     136  <bridgehead renderas="sect4">Recommended</bridgehead>
     137  <para role="recommended">
     138    <xref linkend="alsa-lib"/>,
     139    <xref linkend="make-ca"/>,
     140    <xref linkend="cups"/>,
     141    <xref linkend="glib2"/>,
     142    <xref linkend="gst10-plugins-base"/> (QtMultimedia backend),
     143    <xref linkend="harfbuzz"/>,
     144    <xref linkend="icu"/>,
     145    <xref linkend="jasper"/>,
     146    <xref linkend="libjpeg"/>,
     147    <xref linkend="libmng"/>,
     148    <xref linkend="libpng"/>,
     149    <xref linkend="libtiff"/>,
     150    <xref linkend="libwebp"/>,
     151    <xref linkend="libxkbcommon"/>,
     152    <xref linkend="mesa"/>,
     153    <xref linkend="mitkrb"/>,
     154    <xref linkend="mtdev"/>,
     155    <xref linkend="pcre2"/>,
     156    <xref linkend="sqlite"/>,
     157    <xref linkend="wayland"/> (<application>Mesa</application>
     158    must be built with <application>Wayland</application> EGL
     159    backend),
     160    <xref linkend="xcb-util-image"/>,
     161    <xref linkend="xcb-util-keysyms"/>,
     162    <xref linkend="xcb-util-renderutil"/>, and
     163    <xref linkend="xcb-util-wm"/>
     164  </para>
     165
     166  <bridgehead renderas="sect4">Optional</bridgehead>
     167  <para role="optional">
     168    <xref role="runtime" linkend="bluez"/> (for sdpscanner, and at runtime for
     169    QtConnectivity module),
     170    <xref linkend="ibus"/>,
     171    <xref linkend="libinput"/>, <!- - needs -libinput switch - ->
     172    <xref linkend="mariadb"/>
     173      or <ulink url="http://www.mysql.com/">MySQL</ulink>,
     174    <xref linkend="pciutils"/> (required for QtWebEngine),
     175    <xref linkend="postgresql"/>,
     176    <xref linkend="python2"/> (required for QtWebEngine),
     177    <xref linkend="pulseaudio"/>,
     178    <xref linkend="sdl2"/>,
     179    <xref linkend="unixodbc"/>,
     180    <ulink url="https://www.assimp.org/">assimp</ulink>,
     181    <ulink url="http://www.festvox.org/flite/">Flite</ulink>,
     182    <ulink url="http://www.firebirdsql.org/">Firebird</ulink>,
     183    <ulink url="http://www.freetds.org/">FreeTDS</ulink>,
     184    <ulink url="https://libproxy.github.io/libproxy/">libproxy</ulink>,
     185    <ulink url="https://openal.org/">OpenAL</ulink>,
     186    <ulink url="https://freebsoft.org/speechd/">speech-dispatcher</ulink>,
     187    <ulink url="http:///www.tslib.org/">tslib</ulink>, and
     188    <ulink url="https://vulkan.lunarg.com/sdk/home/">Vulkan</ulink>
     189  </para>
     190
     191  <!- - Many of the dependencies in the qmake/configure output do not apply
     192       to Linux-based platforms. I've selected the ones that do and put
     193       them in as optional dependencies. -renodr - ->
     194  <para condition="html" role="usernotes">
     195     User Notes: <ulink url="&blfs-wiki;/qt5"/>
     196  </para>
     197-->
     198  <sect2>
     199    <title>Creating the module list and utility functions</title>
     200
     201    <para>
     202      Create the list of modules in the proper order as follows:
     203    </para>
     204
     205<screen><userinput>cat &gt; qt5-submodules-&qt5-version;.md5 &lt;&lt; "EOF"
     206<literal># Begin basic group
     207&qt5-qtactiveqt-md5;  qtactiveqt-everywhere-opensource-src-&qt5-version;.tar.xz
     208&qt5-qtsvg-md5;  qtsvg-everywhere-opensource-src-&qt5-version;.tar.xz
     209&qt5-qtdeclarative-md5;  qtdeclarative-everywhere-opensource-src-&qt5-version;.tar.xz
     210&qt5-qttools-md5;  qttools-everywhere-opensource-src-&qt5-version;.tar.xz
     211&qt5-qtx11extras-md5;  qtx11extras-everywhere-opensource-src-&qt5-version;.tar.xz
     212&qt5-qtwayland-md5;  qtwayland-everywhere-opensource-src-&qt5-version;.tar.xz
     213# End basic group
     214# Begin KDE group
     215&qt5-qtquickcontrols2-md5;  qtquickcontrols2-everywhere-opensource-src-&qt5-version;.tar.xz
     216&qt5-qtgraphicaleffects-md5;  qtgraphicaleffects-everywhere-opensource-src-&qt5-version;.tar.xz
     217&qt5-qtxmlpatterns-md5;  qtxmlpatterns-everywhere-opensource-src-&qt5-version;.tar.xz
     218# TODO
     219# End KDE group
     220# Begin qtwebengine
     221c88cbe3158feb20c4feb3d54262feb23  qtwebengine-everywhere-opensource-src-5.15.2.tar.xz
     222# End qtwebengine
     223# Begin optional group
     224# TODO
     225# End optional group</literal>
     226EOF</userinput></screen>
     227
     228    <para>
     229      Next create two utility functions, one for switching to user
     230      <systemitem class="username">root</systemitem>, the other for
     231      module building:
     232    </para>
     233
     234<screen><userinput>as_root() {
     235  if   [ "$EUID" = 0 ];      then $*
     236  elif [ -x /usr/bin/sudo ]; then sudo -E $*
     237  else                            su -c \\"$*\\"
     238  fi
     239}
     240
     241export -f as_root
     242
     243module_build() {
     244  # MD5_ENTRY contains the md5sum entry from the .md5 file for this module
     245  echo $MD5_ENTRY | {
     246    read md5 tarball
     247
     248    # download
     249    wget &qt5-download-http;$tarball
     250    md5sum -c - &lt;&lt;&lt; "$MD5_ENTRY" || exit 1
     251
     252    packagedir=${tarball%.tar*}
     253
     254    tar -xf $tarball
     255    pushd $packagedir
     256    # OPTIONS contains the qmake options
     257      if [ -n "$OPTIONS" ]; then
     258        qmake -- $OPTIONS
     259      else
     260        qmake
     261      fi
     262      make
     263      as_root make install
     264    popd
     265
     266    rm -rf $packagedir
     267  }
     268  as_root /sbin/ldconfig
     269
     270  #   Remove references to the build directory from installed library
     271  #   dependency (prl) files:
     272  as_root find $QT5DIR/ -name \*.prl \
     273             -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;
     274}
     275
     276export -f module_build</userinput></screen>
     277  </sect2>
     278
     279  <sect2 id="qt-basic" xreflabel="Basic Qt5 Modules">
     280    <title>Basic Qt5 Modules</title>
     281
    102282    <para role="required">
    103       <xref linkend="xorg7-lib"/>
    104     </para>
    105 
    106     <bridgehead renderas="sect4">Recommended</bridgehead>
    107     <para role="recommended">
    108       <xref linkend="alsa-lib"/>,
    109       <xref linkend="make-ca"/>,
    110       <xref linkend="cups"/>,
    111       <xref linkend="double-conversion"/>,
    112       <xref linkend="glib2"/>,
    113       <xref linkend="gst10-plugins-base"/> (QtMultimedia backend),
    114       <xref linkend="harfbuzz"/>,
    115       <xref linkend="icu"/>,
    116       <xref linkend="jasper"/>,
    117       <xref linkend="libjpeg"/>,
    118       <xref linkend="libmng"/>,
    119       <xref linkend="libpng"/>,
    120       <xref linkend="libtiff"/>,
    121       <xref linkend="libwebp"/>,
    122       <xref linkend="libxkbcommon"/>,
    123       <xref linkend="mesa"/>,
    124       <xref linkend="mtdev"/>,
    125       <xref linkend="pcre2"/>,
    126       <xref linkend="sqlite"/>,
    127       <xref linkend="wayland"/> (<application>Mesa</application>
    128       must be built with <application>Wayland</application> EGL
    129       backend),
    130       <xref linkend="xcb-util-image"/>,
    131       <xref linkend="xcb-util-keysyms"/>,
    132       <xref linkend="xcb-util-renderutil"/>, and
    133       <xref linkend="xcb-util-wm"/>
    134     </para>
    135 
    136     <bridgehead renderas="sect4">Optional</bridgehead>
    137     <para role="optional">
    138       <xref role="runtime" linkend="bluez"/> (for sdpscanner, and at runtime for
    139       QtConnectivity module),
    140       <xref linkend="ibus"/>,
    141       <xref linkend="libinput"/>, <!-- needs -libinput switch -->
    142       <xref linkend="mariadb"/>
    143         or <ulink url="https://www.mysql.com/">MySQL</ulink>,
    144       <xref linkend="pciutils"/>,
    145       <xref linkend="postgresql"/>,
    146       <!-- we handle QtWebEngine separately
    147       <xref linkend="python2"/> (required for QtWebEngine), -->
    148       <xref linkend="pulseaudio"/>,
    149       <xref linkend="sdl2"/>,
    150       <xref linkend="unixodbc"/>,
    151       <ulink url="https://www.assimp.org/">assimp</ulink>,
    152       <ulink url="https://github.com/festvox/flite">Flite</ulink>,
    153       <ulink url="https://www.firebirdsql.org/">Firebird</ulink>,
    154       <ulink url="https://www.freetds.org/">FreeTDS</ulink>,
    155       <ulink url="https://libproxy.github.io/libproxy/">libproxy</ulink>,
    156       <ulink url="https://openal.org/">OpenAL</ulink>,
    157       <ulink url="https://freebsoft.org/speechd/">speech-dispatcher</ulink>,
    158       <ulink url="http:///www.tslib.org/">tslib</ulink>, and
    159       <ulink url="https://vulkan.lunarg.com/sdk/home/">Vulkan</ulink>
    160     </para>
    161 
    162     <!-- Many of the dependencies in the qmake/configure output do not apply
    163          to Linux-based platforms. I've selected the ones that do and put
    164          them in as optional dependencies. -renodr -->
    165     <para condition="html" role="usernotes">
    166        User Notes: <ulink url="&blfs-wiki;/qt5"/>
    167     </para>
     283      The modules in this group only depend on <xref linkend="qtbase"/>
     284      and a properly set <envar>QT5DIR</envar> environment variable.
     285    </para>
     286
     287    <para>
     288      Install the basic modules with the following instructions:
     289    </para>
     290
     291<screen><userinput>( # start a subshell
     292set -e # exit the subshell in case of error
     293
     294unset OPTIONS
     295sed -n "/Begin basic/,/End basic/p" qt5-submodules-&qt5-version;.md5 | \
     296                while read MD5_ENTRY; do
     297  if [ -n "${MD5_ENTRY%\#*}" ]; then module_build; fi
     298done
     299)</userinput></screen>
     300
     301    <para>
     302      Create desktop menu entries pointing to some tools from the
     303      Qt system. As the &root; user:
     304    </para>
     305
     306    <screen role="root"><userinput>QT5BINDIR=$QT5DIR/bin
     307install -v -dm755 /usr/share/pixmaps/
     308
     309install -v -Dm644 src/assistant/assistant/images/assistant-128.png \
     310          /usr/share/pixmaps/assistant-qt5.png
     311
     312install -v -Dm644 src/designer/src/designer/images/designer.png \
     313          /usr/share/pixmaps/designer-qt5.png
     314
     315install -v -Dm644 src/linguist/linguist/images/icons/linguist-128-32.png \
     316          /usr/share/pixmaps/linguist-qt5.png
     317
     318install -v -Dm644 src/qdbus/qdbusviewer/images/qdbusviewer-128.png \
     319          /usr/share/pixmaps/qdbusviewer-qt5.png
     320
     321install -dm755 /usr/share/applications
     322
     323cat &gt; /usr/share/applications/assistant-qt5.desktop &lt;&lt; EOF
     324<literal>[Desktop Entry]
     325Name=Qt5 Assistant
     326Comment=Shows Qt5 documentation and examples
     327Exec=$QT5BINDIR/assistant
     328Icon=assistant-qt5.png
     329Terminal=false
     330Encoding=UTF-8
     331Type=Application
     332Categories=Qt;Development;Documentation;</literal>
     333EOF
     334
     335cat &gt; /usr/share/applications/designer-qt5.desktop &lt;&lt; EOF
     336<literal>[Desktop Entry]
     337Name=Qt5 Designer
     338GenericName=Interface Designer
     339Comment=Design GUIs for Qt5 applications
     340Exec=$QT5BINDIR/designer
     341Icon=designer-qt5.png
     342MimeType=application/x-designer;
     343Terminal=false
     344Encoding=UTF-8
     345Type=Application
     346Categories=Qt;Development;</literal>
     347EOF
     348
     349cat &gt; /usr/share/applications/linguist-qt5.desktop &lt;&lt; EOF
     350<literal>[Desktop Entry]
     351Name=Qt5 Linguist
     352Comment=Add translations to Qt5 applications
     353Exec=$QT5BINDIR/linguist
     354Icon=linguist-qt5.png
     355MimeType=text/vnd.trolltech.linguist;application/x-linguist;
     356Terminal=false
     357Encoding=UTF-8
     358Type=Application
     359Categories=Qt;Development;</literal>
     360EOF
     361
     362cat &gt; /usr/share/applications/qdbusviewer-qt5.desktop &lt;&lt; EOF
     363<literal>[Desktop Entry]
     364Name=Qt5 QDbusViewer
     365GenericName=D-Bus Debugger
     366Comment=Debug D-Bus applications
     367Exec=$QT5BINDIR/qdbusviewer
     368Icon=qdbusviewer-qt5.png
     369Terminal=false
     370Encoding=UTF-8
     371Type=Application
     372Categories=Qt;Development;Debugger;</literal>
     373EOF</userinput></screen>
     374
     375    <para>
     376      Some packages such as vlc look for certain
     377      executables with a -qt5 suffix. Still as the &root; user:
     378    </para>
     379
     380<screen role="root"><userinput>for file in lconvert lrelease lupdate; do
     381  ln -sfrvn $QT5DIR/bin/$file /usr/bin/$file-qt5
     382done</userinput></screen>
     383
     384    <sect3 role="content">
     385      <title>Contents of basic modules</title>
     386
     387      <segmentedlist>
     388        <segtitle>Installed Programs</segtitle>
     389        <segtitle>Installed Libraries</segtitle>
     390        <segtitle>Installed Directories</segtitle>
     391
     392        <seglistitem>
     393          <seg>
     394            assistant,
     395            designer,
     396            lconvert,
     397            linguist,
     398            lprodump,
     399            lrelease,
     400            lrelease-pro,
     401            lupdate,
     402            lupdate-pro,
     403            pixeltool,
     404            qcollectiongenerator,
     405            qdbus,
     406            qdbusviewer,
     407            qdoc,
     408            qhelpgenerator,
     409            qtattributionsscanner,
     410            qtdiag,
     411            qtpaths,
     412            qtplugininfo, and
     413            qtwaylandscanner
     414          </seg>
     415          <seg>
     416            libQt5DesignerComponents.so,
     417            libQt5Designer.so,
     418            libQt5Help.so,
     419            libQt5Svg.so,
     420            libQt5WaylandClient.so,
     421            libQt5WaylandCompositor.so, and
     422            libQt5X11Extras.so
     423          </seg>
     424          <seg>
     425            $QT5DIR/phrasebooks,
     426            $QT5DIR/include/{QtUiTools,QtHelp,QtDesigner,QtX11Extras,QtSvg},
     427            $QT5DIR/include/{QtWaylandCompositor,QtWaylandClient},
     428            $QT5DIR/include/{QtDesignerComponents,QtUiPlugin},
     429            $QT5DIR/lib/cmake/{Qt5AttributionsScannerTools,Qt5Help,Qt5Designer},
     430            $QT5DIR/lib/cmake/{Qt5X11Extras,Qt5Svg,Qt5UiTools,Qt5DocTools},
     431            $QT5DIR/lib/cmake/{Qt5WaylandCompositor,Qt5WaylandClient},
     432            $QT5DIR/lib/cmake/{Qt5DesignerComponents,Qt5UiPlugin},
     433            $QT5DIR/lib/cmake/Qt5LinguistTools,
     434            $QT5DIR/plugins/wayland-graphics-integration-client,
     435            $QT5DIR/plugins/wayland-graphics-integration-server,
     436            $QT5DIR/plugins/wayland-decoration-client, and
     437            $QT5DIR/plugins/iconengines
     438          </seg>
     439        </seglistitem>
     440      </segmentedlist>
     441
     442      <variablelist>
     443        <bridgehead renderas="sect4">Short Descriptions</bridgehead>
     444        <?dbfo list-presentation="list"?>
     445        <?dbhtml list-presentation="table"?>
     446
     447        <varlistentry id="lconvert-qt5">
     448          <term><command>lconvert</command></term>
     449          <listitem>
     450            <para>
     451              is part of Qt5's Linguist tool chain. It can be used as a
     452              standalone tool to convert and filter translation data files.
     453            </para>
     454            <indexterm zone="qt5 lconvert-qt5">
     455              <primary sortas="b-lconvert-qt5">lconvert</primary>
     456            </indexterm>
     457          </listitem>
     458        </varlistentry>
     459
     460        <varlistentry id="linguist-qt5">
     461          <term><command>linguist</command></term>
     462          <listitem>
     463            <para>
     464              provides support for translating applications into
     465              local languages.
     466            </para>
     467            <indexterm zone="qt5 linguist-qt5">
     468              <primary sortas="b-linguist-qt5">linguist</primary>
     469            </indexterm>
     470          </listitem>
     471        </varlistentry>
     472
     473        <varlistentry id="lrelease-qt5">
     474          <term><command>lrelease</command></term>
     475          <listitem>
     476            <para>
     477              is a simple command line tool. It reads XML-based translation
     478              file in TS format and produces message files used by the
     479              application.
     480            </para>
     481            <indexterm zone="qt5 lrelease-qt5">
     482              <primary sortas="b-lrelease-qt5">lrelease</primary>
     483            </indexterm>
     484          </listitem>
     485        </varlistentry>
     486
     487        <varlistentry id="lrelease-pro">
     488          <term><command>lrelease-pro</command></term>
     489          <listitem>
     490            <para>
     491              extracts project information from qmake projects and passes
     492              it to lrelease.
     493            </para>
     494            <indexterm zone="qt5 lrelease-pro">
     495              <primary sortas="b-lrelease-pro">lrelease-pro</primary>
     496            </indexterm>
     497          </listitem>
     498        </varlistentry>
     499
     500        <varlistentry id="lupdate-qt5">
     501          <term><command>lupdate</command></term>
     502          <listitem>
     503            <para>
     504              finds the translatable
     505              strings in the specified source, header and Qt Designer
     506              interface files, and stores the extracted messages in
     507              translation files to be processed by lrelease.
     508            </para>
     509            <indexterm zone="qt5 lupdate-qt5">
     510              <primary sortas="b-lupdate-qt5">lupdate</primary>
     511            </indexterm>
     512          </listitem>
     513        </varlistentry>
     514
     515        <varlistentry id="lupdate-pro">
     516          <term><command>lupdate-pro</command></term>
     517          <listitem>
     518            <para>
     519              reads a Qt project file, an passes the collected information
     520              to lupdate.
     521            </para>
     522            <indexterm zone="qt5 lupdate-pro">
     523              <primary sortas="b-lupdate-pro">lupdate-pro</primary>
     524            </indexterm>
     525          </listitem>
     526        </varlistentry>
     527
     528        <varlistentry id="pixeltool-qt5">
     529          <term><command>pixeltool</command></term>
     530          <listitem>
     531            <para>
     532              is a desktop magnifier and as you move your mouse around
     533              the screen it will show the magnified contents in its window.
     534            </para>
     535            <indexterm zone="qt5 pixeltool-qt5">
     536              <primary sortas="b-pixeltool-qt5">pixeltool</primary>
     537            </indexterm>
     538          </listitem>
     539        </varlistentry>
     540
     541        <varlistentry id="qcollectiongenerator-qt5">
     542          <term><command>qcollectiongenerator</command></term>
     543          <listitem>
     544            <para>
     545              processes and converts Qt help files.
     546            </para>
     547            <indexterm zone="qt5 qcollectiongenerator-qt5">
     548              <primary sortas="b-qcollectiongenerator-qt5">qcollectiongenerator-qt5</primary>
     549            </indexterm>
     550          </listitem>
     551        </varlistentry>
     552
     553        <varlistentry id="qdbus-qt5">
     554          <term><command>qdbus</command></term>
     555          <listitem>
     556            <para>
     557              lists available services, object paths,  methods, signals, and
     558              properties of objects on a bus.
     559            </para>
     560            <indexterm zone="qt5 qdbus-qt5">
     561              <primary sortas="b-qdbus-qt5">qdbus</primary>
     562            </indexterm>
     563          </listitem>
     564        </varlistentry>
     565
     566        <varlistentry id="qdbusviewer-qt5">
     567          <term><command>qdbusviewer</command></term>
     568          <listitem>
     569            <para>
     570              is a graphical D-Bus browser.
     571            </para>
     572            <indexterm zone="qt5 qdbusviewer-qt5">
     573              <primary sortas="b-qdbusviewer-qt5">qdbusviewer</primary>
     574            </indexterm>
     575          </listitem>
     576        </varlistentry>
     577
     578        <varlistentry id="qdoc-qt5">
     579          <term><command>qdoc</command></term>
     580          <listitem>
     581            <para>
     582              is a tool used by <application>Qt</application> Developers to
     583              generate documentation for software projects.
     584            </para>
     585            <indexterm zone="qt5 qdoc-qt5">
     586              <primary sortas="b-qdoc-qt5">qdoc</primary>
     587            </indexterm>
     588          </listitem>
     589        </varlistentry>
     590
     591        <varlistentry id="qhelpgenerator-qt5">
     592          <term><command>qhelpgenerator</command></term>
     593          <listitem>
     594            <para>
     595              is a tool used to generate a <application>Qt</application>
     596              compressed help file.
     597            </para>
     598            <indexterm zone="qt5 qhelpgenerator-qt5">
     599              <primary sortas="b-qhelpgenerator-qt5">qhelpgenerator</primary>
     600            </indexterm>
     601          </listitem>
     602        </varlistentry>
     603
     604        <varlistentry id="qtattributionsscanner-qt5">
     605          <term><command>qtattributionsscanner</command></term>
     606          <listitem>
     607            <para>
     608              processes qt_attribution.json files in Qt sources.
     609            </para>
     610            <indexterm zone="qt5 qtattributionsscanner-qt5">
     611              <primary sortas="b-qtattributionsscanner-qt5">qtattributionsscanner</primary>
     612            </indexterm>
     613          </listitem>
     614        </varlistentry>
     615
     616        <varlistentry id="qtdiag-qt5">
     617          <term><command>qtdiag</command></term>
     618          <listitem>
     619            <para>
     620              is a tool for reporting diagnostic information about Qt and its
     621              environment.
     622            </para>
     623            <indexterm zone="qt5 qtdiag-qt5">
     624              <primary sortas="b-qtdiag-qt5">qtdiag</primary>
     625            </indexterm>
     626          </listitem>
     627        </varlistentry>
     628
     629        <varlistentry id="qtpaths-qt5">
     630          <term><command>qtpaths</command></term>
     631          <listitem>
     632            <para>
     633              is a tool to query Qt path information.
     634            </para>
     635            <indexterm zone="qt5 qtpaths-qt5">
     636              <primary sortas="b-qtpaths-qt5">qtpaths</primary>
     637            </indexterm>
     638          </listitem>
     639        </varlistentry>
     640
     641        <varlistentry id="qtplugininfo">
     642          <term><command>qtplugininfo</command></term>
     643          <listitem>
     644            <para>
     645              dumps meta-data about Qt plugins in JSON format.
     646            </para>
     647            <indexterm zone="qt5 qtplugininfo">
     648              <primary sortas="b-qtplugininfo">qtplugininfo</primary>
     649            </indexterm>
     650          </listitem>
     651        </varlistentry>
     652
     653      </variablelist>
     654
     655    </sect3>
    168656  </sect2>
    169657
    170   <sect2 role="qt5-prefix">
    171     <title>Setting the installation prefix</title>
    172 
    173     <bridgehead renderas="sect3">Installing in /opt/qt5</bridgehead>
    174 
    175     <para>
    176       The BLFS editors recommend installing <application>Qt5</application> in a
    177       directory other than <filename class="directory">/usr</filename>, ie
    178       <filename class="directory">/opt/qt5</filename>.  To do this,  set the
    179       following environment variable:
    180     </para>
    181 
    182 <screen><userinput>export QT5PREFIX=/opt/qt5</userinput></screen>
    183 
    184     <tip>
    185       <para>
    186         Sometimes, the installation paths are hardcoded into installed files.
    187         This is the reason why <filename class="directory">/opt/qt5</filename>
    188         is used as installation prefix instead of <filename
    189         class="directory">/opt/qt-&qt5-version;</filename>. To create a
    190         versioned <application>Qt5</application> directory after the
    191         installation is complete, you may rename the directory and create a symlink:
    192       </para>
    193 
    194 <screen role="root"><userinput>mkdir -pv /opt/qt-&qt5-version;
    195 ln -sfnv qt-&qt5-version; /opt/qt5</userinput></screen>
    196 
    197       <para>
    198         Later on, you may want to install other versions of
    199         <application>Qt5</application>. To do that, just remove the symlink
    200         and use <filename class="directory">/opt/qt5</filename> as the
    201         prefix again. Which version of <application>Qt5</application> you
    202         use depends only on where the symlink points.
    203       </para>
    204     </tip>
    205 
    206     <note>
    207       <para>
    208         If <xref linkend="qca"/> has been installed and you are
    209         reinstalling or updating this package, then
    210         <application>qca</application> will need to be reinstalled.
    211       </para>
    212     </note>
    213 
     658  <sect2 id="qt-kde" xreflabel="Modules Needed for KDE">
     659    <title>Modules Needed for KDE</title>
     660    <para>
     661      Install the modules needed for KDE with the following instructions:
     662    </para>
     663
     664<screen><userinput>( # start a subshell
     665set -e # exit the subshell in case of error
     666
     667sed -n "/Begin KDE/,/End KDE/p" qt5-submodules-&qt5-version;.md5 | \
     668                while read MD5_ENTRY; do
     669  if [ -z "${MD5_ENTRY%\#*}" ]; then continue; fi
     670  case $MD5_ENTRY in
     671     TODO) OPTIONS=
     672  esac
     673done
     674)</userinput></screen>
     675
     676  </sect2>
     677
     678  <sect2 id="qtwebengine" xreflabel="QtWebEngine">
     679    <title>QTWebEngine</title>
     680    <para>
     681      Install QtWebEngine with the following instructions:
     682    </para>
     683  </sect2>
     684
     685  <sect2 id="qt-miscellaneous" xreflabel="Other Modules">
     686    <title>Other Modules</title>
     687    <para>
     688      Install the remaining modules with the following instructions:
     689    </para>
    214690  </sect2>
    215691
    … …  
    485961    <para>
    486962      <parameter>-skip qtwebengine</parameter>: This switch disables building
    487       the QtWebEngine. The BLFS editors have chosen to build <xref
    488       linkend="qtwebengine"/> separately.
     963      the QtWebEngine. <!--The BLFS editors have chosen to build <xref
     964      linkend="qtwebengine"/> separately.-->
    489965    </para>
    490966
    … …  
    6551131      </seglistitem>
    6561132    </segmentedlist>
    657 
     1133<!--
    6581134    <variablelist>
    6591135      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    … …  
    6611137      <?dbhtml list-presentation="table"?>
    6621138
    663       <varlistentry id="assistant-qt5">
    664         <term><command>assistant</command></term>
    665         <listitem>
    666           <para>
    667             is a tool for presenting on-line documentation
    668           </para>
    669           <indexterm zone="qt5 assistant-qt5">
    670             <primary sortas="b-assistant-qt5">assistant</primary>
    671           </indexterm>
    672         </listitem>
    673       </varlistentry>
    674 
    675       <varlistentry id="balsam">
    676         <term><command>balsam</command></term>
    677         <listitem>
    678           <para>
    679             is a tool to convert 3D scenes from various creation tools
    680             to QML format, for use by the new QtQuick 3D library
    681           </para>
    682           <indexterm zone="qt5 balsam">
    683             <primary sortas="b-balsam">balsam</primary>
    684           </indexterm>
    685         </listitem>
    686       </varlistentry>
    687 
    688       <varlistentry id="canbusutil">
    689         <term><command>canbustil</command></term>
    690         <listitem>
    691           <para>
    692             is a tool to deal with arbitrary CAN bus frames.
    693             A Controller Area Network (CAN) is a vehicle bus standard designed
    694             to allow microcontrollers and devices to communicate with each other
    695             in applications without a host computer
    696           </para>
    697           <indexterm zone="qt5 canbusutil">
    698             <primary sortas="b-canbusutil">canbusutil</primary>
    699           </indexterm>
    700         </listitem>
    701       </varlistentry>
    702 
    703       <varlistentry id="designer-qt5">
    704         <term><command>designer</command></term>
    705         <listitem>
    706           <para>
    707             is a full-fledged GUI builder. It includes
    708             powerful features such as preview mode, automatic widget
    709             layout, support for custom widgets, and an advanced
    710             property editor
    711           </para>
    712           <indexterm zone="qt5 designer-qt5">
    713             <primary sortas="b-designer-qt5">designer</primary>
    714           </indexterm>
    715         </listitem>
    716       </varlistentry>
    717 
    718      <varlistentry id="fixqt4headers.pl">
    719         <term><command>fixqt4headers.pl</command></term>
    720         <listitem>
    721           <para>
    722             is a script to replace all Qt 4 style includes with Qt 5 includes
    723           </para>
    724           <indexterm zone="qt5 fixqt4headers.pl">
    725             <primary sortas="b-fixqt4headers.pl">fixqt4headers.pl</primary>
    726           </indexterm>
    727         </listitem>
    728       </varlistentry>
    729 
    7301139      <varlistentry id="lconvert-qt5">
    7311140        <term><command>lconvert</command></term>
    … …  
    8211230      </varlistentry>
    8221231
    823       <varlistentry id="moc-qt5">
    824         <term><command>moc</command></term>
    825         <listitem>
    826           <para>
    827             generates Qt meta object support code
    828           </para>
    829           <indexterm zone="qt5 moc-qt5">
    830             <primary sortas="b-moc-qt5">moc</primary>
    831           </indexterm>
    832         </listitem>
    833       </varlistentry>
    834 
    8351232      <varlistentry id="pixeltool-qt5">
    8361233        <term><command>pixeltool</command></term>
    … …  
    8581255      </varlistentry>
    8591256
    860       <varlistentry id="qdbuscpp2xml-qt5">
    861         <term><command>qdbuscpp2xml</command></term>
    862         <listitem>
    863           <para>
    864             takes a C++ source file and generates a D-Bus XML definition
    865             of the interface
    866           </para>
    867           <indexterm zone="qt5 qdbuscpp2xml-qt5">
    868             <primary sortas="b-qdbuscpp2xml-qt5">qdbuscpp2xml</primary>
    869           </indexterm>
    870         </listitem>
    871       </varlistentry>
    872 
    8731257      <varlistentry id="qdbus-qt5">
    8741258        <term><command>qdbus</command></term>
    … …  
    8921276          <indexterm zone="qt5 qdbusviewer-qt5">
    8931277            <primary sortas="b-qdbusviewer-qt5">qdbusviewer</primary>
    894           </indexterm>
    895         </listitem>
    896       </varlistentry>
    897 
    898       <varlistentry id="qdbusxml2cpp-qt5">
    899         <term><command>qdbusxml2cpp</command></term>
    900         <listitem>
    901           <para>
    902             is a tool that can be used to parse interface descriptions
    903             and produce static code representing those interfaces,
    904           </para>
    905           <indexterm zone="qt5 qdbusxml2cpp-qt5">
    906             <primary sortas="b-qdbusxml2cpp-qt5">qdbusxml2cpp</primary>
    9071278          </indexterm>
    9081279        </listitem>
    … …  
    9631334      </varlistentry>
    9641335
    965       <varlistentry id="qlalr-qt5">
    966         <term><command>qlalr</command></term>
    967         <listitem>
    968           <para>
    969             is a tool used to generate code from grammar specifications
    970           </para>
    971           <indexterm zone="qt5 qlalr-qt5">
    972             <primary sortas="b-qlalr-qt5">qlalr</primary>
    973           </indexterm>
    974         </listitem>
    975       </varlistentry>
    976 
    977       <varlistentry id="qmake-qt5">
    978         <term><command>qmake</command></term>
    979         <listitem>
    980           <para>
    981             uses information stored in project files to
    982             determine what should go in the makefiles it
    983             generates
    984           </para>
    985           <indexterm zone="qt5 qmake-qt5">
    986             <primary sortas="b-qmake-qt5">qmake</primary>
    987           </indexterm>
    988         </listitem>
    989       </varlistentry>
    990 
    9911336     <varlistentry id="qml">
    9921337        <term><command>qml</command></term>
    … …  
    11971542      </varlistentry>
    11981543
    1199       <varlistentry id="qtwaylandscanner">
    1200         <term><command>qtwaylandscanner</command></term>
    1201         <listitem>
    1202           <para>
    1203             converts Wayland specfiles to C++ headers and code needed for
    1204             QtWayland
    1205           </para>
    1206           <indexterm zone="qt5 qtwaylandscanner">
    1207             <primary sortas="b-qtwaylandscanner">qtwaylandscanner</primary>
    1208           </indexterm>
    1209         </listitem>
    1210       </varlistentry>
    1211 
    1212       <varlistentry id="qvkgen">
    1213         <term><command>qvkgen</command></term>
    1214         <listitem>
    1215           <para>
    1216             converts Vulkan specfiles to C++ headers and code
    1217           </para>
    1218           <indexterm zone="qt5 qvkgen">
    1219             <primary sortas="b-qvkgen">qvkgen</primary>
    1220           </indexterm>
    1221         </listitem>
    1222       </varlistentry>
    1223 
    1224       <varlistentry id="rcc-qt5">
    1225         <term><command>rcc</command></term>
    1226         <listitem>
    1227           <para>
    1228             is a resource compiler used in conjunction with designer
    1229           </para>
    1230           <indexterm zone="qt5 rcc-qt5">
    1231             <primary sortas="b-rcc-qt5">rcc</primary>
    1232           </indexterm>
    1233         </listitem>
    1234       </varlistentry>
    1235 
    12361544      <varlistentry id="repc">
    12371545        <term><command>repc</command></term>
    … …  
    12601568      </varlistentry>
    12611569
    1262      <varlistentry id="syncqt.pl-qt5">
    1263         <term><command>syncqt.pl</command></term>
    1264         <listitem>
    1265           <para>
    1266             is a script to create the forwarding headers in the include
    1267             directories. It is an internal development tool
    1268           </para>
    1269           <indexterm zone="qt5 syncqt.pl-qt5">
    1270             <primary sortas="b-syncqt.pl-qt5">syncqt.pl</primary>
    1271           </indexterm>
    1272         </listitem>
    1273       </varlistentry>
    1274 
    1275       <varlistentry id="tracegen">
    1276         <term><command>tracegen</command></term>
    1277         <listitem>
    1278           <para>
    1279             is a trace generator for LTTng or ETW
    1280           </para>
    1281           <indexterm zone="qt5 tracegen">
    1282             <primary sortas="b-tracegen">tracegen</primary>
    1283           </indexterm>
    1284         </listitem>
    1285       </varlistentry>
    1286 
    1287       <varlistentry id="uic-qt5">
    1288         <term><command>uic</command></term>
    1289         <listitem>
    1290           <para>
    1291             is a Qt user interface compiler
    1292           </para>
    1293           <indexterm zone="qt5 uic-qt5">
    1294             <primary sortas="b-uic-qt5">uic</primary>
    1295           </indexterm>
    1296         </listitem>
    1297       </varlistentry>
    1298 
    12991570      <varlistentry id="xmlpatterns-qt5">
    13001571        <term><command>xmlpatterns</command></term>
    … …  
    13231594
    13241595    </variablelist>
    1325 
     1596-->
    13261597  </sect2>
    13271598
Note: See TracChangeset for help on using the changeset viewer.