source: kde/plasma5/plasma-all.xml@ 0b789c7

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

  <!ENTITY plasma5-download-http "http://download.kde.org/stable/plasma5/&plasma5-version;">
  <!ENTITY plasma5-download-ftp  " ">
  <!ENTITY plasma5-md5sum        "See Below">
  <!ENTITY plasma5-size          "?? MB">
  <!ENTITY plasma5-buildsize     "?? GB">
  <!ENTITY plasma5-time          "?? SBU">
]>

<sect1 id="plasma5-build" xreflabel="Plasma-&plasma5-version;">
  <?dbhtml filename="plasma-all.html"?>

  <sect1info>
     <othername>$LastChangedBy: bdubbs $</othername>
     <date>$Date: 2015-09-24 16:44:04 -0500 (Thu, 24 Sep 2015) $</date>
  </sect1info>

  <title>Building Plasma 5</title>

  <indexterm zone="plasma5-build">
     <primary sortas="a-kf5">KDE Plasma 5</primary>
  </indexterm>

  <para>KDE Plasma 5 is a collection of packages based on top of KDE Frameworks
  5 and QML derived from the monolithic KDE 4 desktop. They implement the KDE
  Display Environment (Plasma 5).</para>

  <warning>
  
    <para>The procedures below build properly, but Plasma crashes when starting
    on some systems.  Build this only if you want to do some extensive
    C++ debugging.</para>

    <para>Additionally there are several packages not yet in the book
    and mesa will need to be rebuilt with differnet settings.  New packages are
    wayland, xcb-util-cursor, libxkbcommon, lmdb, and libinput.</para>

    <para>This page is a placeholder until the appropriate procedures can be 
    placed formally into the book.</para>

  </warning>

  <!--&lfs78_checked;-->

  <para>The instructions below build all of the Plasma 5 packages in one
  step by using a bash script.  </para>

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

  <bridgehead renderas="sect3">Plasma 5 Dependencies</bridgehead>

  <bridgehead renderas="sect4">Required</bridgehead>
  <para role="required">
    <xref linkend="kf5-frameworks"/>
  </para>


  <bridgehead renderas="sect4">Recommended</bridgehead>
  <para role="recommended">
    <!--<xref linkend="avahi"/> (DNS-SD backend for KDNSSD),-->
    To be determined.
  </para>
<!--
  <bridgehead renderas="sect4">Optional</bridgehead>
  <para role="optional">
    <xref linkend="bluez"/> (needed to build Bluez-Qt),
    <xref linkend="NetworkManager"/> (needed to build NetworkManager-Qt),
    <ulink url="http://www.freedesktop.org/software/ModemManager/">ModemManager</ulink> (needed to build ModemManager-Qt)
  </para>

  <bridgehead renderas="sect4">Runtime dependency for FrameworkIntegration</bridgehead>
  <para role="optional">
    <ulink url="http://download.kde.org/stable/plasma/5.2.0">oxygen-fonts</ulink>
  </para>

  <bridgehead renderas="sect4">Runtime dependencies for kapidox</bridgehead>
  <para role="optional">
    <xref linkend="doxygen"/>,
    <ulink url="https://pypi.python.org/packages/source/J/Jinja2/">Jinja2</ulink>, and
    <ulink url="http://pyyaml.org/">PyYAML</ulink>
  </para>

  <bridgehead renderas="sect4">Additional image formats support in KImageFormats</bridgehead>
  <para role="optional">
    <xref linkend="jasper"/> and
    <ulink url="http://www.openexr.com/">OpenEXR</ulink>
  </para>

  <bridgehead renderas="sect4">Optional dependencies for KIO</bridgehead>
  <para role="optional">
    <xref linkend="mitkrb"/>
  </para>

  <bridgehead renderas="sect4">Optional dependencies for ModemManager-QT</bridgehead>
  <para role="optional">
    <ulink url="http://www.freedesktop.org/software/ModemManager/">ModemManager</ulink>
  </para>

  <bridgehead renderas="sect4">Optional dependencies for Solid</bridgehead>
  <para role="optional">
    <xref linkend="udisks2"/>,
    <xref linkend="upower"/> and
    <ulink url="http://www.freedesktop.org/software/media-player-info/">media-player-info</ulink> (runtime)
  </para>

  <bridgehead renderas="sect4">Optional dictionary backends for Sonnet</bridgehead>
  <para role="optional">
    <ulink url="http://hspell.ivrix.org.il/">Hspell</ulink> and
    <ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>
  </para>
-->
  <para condition="html" role="usernotes">User Notes:
  <ulink url="&blfs-wiki;/kf5"/></para>

  <sect2>
    <title>Downloading KDE Frameworks</title>

    <para>
      The easiest way to get the KDE Plasma5 packages is to use a single
      <command>wget</command> to fetch them all at once:
    </para>
 
