Changes in / [811d39b:104ff4e]


Ignore:
Files:
1 added
3 edited

Legend:

Unmodified
Added
Removed

  • packages.ent

    r811d39b r104ff4e  
    722722<!ENTITY pango-version                "&pango-minor;.12">
    723723<!ENTITY pangomm-version              "2.46.3">
    724 <!ENTITY qt5-version                  "5.15.7">
    725 <!ENTITY qtwebengine-version          "5.15.11">
     724<!ENTITY qt5-major                    "5.15">
     725<!ENTITY qt5-version                  "&qt5-major;.7">
     726<!ENTITY qt5-url "https://download.qt.io/archive/qt/&qt5-major;/&qt5-version;/submodules">
     727<!ENTITY qtwebengine-version          "&qt5-major;.11">
    726728<!ENTITY startup-notification-version "0.12">
    727729<!ENTITY tepl-version                 "6.4.0">

  • x/lib/lib.xml

    r811d39b r104ff4e  
    7272  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pangomm.xml"/>
    7373<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qscintilla.xml"/> -->
     74  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qtbase.xml"/>
    7475  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qt5.xml"/>
    75   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qtwebengine.xml"/>
    7676  <!--
    7777  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qtwebkit5.xml"/> -->

  • x/lib/qt5.xml

    r811d39b r104ff4e  
    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">
     7
     8  <!ENTITY qt5-download-http "&qt5-url;/">
    119  <!ENTITY qt5-download-ftp  " ">
    12   <!ENTITY qt5-md5sum        "b30147f4fd91c8dc1b7e61cbc7e6b8a6">
    13   <!ENTITY qt5-size          "595 MB">
    14   <!ENTITY qt5-buildsize     "15 GB (268 MB installed)">
    15   <!ENTITY qt5-time          "29 SBU (using parallelism=4)">
     10  <!ENTITY qt5-md5sum        "See below">
     11  <!ENTITY qt5-size          "11 MB for basic modules, 59 MB for qtwebengine,">
     12  <!ENTITY qt5-buildsize     "930 MB (23 MB installed) for basic modules">
     13  <!ENTITY qt5-time          "Using parallelism=4: 3.4 SBU for basic modules">
    1614]>
    1715
    … …  
    2018
    2119
    22   <title>Qt-&qt5-version;</title>
     20  <title>Qt-&qt5-version; Modules</title>
    2321
    2422  <indexterm zone="qt5">
    25     <primary sortas="a-Qt">Qt</primary>
     23    <primary sortas="a-Qt">Qt Modules</primary>
    2624  </indexterm>
    2725
    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>
     26  <para>
     27    After the <xref linkend="qtbase"/> has been installed, various modules
     28    can be added to provide more functionalities. They are divided in several
     29    groups, each of which depends on the precedent:
     30  </para>
     31
     32  <itemizedlist spacing="compact">
     33    <listitem>
     34      <para>
     35        <xref linkend="qt-basic"/> are used in almost all
     36        <application>Qt5</application> based applications, and
     37        must be built first.
     38      </para>
     39    </listitem>
     40    <listitem>
     41      <para>
     42        <xref linkend="qt-kde"/> are needed for
     43        <xref linkend="kf5-frameworks"/> and <xref linkend="plasma5-build"/>.
     44      </para>
     45    </listitem>
     46    <listitem>
     47      <para>
     48        <xref linkend="qtwebengine"/> is a huge module that integrates
     49        <application>chromium</application>'s web capabilities into
     50        <application>Qt5</application>
     51      </para>
     52    </listitem>
     53    <listitem>
     54      <para>
     55        <xref linkend="qt-miscellaneous"/> are not needed for building
     56        packages in the book, but can be built for a complete installation
     57        of <application>Qt5</application>
     58      </para>
     59    </listitem>
     60  </itemizedlist>
    4061
    4162    &lfs112_checked;
    4263
    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>
     64  <bridgehead renderas="sect3">Package Information</bridgehead>
     65  <itemizedlist spacing="compact">
     66    <listitem>
     67      <para>
     68        Download (HTTP): <ulink url="&qt5-download-http;"/>
     69      </para>
     70    </listitem>
     71    <listitem>
     72      <para>
     73        Download (FTP): <ulink url="&qt5-download-ftp;"/>
     74      </para>
     75    </listitem>
     76    <listitem>
     77      <para>
     78        Download MD5 sum: &qt5-md5sum;
     79      </para>
     80    </listitem>
     81    <listitem>
     82      <para>
     83        Download size: &qt5-size;
     84      </para>
     85    </listitem>
     86    <listitem>
     87      <para>
     88        Estimated disk space required: &qt5-buildsize;
     89      </para>
     90    </listitem>
     91    <listitem>
     92      <para>
     93        Estimated build time: &qt5-time;
     94      </para>
     95    </listitem>
     96  </itemizedlist>
    7697
    7798    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    … …  
    97118    </itemizedlist>
    98119
    99     <bridgehead renderas="sect3">Qt5 Dependencies</bridgehead>
    100 
    101     <bridgehead renderas="sect4">Required</bridgehead>
     120<!--
     121  <bridgehead renderas="sect3">Qt5 Dependencies</bridgehead>
     122
     123  <bridgehead renderas="sect4">Required</bridgehead>
     124  <para role="required">
     125    <xref linkend="xorg7-lib"/>
     126  </para>
     127
     128  <bridgehead renderas="sect4">Recommended</bridgehead>
     129  <para role="recommended">
     130    <xref linkend="alsa-lib"/>,
     131    <xref linkend="make-ca"/>,
     132    <xref linkend="cups"/>,
     133    <xref linkend="glib2"/>,
     134    <xref linkend="gst10-plugins-base"/> (QtMultimedia backend),
     135    <xref linkend="harfbuzz"/>,
     136    <xref linkend="icu"/>,
     137    <xref linkend="jasper"/>,
     138    <xref linkend="libjpeg"/>,
     139    <xref linkend="libmng"/>,
     140    <xref linkend="libpng"/>,
     141    <xref linkend="libtiff"/>,
     142    <xref linkend="libwebp"/>,
     143    <xref linkend="libxkbcommon"/>,
     144    <xref linkend="mesa"/>,
     145    <xref linkend="mitkrb"/>,
     146    <xref linkend="mtdev"/>,
     147    <xref linkend="pcre2"/>,
     148    <xref linkend="sqlite"/>,
     149    <xref linkend="wayland"/> (<application>Mesa</application>
     150    must be built with <application>Wayland</application> EGL
     151    backend),
     152    <xref linkend="xcb-util-image"/>,
     153    <xref linkend="xcb-util-keysyms"/>,
     154    <xref linkend="xcb-util-renderutil"/>, and
     155    <xref linkend="xcb-util-wm"/>
     156  </para>
     157
     158  <bridgehead renderas="sect4">Optional</bridgehead>
     159  <para role="optional">
     160    <xref role="runtime" linkend="bluez"/> (for sdpscanner, and at runtime for
     161    QtConnectivity module),
     162    <xref linkend="ibus"/>,
     163    <xref linkend="libinput"/>, <!- - needs -libinput switch - ->
     164    <xref linkend="mariadb"/>
     165      or <ulink url="http://www.mysql.com/">MySQL</ulink>,
     166    <xref linkend="pciutils"/> (required for QtWebEngine),
     167    <xref linkend="postgresql"/>,
     168    <xref linkend="python2"/> (required for QtWebEngine),
     169    <xref linkend="pulseaudio"/>,
     170    <xref linkend="sdl2"/>,
     171    <xref linkend="unixodbc"/>,
     172    <ulink url="https://www.assimp.org/">assimp</ulink>,
     173    <ulink url="http://www.festvox.org/flite/">Flite</ulink>,
     174    <ulink url="http://www.firebirdsql.org/">Firebird</ulink>,
     175    <ulink url="http://www.freetds.org/">FreeTDS</ulink>,
     176    <ulink url="https://libproxy.github.io/libproxy/">libproxy</ulink>,
     177    <ulink url="https://openal.org/">OpenAL</ulink>,
     178    <ulink url="https://freebsoft.org/speechd/">speech-dispatcher</ulink>,
     179    <ulink url="http:///www.tslib.org/">tslib</ulink>, and
     180    <ulink url="https://vulkan.lunarg.com/sdk/home/">Vulkan</ulink>
     181  </para>
     182
     183  <!- - Many of the dependencies in the qmake/configure output do not apply
     184       to Linux-based platforms. I've selected the ones that do and put
     185       them in as optional dependencies. -renodr - ->
     186  <para condition="html" role="usernotes">
     187     User Notes: <ulink url="&blfs-wiki;/qt5"/>
     188  </para>
     189-->
     190  <sect2>
     191    <title>Creating the module list and utility functions</title>
     192
     193    <para>
     194      Create the list of modules in the proper order as follows:
     195    </para>
     196
     197<screen><userinput>cat &gt; qt5-submodules-&qt5-version;.md5 &lt;&lt; "EOF"
     198<literal># Begin basic group
     199739403634e1326a3d52902a835015a4b  qttools-everywhere-src-5.15.2.tar.xz
     200c0f5c1c2cc1b66e56ce4ef13a2b7093a  qtsvg-everywhere-src-5.15.2.tar.xz
     20192cf72015788bb4dcab14494f2835b32  qtx11extras-everywhere-src-5.15.2.tar.xz
     20226577fbbe0d011b7034bca3c64bc38ae  qtwayland-everywhere-src-5.15.2.tar.xz
     203# End basic group
     204# Begin KDE group
     205db3c185d6f13fc60828f8f9f20e092c4  qtdeclarative-everywhere-src-5.15.2.tar.xz
     2062abc5e7b8e6b4a80d7533daad37749e9  qtquickcontrols2-everywhere-src-5.15.2.tar.xz
     2072ae1ef858425aa71d62b15467a84b022  qtgraphicaleffects-everywhere-src-5.15.2.tar.xz
     208ef96631d72399cfa495f223ef21bb039  qtxmlpatterns-everywhere-src-5.15.2.tar.xz
     209# TODO
     210# End KDE group
     211# Begin qtwebengine
     212c88cbe3158feb20c4feb3d54262feb23  qtwebengine-everywhere-src-5.15.2.tar.xz
     213# End qtwebengine
     214# Begin optional group
     215# TODO
     216# End optional group</literal>
     217EOF</userinput></screen>
     218
     219    <para>
     220      Next create two utility functions, one for switching to user
     221      <systemitem class="username">root</systemitem>, the other for
     222      module building:
     223    </para>
     224
     225<screen><userinput>as_root() {
     226  if   [ "$EUID" = 0 ];      then $*
     227  elif [ -x /usr/bin/sudo ]; then sudo -E $*
     228  else                            su -c \\"$*\\"
     229  fi
     230}
     231
     232export -f as_root
     233
     234module_build() {
     235  # MD5_ENTRY contains the md5sum entry from the .md5 file for this module
     236  echo $MD5_ENTRY | {
     237    read md5 tarball
     238
     239    # download
     240    wget &qt5-download-http;$tarball
     241    md5sum -c - &lt;&lt;&lt; "$MD5_ENTRY" || exit 1
     242
     243    packagedir=${tarball%.tar*}
     244
     245    tar -xf $tarball
     246    pushd $packagedir
     247    # OPTIONS contains the qmake options
     248      if [ -n "$OPTIONS" ]; then
     249        qmake -- $OPTIONS
     250      else
     251        qmake
     252      fi
     253      make
     254      as_root make install
     255      if type -p post_install; then post_install; fi
     256    popd
     257
     258    rm -rf $packagedir
     259  }
     260  as_root /sbin/ldconfig
     261
     262  #   Remove references to the build directory from installed library
     263  #   dependency (prl) files:
     264  as_root find $QT5DIR/ -name \*.prl \
     265             -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;
     266}
     267
     268export -f module_build</userinput></screen>
     269  </sect2>
     270
     271  <sect2 id="qt-basic" xreflabel="Basic Qt5 Modules">
     272    <title>Basic Qt5 Modules</title>
     273
    102274    <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="http://www.festvox.org/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>
     275      The modules in this group only depend on <xref linkend="qtbase"/>
     276      and a properly set <envar>QT5DIR</envar> environment variable.
     277    </para>
     278
     279    <para>
     280      Install the basic modules with the following instructions:
     281    </para>
     282
     283<screen><userinput>( # start a subshell
     284set -e # exit the subshell in case of error
     285
     286unset OPTIONS
     287sed -n "/Begin basic/,/End basic/p" qt5-submodules-&qt5-version;.md5 | \
     288                while read MD5_ENTRY; do
     289  if [ -z "${MD5_ENTRY%\#*}" ]; then continue; fi
     290  case "$MD5_ENTRY" in
     291    *qttools*)
     292      post_install(){
     293        QT5BINDIR=$QT5DIR/bin
     294
     295        as_root sh &lt;&lt; ROOT_EOF
     296        install -v -dm755 /usr/share/pixmaps/
     297
     298        install -v -Dm644 src/assistant/assistant/images/assistant-128.png \
     299                  /usr/share/pixmaps/assistant-qt5.png
     300
     301        install -v -Dm644 src/designer/src/designer/images/designer.png \
     302                  /usr/share/pixmaps/designer-qt5.png
     303
     304        install -v -Dm644 src/linguist/linguist/images/icons/linguist-128-32.png \
     305                  /usr/share/pixmaps/linguist-qt5.png
     306
     307        install -v -Dm644 src/qdbus/qdbusviewer/images/qdbusviewer-128.png \
     308                  /usr/share/pixmaps/qdbusviewer-qt5.png
     309
     310        install -dm755 /usr/share/applications
     311
     312        cat &gt; /usr/share/applications/assistant-qt5.desktop &lt;&lt; EOF
     313[Desktop Entry]
     314Name=Qt5 Assistant
     315Comment=Shows Qt5 documentation and examples
     316Exec=$QT5BINDIR/assistant
     317Icon=assistant-qt5.png
     318Terminal=false
     319Encoding=UTF-8
     320Type=Application
     321Categories=Qt;Development;Documentation;
     322EOF
     323
     324        cat &gt; /usr/share/applications/designer-qt5.desktop &lt;&lt; EOF
     325[Desktop Entry]
     326Name=Qt5 Designer
     327GenericName=Interface Designer
     328Comment=Design GUIs for Qt5 applications
     329Exec=$QT5BINDIR/designer
     330Icon=designer-qt5.png
     331MimeType=application/x-designer;
     332Terminal=false
     333Encoding=UTF-8
     334Type=Application
     335Categories=Qt;Development;
     336EOF
     337
     338        cat &gt; /usr/share/applications/linguist-qt5.desktop &lt;&lt; EOF
     339[Desktop Entry]
     340Name=Qt5 Linguist
     341Comment=Add translations to Qt5 applications
     342Exec=$QT5BINDIR/linguist
     343Icon=linguist-qt5.png
     344MimeType=text/vnd.trolltech.linguist;application/x-linguist;
     345Terminal=false
     346Encoding=UTF-8
     347Type=Application
     348Categories=Qt;Development;
     349EOF
     350
     351        cat &gt; /usr/share/applications/qdbusviewer-qt5.desktop &lt;&lt; EOF
     352[Desktop Entry]
     353Name=Qt5 QDbusViewer
     354GenericName=D-Bus Debugger
     355Comment=Debug D-Bus applications
     356Exec=$QT5BINDIR/qdbusviewer
     357Icon=qdbusviewer-qt5.png
     358Terminal=false
     359Encoding=UTF-8
     360Type=Application
     361Categories=Qt;Development;Debugger;
     362EOF
     363ROOT_EOF
     364      }
     365      export -f post_install ;;
     366
     367    *) unset -f post_install ;;
     368  esac
     369
     370  module_build
     371
     372done
     373#     Some packages such as vlc look for certain
     374#     executables with a -qt5 suffix:
     375for file in lconvert lrelease lupdate; do
     376  as_root ln -sfrvn $QT5DIR/bin/$file /usr/bin/$file-qt5
     377done
     378
     379)</userinput></screen>
     380
     381    <sect3 role="content">
     382      <title>Contents of basic modules</title>
     383
     384      <segmentedlist>
     385        <segtitle>Installed Programs</segtitle>
     386        <segtitle>Installed Libraries</segtitle>
     387        <segtitle>Installed Directories</segtitle>
     388
     389        <seglistitem>
     390          <seg>
     391            assistant,
     392            designer,
     393            lconvert,
     394            linguist,
     395            lprodump,
     396            lrelease,
     397            lrelease-pro,
     398            lupdate,
     399            lupdate-pro,
     400            pixeltool,
     401            qcollectiongenerator,
     402            qdbus,
     403            qdbusviewer,
     404            qdoc,
     405            qhelpgenerator,
     406            qtattributionsscanner,
     407            qtdiag,
     408            qtpaths,
     409            qtplugininfo, and
     410            qtwaylandscanner
     411          </seg>
     412          <seg>
     413            libQt5DesignerComponents.so,
     414            libQt5Designer.so,
     415            libQt5Help.so,
     416            libQt5Svg.so,
     417            libQt5WaylandClient.so,
     418            libQt5WaylandCompositor.so, and
     419            libQt5X11Extras.so
     420          </seg>
     421          <seg>
     422            $QT5DIR/phrasebooks,
     423            $QT5DIR/include/{QtUiTools,QtHelp,QtDesigner,QtX11Extras,QtSvg},
     424            $QT5DIR/include/{QtWaylandCompositor,QtWaylandClient},
     425            $QT5DIR/include/{QtDesignerComponents,QtUiPlugin},
     426            $QT5DIR/lib/cmake/{Qt5AttributionsScannerTools,Qt5Help,Qt5Designer},
     427            $QT5DIR/lib/cmake/{Qt5X11Extras,Qt5Svg,Qt5UiTools,Qt5DocTools},
     428            $QT5DIR/lib/cmake/{Qt5WaylandCompositor,Qt5WaylandClient},
     429            $QT5DIR/lib/cmake/{Qt5DesignerComponents,Qt5UiPlugin},
     430            $QT5DIR/lib/cmake/Qt5LinguistTools,
     431            $QT5DIR/plugins/wayland-graphics-integration-client,
     432            $QT5DIR/plugins/wayland-graphics-integration-server,
     433            $QT5DIR/plugins/wayland-decoration-client, and
     434            $QT5DIR/plugins/iconengines
     435          </seg>
     436        </seglistitem>
     437      </segmentedlist>
     438
     439      <variablelist>
     440        <bridgehead renderas="sect4">Short Descriptions</bridgehead>
     441        <?dbfo list-presentation="list"?>
     442        <?dbhtml list-presentation="table"?>
     443
     444        <varlistentry id="lconvert-qt5">
     445          <term><command>lconvert</command></term>
     446          <listitem>
     447            <para>
     448              is part of Qt5's Linguist tool chain. It can be used as a
     449              standalone tool to convert and filter translation data files.
     450            </para>
     451            <indexterm zone="qt5 lconvert-qt5">
     452              <primary sortas="b-lconvert-qt5">lconvert</primary>
     453            </indexterm>
     454          </listitem>
     455        </varlistentry>
     456
     457        <varlistentry id="linguist-qt5">
     458          <term><command>linguist</command></term>
     459          <listitem>
     460            <para>
     461              provides support for translating applications into
     462              local languages.
     463            </para>
     464            <indexterm zone="qt5 linguist-qt5">
     465              <primary sortas="b-linguist-qt5">linguist</primary>
     466            </indexterm>
     467          </listitem>
     468        </varlistentry>
     469
     470        <varlistentry id="lrelease-qt5">
     471          <term><command>lrelease</command></term>
     472          <listitem>
     473            <para>
     474              is a simple command line tool. It reads XML-based translation
     475              file in TS format and produces message files used by the
     476              application.
     477            </para>
     478            <indexterm zone="qt5 lrelease-qt5">
     479              <primary sortas="b-lrelease-qt5">lrelease</primary>
     480            </indexterm>
     481          </listitem>
     482        </varlistentry>
     483
     484        <varlistentry id="lrelease-pro">
     485          <term><command>lrelease-pro</command></term>
     486          <listitem>
     487            <para>
     488              extracts project information from qmake projects and passes
     489              it to lrelease.
     490            </para>
     491            <indexterm zone="qt5 lrelease-pro">
     492              <primary sortas="b-lrelease-pro">lrelease-pro</primary>
     493            </indexterm>
     494          </listitem>
     495        </varlistentry>
     496
     497        <varlistentry id="lupdate-qt5">
     498          <term><command>lupdate</command></term>
     499          <listitem>
     500            <para>
     501              finds the translatable
     502              strings in the specified source, header and Qt Designer
     503              interface files, and stores the extracted messages in
     504              translation files to be processed by lrelease.
     505            </para>
     506            <indexterm zone="qt5 lupdate-qt5">
     507              <primary sortas="b-lupdate-qt5">lupdate</primary>
     508            </indexterm>
     509          </listitem>
     510        </varlistentry>
     511
     512        <varlistentry id="lupdate-pro">
     513          <term><command>lupdate-pro</command></term>
     514          <listitem>
     515            <para>
     516              reads a Qt project file, an passes the collected information
     517              to lupdate.
     518            </para>
     519            <indexterm zone="qt5 lupdate-pro">
     520              <primary sortas="b-lupdate-pro">lupdate-pro</primary>
     521            </indexterm>
     522          </listitem>
     523        </varlistentry>
     524
     525        <varlistentry id="pixeltool-qt5">
     526          <term><command>pixeltool</command></term>
     527          <listitem>
     528            <para>
     529              is a desktop magnifier and as you move your mouse around
     530              the screen it will show the magnified contents in its window.
     531            </para>
     532            <indexterm zone="qt5 pixeltool-qt5">
     533              <primary sortas="b-pixeltool-qt5">pixeltool</primary>
     534            </indexterm>
     535          </listitem>
     536        </varlistentry>
     537
     538        <varlistentry id="qcollectiongenerator-qt5">
     539          <term><command>qcollectiongenerator</command></term>
     540          <listitem>
     541            <para>
     542              processes and converts Qt help files.
     543            </para>
     544            <indexterm zone="qt5 qcollectiongenerator-qt5">
     545              <primary sortas="b-qcollectiongenerator-qt5">qcollectiongenerator-qt5</primary>
     546            </indexterm>
     547          </listitem>
     548        </varlistentry>
     549
     550        <varlistentry id="qdbus-qt5">
     551          <term><command>qdbus</command></term>
     552          <listitem>
     553            <para>
     554              lists available services, object paths,  methods, signals, and
     555              properties of objects on a bus.
     556            </para>
     557            <indexterm zone="qt5 qdbus-qt5">
     558              <primary sortas="b-qdbus-qt5">qdbus</primary>
     559            </indexterm>
     560          </listitem>
     561        </varlistentry>
     562
     563        <varlistentry id="qdbusviewer-qt5">
     564          <term><command>qdbusviewer</command></term>
     565          <listitem>
     566            <para>
     567              is a graphical D-Bus browser.
     568            </para>
     569            <indexterm zone="qt5 qdbusviewer-qt5">
     570              <primary sortas="b-qdbusviewer-qt5">qdbusviewer</primary>
     571            </indexterm>
     572          </listitem>
     573        </varlistentry>
     574
     575        <varlistentry id="qdoc-qt5">
     576          <term><command>qdoc</command></term>
     577          <listitem>
     578            <para>
     579              is a tool used by <application>Qt</application> Developers to
     580              generate documentation for software projects.
     581            </para>
     582            <indexterm zone="qt5 qdoc-qt5">
     583              <primary sortas="b-qdoc-qt5">qdoc</primary>
     584            </indexterm>
     585          </listitem>
     586        </varlistentry>
     587
     588        <varlistentry id="qhelpgenerator-qt5">
     589          <term><command>qhelpgenerator</command></term>
     590          <listitem>
     591            <para>
     592              is a tool used to generate a <application>Qt</application>
     593              compressed help file.
     594            </para>
     595            <indexterm zone="qt5 qhelpgenerator-qt5">
     596              <primary sortas="b-qhelpgenerator-qt5">qhelpgenerator</primary>
     597            </indexterm>
     598          </listitem>
     599        </varlistentry>
     600
     601        <varlistentry id="qtattributionsscanner-qt5">
     602          <term><command>qtattributionsscanner</command></term>
     603          <listitem>
     604            <para>
     605              processes qt_attribution.json files in Qt sources.
     606            </para>
     607            <indexterm zone="qt5 qtattributionsscanner-qt5">
     608              <primary sortas="b-qtattributionsscanner-qt5">qtattributionsscanner</primary>
     609            </indexterm>
     610          </listitem>
     611        </varlistentry>
     612
     613        <varlistentry id="qtdiag-qt5">
     614          <term><command>qtdiag</command></term>
     615          <listitem>
     616            <para>
     617              is a tool for reporting diagnostic information about Qt and its
     618              environment.
     619            </para>
     620            <indexterm zone="qt5 qtdiag-qt5">
     621              <primary sortas="b-qtdiag-qt5">qtdiag</primary>
     622            </indexterm>
     623          </listitem>
     624        </varlistentry>
     625
     626        <varlistentry id="qtpaths-qt5">
     627          <term><command>qtpaths</command></term>
     628          <listitem>
     629            <para>
     630              is a tool to query Qt path information.
     631            </para>
     632            <indexterm zone="qt5 qtpaths-qt5">
     633              <primary sortas="b-qtpaths-qt5">qtpaths</primary>
     634            </indexterm>
     635          </listitem>
     636        </varlistentry>
     637
     638        <varlistentry id="qtplugininfo">
     639          <term><command>qtplugininfo</command></term>
     640          <listitem>
     641            <para>
     642              dumps meta-data about Qt plugins in JSON format.
     643            </para>
     644            <indexterm zone="qt5 qtplugininfo">
     645              <primary sortas="b-qtplugininfo">qtplugininfo</primary>
     646            </indexterm>
     647          </listitem>
     648        </varlistentry>
     649
     650      </variablelist>
     651
     652    </sect3>
    168653  </sect2>
    169654
    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 
     655  <sect2 id="qt-kde" xreflabel="Modules Needed for KDE">
     656    <title>Modules Needed for KDE</title>
     657    <para>
     658      Install the modules needed for KDE with the following instructions:
     659    </para>
     660  </sect2>
     661
     662  <sect2 id="qtwebengine" xreflabel="QtWebEngine">
     663    <title>QTWebEngine</title>
     664    <para>
     665      Install QtWebEngine with the following instructions:
     666    </para>
     667  </sect2>
     668
     669  <sect2 id="qt-miscellaneous" xreflabel="Other Modules">
     670    <title>Other Modules</title>
     671    <para>
     672      Install the remaining modules with the following instructions:
     673    </para>
    214674  </sect2>
    215675
    … …  
    474934    <para>
    475935      <parameter>-skip qtwebengine</parameter>: This switch disables building
    476       the QtWebEngine. The BLFS editors have chosen to build <xref
    477       linkend="qtwebengine"/> separately.
     936      the QtWebEngine. <!--The BLFS editors have chosen to build <xref
     937      linkend="qtwebengine"/> separately.-->
    478938    </para>
    479939
    … …  
    6441104      </seglistitem>
    6451105    </segmentedlist>
    646 
     1106<!--
    6471107    <variablelist>
    6481108      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    … …  
    6501110      <?dbhtml list-presentation="table"?>
    6511111
    652       <varlistentry id="assistant-qt5">
    653         <term><command>assistant</command></term>
    654         <listitem>
    655           <para>
    656             is a tool for presenting on-line documentation
    657           </para>
    658           <indexterm zone="qt5 assistant-qt5">
    659             <primary sortas="b-assistant-qt5">assistant</primary>
    660           </indexterm>
    661         </listitem>
    662       </varlistentry>
    663 
    664       <varlistentry id="balsam">
    665         <term><command>balsam</command></term>
    666         <listitem>
    667           <para>
    668             is a tool to convert 3D scenes from various creation tools
    669             to QML format, for use by the new QtQuick 3D library
    670           </para>
    671           <indexterm zone="qt5 balsam">
    672             <primary sortas="b-balsam">balsam</primary>
    673           </indexterm>
    674         </listitem>
    675       </varlistentry>
    676 
    677       <varlistentry id="canbusutil">
    678         <term><command>canbustil</command></term>
    679         <listitem>
    680           <para>
    681             is a tool to deal with arbitrary CAN bus frames.
    682             A Controller Area Network (CAN) is a vehicle bus standard designed
    683             to allow microcontrollers and devices to communicate with each other
    684             in applications without a host computer
    685           </para>
    686           <indexterm zone="qt5 canbusutil">
    687             <primary sortas="b-canbusutil">canbusutil</primary>
    688           </indexterm>
    689         </listitem>
    690       </varlistentry>
    691 
    692       <varlistentry id="designer-qt5">
    693         <term><command>designer</command></term>
    694         <listitem>
    695           <para>
    696             is a full-fledged GUI builder. It includes
    697             powerful features such as preview mode, automatic widget
    698             layout, support for custom widgets, and an advanced
    699             property editor
    700           </para>
    701           <indexterm zone="qt5 designer-qt5">
    702             <primary sortas="b-designer-qt5">designer</primary>
    703           </indexterm>
    704         </listitem>
    705       </varlistentry>
    706 
    707      <varlistentry id="fixqt4headers.pl">
    708         <term><command>fixqt4headers.pl</command></term>
    709         <listitem>
    710           <para>
    711             is a script to replace all Qt 4 style includes with Qt 5 includes
    712           </para>
    713           <indexterm zone="qt5 fixqt4headers.pl">
    714             <primary sortas="b-fixqt4headers.pl">fixqt4headers.pl</primary>
    715           </indexterm>
    716         </listitem>
    717       </varlistentry>
    718 
    7191112      <varlistentry id="lconvert-qt5">
    7201113        <term><command>lconvert</command></term>
    … …  
    8101203      </varlistentry>
    8111204
    812       <varlistentry id="moc-qt5">
    813         <term><command>moc</command></term>
    814         <listitem>
    815           <para>
    816             generates Qt meta object support code
    817           </para>
    818           <indexterm zone="qt5 moc-qt5">
    819             <primary sortas="b-moc-qt5">moc</primary>
    820           </indexterm>
    821         </listitem>
    822       </varlistentry>
    823 
    8241205      <varlistentry id="pixeltool-qt5">
    8251206        <term><command>pixeltool</command></term>
    … …  
    8471228      </varlistentry>
    8481229
    849       <varlistentry id="qdbuscpp2xml-qt5">
    850         <term><command>qdbuscpp2xml</command></term>
    851         <listitem>
    852           <para>
    853             takes a C++ source file and generates a D-Bus XML definition
    854             of the interface
    855           </para>
    856           <indexterm zone="qt5 qdbuscpp2xml-qt5">
    857             <primary sortas="b-qdbuscpp2xml-qt5">qdbuscpp2xml</primary>
    858           </indexterm>
    859         </listitem>
    860       </varlistentry>
    861 
    8621230      <varlistentry id="qdbus-qt5">
    8631231        <term><command>qdbus</command></term>
    … …  
    8811249          <indexterm zone="qt5 qdbusviewer-qt5">
    8821250            <primary sortas="b-qdbusviewer-qt5">qdbusviewer</primary>
    883           </indexterm>
    884         </listitem>
    885       </varlistentry>
    886 
    887       <varlistentry id="qdbusxml2cpp-qt5">
    888         <term><command>qdbusxml2cpp</command></term>
    889         <listitem>
    890           <para>
    891             is a tool that can be used to parse interface descriptions
    892             and produce static code representing those interfaces,
    893           </para>
    894           <indexterm zone="qt5 qdbusxml2cpp-qt5">
    895             <primary sortas="b-qdbusxml2cpp-qt5">qdbusxml2cpp</primary>
    8961251          </indexterm>
    8971252        </listitem>
    … …  
    9521307      </varlistentry>
    9531308
    954       <varlistentry id="qlalr-qt5">
    955         <term><command>qlalr</command></term>
    956         <listitem>
    957           <para>
    958             is a tool used to generate code from grammar specifications
    959           </para>
    960           <indexterm zone="qt5 qlalr-qt5">
    961             <primary sortas="b-qlalr-qt5">qlalr</primary>
    962           </indexterm>
    963         </listitem>
    964       </varlistentry>
    965 
    966       <varlistentry id="qmake-qt5">
    967         <term><command>qmake</command></term>
    968         <listitem>
    969           <para>
    970             uses information stored in project files to
    971             determine what should go in the makefiles it
    972             generates
    973           </para>
    974           <indexterm zone="qt5 qmake-qt5">
    975             <primary sortas="b-qmake-qt5">qmake</primary>
    976           </indexterm>
    977         </listitem>
    978       </varlistentry>
    979 
    9801309     <varlistentry id="qml">
    9811310        <term><command>qml</command></term>
    … …  
    11861515      </varlistentry>
    11871516
    1188       <varlistentry id="qtwaylandscanner">
    1189         <term><command>qtwaylandscanner</command></term>
    1190         <listitem>
    1191           <para>
    1192             converts Wayland specfiles to C++ headers and code needed for
    1193             QtWayland
    1194           </para>
    1195           <indexterm zone="qt5 qtwaylandscanner">
    1196             <primary sortas="b-qtwaylandscanner">qtwaylandscanner</primary>
    1197           </indexterm>
    1198         </listitem>
    1199       </varlistentry>
    1200 
    1201       <varlistentry id="qvkgen">
    1202         <term><command>qvkgen</command></term>
    1203         <listitem>
    1204           <para>
    1205             converts Vulkan specfiles to C++ headers and code
    1206           </para>
    1207           <indexterm zone="qt5 qvkgen">
    1208             <primary sortas="b-qvkgen">qvkgen</primary>
    1209           </indexterm>
    1210         </listitem>
    1211       </varlistentry>
    1212 
    1213       <varlistentry id="rcc-qt5">
    1214         <term><command>rcc</command></term>
    1215         <listitem>
    1216           <para>
    1217             is a resource compiler used in conjunction with designer
    1218           </para>
    1219           <indexterm zone="qt5 rcc-qt5">
    1220             <primary sortas="b-rcc-qt5">rcc</primary>
    1221           </indexterm>
    1222         </listitem>
    1223       </varlistentry>
    1224 
    12251517      <varlistentry id="repc">
    12261518        <term><command>repc</command></term>
    … …  
    12491541      </varlistentry>
    12501542
    1251      <varlistentry id="syncqt.pl-qt5">
    1252         <term><command>syncqt.pl</command></term>
    1253         <listitem>
    1254           <para>
    1255             is a script to create the forwarding headers in the include
    1256             directories. It is an internal development tool
    1257           </para>
    1258           <indexterm zone="qt5 syncqt.pl-qt5">
    1259             <primary sortas="b-syncqt.pl-qt5">syncqt.pl</primary>
    1260           </indexterm>
    1261         </listitem>
    1262       </varlistentry>
    1263 
    1264       <varlistentry id="tracegen">
    1265         <term><command>tracegen</command></term>
    1266         <listitem>
    1267           <para>
    1268             is a trace generator for LTTng or ETW
    1269           </para>
    1270           <indexterm zone="qt5 tracegen">
    1271             <primary sortas="b-tracegen">tracegen</primary>
    1272           </indexterm>
    1273         </listitem>
    1274       </varlistentry>
    1275 
    1276       <varlistentry id="uic-qt5">
    1277         <term><command>uic</command></term>
    1278         <listitem>
    1279           <para>
    1280             is a Qt user interface compiler
    1281           </para>
    1282           <indexterm zone="qt5 uic-qt5">
    1283             <primary sortas="b-uic-qt5">uic</primary>
    1284           </indexterm>
    1285         </listitem>
    1286       </varlistentry>
    1287 
    12881543      <varlistentry id="xmlpatterns-qt5">
    12891544        <term><command>xmlpatterns</command></term>
    … …  
    13121567
    13131568    </variablelist>
    1314 
     1569-->
    13151570  </sect2>
    13161571
Note: See TracChangeset for help on using the changeset viewer.