source: kde/core/kdelibs.xml@ 69138677

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

  <!ENTITY kdelibs-download-http "&kde-download-http;&kde-version;/src/kdelibs-&kde-version;.tar.xz">
  <!ENTITY kdelibs-download-ftp  "&kde-download-ftp;&kde-version;/src/kdelibs-&kde-version;.tar.xz">
  <!ENTITY kdelibs-md5sum        "2155d7ae075a1c7e9c6398b381c67177">
  <!ENTITY kdelibs-size          "12 MB">
  <!ENTITY kdelibs-buildsize     "390 MB">
  <!ENTITY kdelibs-time          "24 SBU">
]>

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

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

  <title>Kdelibs-&kde-version;</title>

  <indexterm zone="kdelibs">
    <primary sortas="a-kdelibs">kdelibs</primary>
  </indexterm>

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

    <para>This package includes programs and libraries that 
    are central to development and execution of KDE programs.</para>

    &lfs72_checked;

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

<!--
    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing='compact'>
      <listitem>
        <para>Required patch: <ulink
        url="&patch-root;/kde4libs-&kde-version;-fixes-1.patch"/></para>
      </listitem>
    </itemizedlist>
-->
    <bridgehead renderas="sect3">Kdelibs Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
    <xref linkend="phonon"/>,  
    <xref linkend="attica"/>, 
    <xref linkend="soprano"/>, 
    <xref linkend="strigi"/>, 
    <xref linkend="qca"/>, 
    <xref linkend="libdbusmenu-qt"/>, 
    <xref linkend="DocBook"/>, 
    <xref linkend="docbook-xsl"/>, 
    <xref linkend="shared-desktop-ontologies"/> and
    <xref linkend="shared-mime-info"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
    <xref linkend="polkit-qt"/>, 
    <xref linkend="libpng"/>, 
    <xref linkend="libjpeg"/>, 
    <xref linkend="giflib"/>, 
    <xref linkend="upower"/> and
    <xref linkend="udisks"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
    <xref linkend="jasper"/>, 
    <xref linkend="pcre"/>, 
    <xref linkend="avahi"/>, 
    <xref linkend="openssl"/>, 
    <xref linkend="acl"/>, 
    <xref linkend="aspell"/>, 
    <xref linkend="enchant"/>, 
    <ulink url="http://hspell.ivrix.org.il/">Hspell</ulink>, 
    <ulink url="http://www.gitorious.org/grantlee/pages/Home">Grantlee</ulink>, 
    <ulink url="http://oss.sgi.com/projects/fam/">FAM</ulink>, 
    <ulink url="http://www.herqq.org/">HUPnP</ulink>, 
    <xref linkend="mitkrb"/> and
    <ulink url="http://www.openexr.com/">OpenEXR</ulink>    
    </para>

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

  </sect2>

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

    <para>Fix file conflicts with <application>GNOME Menus</application> by running
    the following commands:</para>

<screen><userinput>sed -e "s@{SYSCONF_INSTALL_DIR}/xdg/menus@&amp; RENAME kde-applications.menu@g" \
    -i kded/CMakeLists.txt &amp;&amp;
sed -i "s@applications.menu@kde-&amp;@g" kded/kbuildsycoca.cpp</userinput></screen>

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

<!-- I wouldn't recommend installing D-Bus configuration files outside of /etc if kde-dir is /usr,
     maybe kde-etc-dir should be introduced? -->
<screen><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
cmake -DCMAKE_INSTALL_PREFIX=&kde-dir; \
      -DSYSCONF_INSTALL_DIR=/etc \
      -DCMAKE_BUILD_TYPE=Release \
      -DDOCBOOKXML_CURRENTDTD_DIR=/usr/share/xml/docbook/xml-dtd-&DocBook-version; \
      .. &amp;&amp;