<screen><userinput>url=http://download.kde.org/stable/plasma/&plasma5-version;/
wget -r -nH --cut-dirs=3 -A '*.xz' -np $url
<literal>
The options used here are: 
  -r            recurse through child directories
  -nH           disable generation of host-prefixed directories
  --cut-dirs=3  remove three levels of directories when saving
  -A '*.xz'     just get the *.xz files
  -np           don't get parent directories</literal></userinput></screen>

   </sect2>

  <sect2>
    <title>Setting Package Order</title>

    <para>
      The order of building files is important due to internal dependencies.
      Create the list of files in the proper order as follows:
    </para>

<screen><userinput>cat &gt; plasma-&kf5-version;.md5 &lt;&lt; "EOF"
<literal>cfff87d002b42b2487b522f94f157cb7  kwayland-5.4.1.tar.xz  
bc8fd24c6ecd0948fc5adb3bda096f88  libkscreen-5.4.1.tar.xz
c48b9030d7f5e86dc1f07091c3695758  libksysguard-5.4.1.tar.xz
bd5a8def665759beab8170acd80ca53f  breeze-5.4.1.tar.xz
91e85616bd899d2a610311b2ca1de622  kwin-5.4.1.tar.xz
a56031b9600712eabcc0f6baeb8a2947  oxygen-5.4.1.tar.xz
88522f2478fdff511e02102861dab620  oxygen-fonts-5.4.1.tar.xz
99df60a8b2cc2b5c0f924a7c36cd9ad3  khelpcenter-5.4.1.tar.xz
2aab5a329f2b4b196cd3e130bdf00bc6  kinfocenter-5.4.1.tar.xz
68a6ffc478a63002cb183e64d1630d80  ksysguard-5.4.1.tar.xz
2701f56228b6b45155b35a98a4a25df7  systemsettings-5.4.1.tar.xz
0675ac84f739218cd1a17cfdc3d91e22  plasma-workspace-5.4.1.tar.xz
33eb66bcec1c7f27b1a6a7629042de8e  bluedevil-5.4.1.tar.xz
56a3a65f21fe1b78c409129dfdc48d9e  khotkeys-5.4.1.tar.xz
5533875aea1883ce0d59cd72f1b05c24  kmenuedit-5.4.1.tar.xz
2d656cd96b0910129890973c4ee01d01  kscreen-5.4.1.tar.xz
6064bd41f2a7cdbe97a5be84e1a87fe3  kwrited-5.4.1.tar.xz
030248d066c81093a954de64e51d31bf  milou-5.4.1.tar.xz
528b5d70f64450a7d6e31f55dde2b155  plasma-nm-5.4.1.tar.xz
ff82dd9fdbaaf96a25f6a23f96bce5f7  plasma-workspace-wallpapers-5.4.1.tar.xz
0e27d8c01b108aa709a130466bc56a9a  polkit-kde-agent-1-5.4.1.tar.xz
cb6b2663a3fdac63561b87a340aa91df  powerdevil-5.4.1.tar.xz
823180ad53fafca7a6be56ab3f9ec2df  plasma-desktop-5.4.1.tar.xz
d91c7633eca6bad228003a168d6789b1  kdeplasma-addons-5.4.1.tar.xz
161710cb26d5fb123be4062656124934  kwayland-integration-5.4.1.tar.xz</literal>
EOF</userinput></screen>

  </sect2>

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

    &as_root;

    <para>
      First, start a subshell that will exit on error:
    </para>


<screen><userinput>bash -e</userinput></screen>

    <para>
      Install all of the packages by running the following
      commands:
    </para>

<screen><userinput>while read -r line; do

    # Get the file name, ignoring comments and blank lines
    if $(echo $line | grep -E -q '^ *$|^#' ); then continue; fi
    file=$(echo $line | cut -d" " -f2)
    
    pkg=$(echo $file|sed 's|^.*/||')          # Remove directory
    packagedir=$(echo $pkg|sed 's|\.tar.*||') # Package directory

    tar -xf $file
    pushd $packagedir

       mkdir build
       cd    build

       cmake -DCMAKE_INSTALL_PREFIX=$KF5_PREFIX      \
             -DCMAKE_BUILD_TYPE=Debug                \
             -DLIB_INSTALL_DIR=lib                   \
             -DBUILD_TESTING=OFF                     \
             -DQML_INSTALL_DIR=lib/qt5/qml           \
             -DQT_PLUGIN_INSTALL_DIR=lib/qt5/plugins \
             -DECM_MKSPECS_INSTALL_DIR=$KF5_PREFIX/share/qt5/mkspecs/modules \
             -DOXYGEN_FONT_INSTALL_DIR=/usr/share/fonts/truetype/oxygen      \
             -Wno-dev ..  &amp;&amp;

        make
        as_root make install
    popd

    rm -rf $packagedir
    as_root /sbin/ldconfig

done &lt; plasma-&kf5-version;.md5

exit</userinput></screen>


  </sect2>

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

    <para>
      Deferred.
    </para>

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

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

      <seglistitem>
        <seg>
           Deferred
        </seg>
        <seg>
           Deferred
        </seg>
        <seg>
           Deferred
        </seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

</sect1>