Changes in / [104ff4e:811d39b]


Ignore:
Files:
1 deleted
3 edited

Legend:

Unmodified
Added
Removed

  • packages.ent

    r104ff4e r811d39b  
    722722<!ENTITY pango-version                "&pango-minor;.12">
    723723<!ENTITY pangomm-version              "2.46.3">
    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">
     724<!ENTITY qt5-version                  "5.15.7">
     725<!ENTITY qtwebengine-version          "5.15.11">
    728726<!ENTITY startup-notification-version "0.12">
    729727<!ENTITY tepl-version                 "6.4.0">

  • x/lib/lib.xml

    r104ff4e r811d39b  
    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"/>
    7574  <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

    r104ff4e r811d39b  
    55  %general-entities;
    66
    7 
    8   <!ENTITY qt5-download-http "&qt5-url;/">
     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">
    911  <!ENTITY qt5-download-ftp  " ">
    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">
     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)">
    1416]>
    1517
    … …  
    1820
    1921
    20   <title>Qt-&qt5-version; Modules</title>
     22  <title>Qt-&qt5-version;</title>
    2123
    2224  <indexterm zone="qt5">
    23     <primary sortas="a-Qt">Qt Modules</primary>
     25    <primary sortas="a-Qt">Qt</primary>
    2426  </indexterm>
    2527
    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>
     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>
    6140
    6241    &lfs112_checked;
    6342
    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>
     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>
    9776
    9877    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    … …  
    11897    </itemizedlist>
    11998
    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
    199 739403634e1326a3d52902a835015a4b  qttools-everywhere-src-5.15.2.tar.xz
    200 c0f5c1c2cc1b66e56ce4ef13a2b7093a  qtsvg-everywhere-src-5.15.2.tar.xz
    201 92cf72015788bb4dcab14494f2835b32  qtx11extras-everywhere-src-5.15.2.tar.xz
    202 26577fbbe0d011b7034bca3c64bc38ae  qtwayland-everywhere-src-5.15.2.tar.xz
    203 # End basic group
    204 # Begin KDE group
    205 db3c185d6f13fc60828f8f9f20e092c4  qtdeclarative-everywhere-src-5.15.2.tar.xz
    206 2abc5e7b8e6b4a80d7533daad37749e9  qtquickcontrols2-everywhere-src-5.15.2.tar.xz
    207 2ae1ef858425aa71d62b15467a84b022  qtgraphicaleffects-everywhere-src-5.15.2.tar.xz
    208 ef96631d72399cfa495f223ef21bb039  qtxmlpatterns-everywhere-src-5.15.2.tar.xz
    209 # TODO
    210 # End KDE group
    211 # Begin qtwebengine
    212 c88cbe3158feb20c4feb3d54262feb23  qtwebengine-everywhere-src-5.15.2.tar.xz
    213 # End qtwebengine
    214 # Begin optional group
    215 # TODO
    216 # End optional group</literal>
    217 EOF</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 
    232 export -f as_root
    233 
    234 module_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 
    268 export -f module_build</userinput></screen>
     99    <bridgehead renderas="sect3">Qt5 Dependencies</bridgehead>
     100
     101    <bridgehead renderas="sect4">Required</bridgehead>
     102    <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>
    269168  </sect2>
    270169
    271   <sect2 id="qt-basic" xreflabel="Basic Qt5 Modules">
    272     <title>Basic Qt5 Modules</title>
    273 
    274     <para role="required">
    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
    284 set -e # exit the subshell in case of error
    285 
    286 unset OPTIONS
    287 sed -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]
    314 Name=Qt5 Assistant
    315 Comment=Shows Qt5 documentation and examples
    316 Exec=$QT5BINDIR/assistant
    317 Icon=assistant-qt5.png
    318 Terminal=false
    319 Encoding=UTF-8
    320 Type=Application
    321 Categories=Qt;Development;Documentation;
    322 EOF
    323 
    324         cat &gt; /usr/share/applications/designer-qt5.desktop &lt;&lt; EOF
    325 [Desktop Entry]
    326 Name=Qt5 Designer
    327 GenericName=Interface Designer
    328 Comment=Design GUIs for Qt5 applications
    329 Exec=$QT5BINDIR/designer
    330 Icon=designer-qt5.png
    331 MimeType=application/x-designer;
    332 Terminal=false
    333 Encoding=UTF-8
    334 Type=Application
    335 Categories=Qt;Development;
    336 EOF
    337 
    338         cat &gt; /usr/share/applications/linguist-qt5.desktop &lt;&lt; EOF
    339 [Desktop Entry]
    340 Name=Qt5 Linguist
    341 Comment=Add translations to Qt5 applications
    342 Exec=$QT5BINDIR/linguist
    343 Icon=linguist-qt5.png
    344 MimeType=text/vnd.trolltech.linguist;application/x-linguist;
    345 Terminal=false
    346 Encoding=UTF-8
    347 Type=Application
    348 Categories=Qt;Development;
    349 EOF
    350 
    351         cat &gt; /usr/share/applications/qdbusviewer-qt5.desktop &lt;&lt; EOF
    352 [Desktop Entry]
    353 Name=Qt5 QDbusViewer
    354 GenericName=D-Bus Debugger
    355 Comment=Debug D-Bus applications
    356 Exec=$QT5BINDIR/qdbusviewer
    357 Icon=qdbusviewer-qt5.png
    358 Terminal=false
    359 Encoding=UTF-8
    360 Type=Application
    361 Categories=Qt;Development;Debugger;
    362 EOF
    363 ROOT_EOF
    364       }
    365       export -f post_install ;;
    366 
    367     *) unset -f post_install ;;
    368   esac
    369 
    370   module_build
    371 
    372 done
    373 #     Some packages such as vlc look for certain
    374 #     executables with a -qt5 suffix:
    375 for file in lconvert lrelease lupdate; do
    376   as_root ln -sfrvn $QT5DIR/bin/$file /usr/bin/$file-qt5
    377 done
    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>
    653   </sect2>
    654 
    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>
     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;
     195ln -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
    674214  </sect2>
    675215
    … …  
    934474    <para>
    935475      <parameter>-skip qtwebengine</parameter>: This switch disables building
    936       the QtWebEngine. <!--The BLFS editors have chosen to build <xref
    937       linkend="qtwebengine"/> separately.-->
     476      the QtWebEngine. The BLFS editors have chosen to build <xref
     477      linkend="qtwebengine"/> separately.
    938478    </para>
    939479
    … …  
    1104644      </seglistitem>
    1105645    </segmentedlist>
    1106 <!--
     646
    1107647    <variablelist>
    1108648      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    … …  
    1110650      <?dbhtml list-presentation="table"?>
    1111651
     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
    1112719      <varlistentry id="lconvert-qt5">
    1113720        <term><command>lconvert</command></term>
    … …  
    1203810      </varlistentry>
    1204811
     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
    1205824      <varlistentry id="pixeltool-qt5">
    1206825        <term><command>pixeltool</command></term>
    … …  
    1228847      </varlistentry>
    1229848
     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
    1230862      <varlistentry id="qdbus-qt5">
    1231863        <term><command>qdbus</command></term>
    … …  
    1249881          <indexterm zone="qt5 qdbusviewer-qt5">
    1250882            <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>
    1251896          </indexterm>
    1252897        </listitem>
    … …  
    1307952      </varlistentry>
    1308953
     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
    1309980     <varlistentry id="qml">
    1310981        <term><command>qml</command></term>
    … …  
    15151186      </varlistentry>
    15161187
     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
    15171225      <varlistentry id="repc">
    15181226        <term><command>repc</command></term>
    … …  
    15411249      </varlistentry>
    15421250
     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
    15431288      <varlistentry id="xmlpatterns-qt5">
    15441289        <term><command>xmlpatterns</command></term>
    … …  
    15671312
    15681313    </variablelist>
    1569 -->
     1314
    15701315  </sect2>
    15711316
Note: See TracChangeset for help on using the changeset viewer.