make</userinput></screen>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

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

    <para><option>-DSYSCONF_INSTALL_DIR=/etc</option>: This switch is used to install
    configuration files in /etc.</para>

    <para><option>-DCMAKE_BUILD_TYPE=Release</option>: This switch is used to apply
    higher level of compiler optimizations.</para>

    <para><option>-DDOCBOOKXML_CURRENTDTD_DIR=...</option>: This switch is used to
    tell <command>cmake</command> where to find the XML DTDs.</para>          

  </sect2>

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

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

      <seglistitem>
        <seg>checkXML, kbuildsycoca4, kconfig_compiler, kcookiejar4,
        kde4-config, kded4, kdeinit4, kdeinit4_shutdown, kdeinit4_wrapper,
        kfilemetadatareader, kjs, kjscmd, kross, kshell4, kunittestmodrunner,
        kwrapper4, makekdewidgets, meinproc4, meinproc4_simple, nepomuk-rcgen
        and preparetips</seg>
        <seg>several in &kde-dir;/lib</seg>
        <seg>several in &kde-dir;/include, &kde-dir;/lib and &kde-dir;/share
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="checkXML">
        <term><command>checkXML</command></term>
        <listitem>
          <para>
            is a tool used to check for syntax errors in KDE DocBook
            XML files.
          </para>
          <indexterm zone="kdelibs checkXML">
            <primary sortas="b-checkXML">checkXML</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kbuildsycoca4">
        <term><command>kbuildsycoca4</command></term>
        <listitem>
          <para>
            is used to rebuild the system configuration cache.
          </para>
          <indexterm zone="kdelibs kbuildsycoca4">
            <primary sortas="b-kbuildsycoca4">kbuildsycoca4</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kconfig_compiler">
        <term><command>kconfig_compiler</command></term>
        <listitem>
          <para>
            is the KDE configuration compiler.
          </para>
          <indexterm zone="kdelibs kconfig_compiler">
            <primary sortas="b-kconfig_compiler">kconfig_compiler</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kcookiejar4">
        <term><command>kcookiejar4</command></term>
        <listitem>
          <para>
            is the KDE HTTP cookie daemon.
          </para>
          <indexterm zone="kdelibs kcookiejar4">
            <primary sortas="b-kcookiejar4">kcookiejar4</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kde4-config">
        <term><command>kde4-config</command></term>
        <listitem>
          <para>
            is used to print the KDE installation paths.
          </para>
          <indexterm zone="kdelibs kde4-config">
            <primary sortas="b-kde4-config">kde4-config</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kded4">
        <term><command>kded4</command></term>
        <listitem>
          <para>
            is the KDE daemon.
          </para>
          <indexterm zone="kdelibs kded4">
            <primary sortas="b-kded4">kded4</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kdeinit4">
        <term><command>kdeinit4</command></term>
        <listitem>
          <para>
            is the KDE process launcher.
          </para>
          <indexterm zone="kdelibs kdeinit4">
            <primary sortas="b-kdeinit4">kdeinit4</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kjs">
        <term><command>kjs</command></term>
        <listitem>
          <para>
            is the KDE ECMAScript/JavaScript engine.
          </para>
          <indexterm zone="kdelibs kjs">
            <primary sortas="b-kjs">kjs</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kjscmd">
        <term><command>kjscmd</command></term>
        <listitem>
          <para>
            is a tool used for launching KJSEmbed scripts from
            the command line.
          </para>
          <indexterm zone="kdelibs kjscmd">
            <primary sortas="b-kjscmd">kjscmd</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kross">
        <term><command>kross</command></term>
        <listitem>
          <para>
            is the KDE application used to run kross scripts.
          </para>
          <indexterm zone="kdelibs kross">
            <primary sortas="b-kross">kross</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="makekdewidgets">
        <term><command>makekdewidgets</command></term>
        <listitem>
          <para>
            is used to build Qt widget plugins from an ini style
            description file.
          </para>
          <indexterm zone="kdelibs makekdewidgets">
            <primary sortas="b-makekdewidgets">makekdewidgets</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="meinproc4">
        <term><command>meinproc4</command></term>
        <listitem>
          <para>
            is used to convert DocBook files to HTML.
          </para>
          <indexterm zone="kdelibs meinproc4">
            <primary sortas="b-meinproc4">meinproc4</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="preparetips">
        <term><command>preparetips</command></term>
        <listitem>
          <para>
            is a script used to extract the text from a tips file.
          </para>
          <indexterm zone="kdelibs preparetips">
            <primary sortas="b-preparetips">preparetips</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>