glfs/kde/core/kdebase.xml

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

  <!ENTITY kdebase-download-http "&kde-download-http;/kdebase-&kde-version;.tar.bz2">
  <!ENTITY kdebase-download-ftp  "&kde-download-ftp;/kdebase-&kde-version;.tar.bz2">
  <!ENTITY kdebase-md5sum        "c88659e558ca98dc45377bf8ddfc26c9">
  <!ENTITY kdebase-size          "21.6 MB">
  <!ENTITY kdebase-buildsize     "282 MB (additional 20 MB for API docs)">
  <!ENTITY kdebase-time          "21.15 SBU (additional 0.2 SBU for API docs)">
]>

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

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

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

  <indexterm zone="kdebase">
    <primary sortas="a-kdebase">Kdebase</primary>
  </indexterm>

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

    <para><application>kdebase</application> is the last mandatory package 
    required for the <application>K Desktop Environment</application>. It 
    provides various applications, infrastructure files and libraries.</para>

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

    <bridgehead renderas="sect3">Kdebase Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para><xref linkend="kdelibs"/></para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para><xref linkend="libjpeg"/>, 
    <xref linkend="libart_lgpl"/>, 
    <xref linkend="libxml2"/>, 
    <xref linkend="openssl"/>, and 
    <xref linkend="jdk"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para><xref linkend="libtiff"/>, 
    <xref linkend="lesstif"/>, 
    <xref linkend="Linux_PAM"/>, 
    <xref linkend="openldap"/>, 
    <xref linkend="cyrus-sasl"/>, 
    <xref linkend="samba3"/>, 
    <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>, 
    <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>, 
    <ulink url="http://mtools.linux.lu/?power-to-the-parliament">Mtools</ulink>, 
    <ulink url="http://www.linux1394.org/">libraw1394</ulink>, 
    <ulink url="http://secure.netroedge.com/~lm78/">lm_sensors</ulink>, 
    <ulink url="http://www.ece.uvic.ca/~mdadams/jasper/">JasPer</ulink>, 
    <ulink url="http://www.graphviz.org/">GraphViz</ulink>, and 
    <xref linkend="doxygen"/></para>

  </sect2>

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

    <para><emphasis>Note:</emphasis> You should ensure a <systemitem
    class="groupname">nogroup</systemitem> group exists on your system before
    performing the <command>make install</command> command, as
    <application>kdebase</application> installs a program
    (<filename>$KDE_PREFIX/bin/kdesud</filename>) with group ownership of
    <systemitem class="groupname">nogroup</systemitem>.</para>

    <para>Install <application>kdebase</application> with:</para>

<screen><userinput>./configure --prefix=&kde-dir; --disable-debug \
    --disable-dependency-tracking &amp;&amp;
make</userinput></screen>

    <note>
      <para>If you wish to create the API documentation and you have 
      <application>Doxygen</application> and <application>GraphViz</application>
      installed, <command>make apidox</command> must be done before 
      <command>make install</command>.</para>
    </note>

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

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

  </sect2>

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

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

      <seglistitem>
        <seg>kate, kcontrol, kdebugdialog, kdeprint, kdesu, kdm, kfind,
        khelpcenter, kicker, kinfocenter, kioslave, klipper, kmenuedit,
        konqueror, konsole, kpager, ksplashml, ksysguard, kwrite, 
        and kxkb</seg>
        <seg>None</seg>
        <seg>None</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="kate">
        <term><command>kate</command></term>
        <listitem>
          <para> is a programmer's text editor for <application>KDE</application>.</para>
          <indexterm zone="kdebase kate">
            <primary sortas="b-kate">kate</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kcontrol">
        <term><command>kcontrol</command></term>
        <listitem>
          <para> is the <application>KDE</application> Control Center.</para>
          <indexterm zone="kdebase kcontrol">
            <primary sortas="b-kcontrol">kcontrol</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kdebugdialog">
        <term><command>kdebugdialog</command></term>
        <listitem>
          <para>is a dialog box for managing diagnostic messages at runtime.</para>
          <indexterm zone="kdebase kdebugdialog">
            <primary sortas="b-kdebugdialog">kdebugdialog</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kdeprint">
        <term><command>kdeprint</command></term>
        <listitem>
          <para>is the printing module in <application>KDE</application>. It 
          manages the actual printing from <application>KDE</application>
          applications, It handles print job administration and handles printer and 
          print system management.</para>
          <indexterm zone="kdebase kdeprint">
            <primary sortas="b-kdeprint">kdeprint</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kdesu">
        <term><command>kdesu</command></term>
        <listitem>
          <para>is a graphical front end for the Unix 
          <command>su</command> command.</para>
          <indexterm zone="kdebase kdesu">
            <primary sortas="b-kdesu">kdesu</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kdm">
        <term><command>kdm</command></term>
        <listitem>
          <para>is the <application>KDE</application> display manager 
          (a replacement for <command>xdm</command>).</para>
          <indexterm zone="kdebase kdm">
            <primary sortas="b-kdm">kdm</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kfind">
        <term><command>kfind</command></term>
        <listitem>
          <para>is a utility to find files.</para>
          <indexterm zone="kdebase kfind">
            <primary sortas="b-kfind">kfind</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="khelpcenter">
        <term><command>khelpcenter</command></term>
        <listitem>
          <para>is the <application>KDE</application> help tool.</para>
          <indexterm zone="kdebase khelpcenter">
            <primary sortas="b-khelpcenter">khelpcenter</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kicker">
        <term><command>kicker</command></term>
        <listitem>
          <para>is the <application>KDE</application> control panel.</para>
          <indexterm zone="kdebase kicker">
            <primary sortas="b-kicker">kicker</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kinfocenter">
        <term><command>kinfocenter</command></term>
        <listitem>
          <para>provides a centralized and convenient overview of your 
          <application>KDE</application> and system settings.</para>
          <indexterm zone="kdebase kinfocenter">
            <primary sortas="b-kinfocenter">kinfocenter</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kioslaves">
        <term>kioslaves</term>
        <listitem>
          <para>are support programs designed to be intimately familiar with a certain
          protocol, so that a standard interface can be used to get at data from
          any number of places. Examples are the http and ftp kioslaves,
          which will retrieve data from an http or ftp server respectively.</para>
          <indexterm zone="kdebase kioslaves">
            <primary sortas="b-kioslaves">kioslaves</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="klipper">
        <term><command>klipper</command></term>
        <listitem>
          <para> is a clipboard utility.</para>
          <indexterm zone="kdebase klipper">
            <primary sortas="b-klipper">klipper</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kmenuedit">
        <term><command>kmenuedit</command></term>
        <listitem>
          <para>is a utility to rearrange or add items to the K-menu.</para>
          <indexterm zone="kdebase kmenuedit">
            <primary sortas="b-kmenuedit">kmenuedit</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kongueror">
        <term><command>kongueror</command></term>
        <listitem>
          <para>is a filesystem and web browser.</para>
          <indexterm zone="kdebase kongueror">
            <primary sortas="b-kongueror">kongueror</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="konsole">
        <term><command>konsole</command></term>
        <listitem>
          <para>is a highly configurable <application>X</application>
          terminal emulator.</para>
          <indexterm zone="kdebase konsole">
            <primary sortas="b-konsole">konsole</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kpager">
        <term><command>kpager</command></term>
        <listitem>
          <para>provides a thumbnail view of all virtual desktops.</para>
          <indexterm zone="kdebase kpager">
            <primary sortas="b-kpager">kpager</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="ksplashml">
        <term><command>ksplashml</command></term>
        <listitem>
          <para>is a splash screen that shows the progress of an application 
          that is loading.</para>
          <indexterm zone="kdebase ksplashml">
            <primary sortas="b-ksplashml">ksplashml</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="ksysguard">
        <term><command>ksysguard</command></term>
        <listitem>
          <para>is a network enabled task manager and system monitor application, 
          with the additional functionality of <command>top</command>.</para>
          <indexterm zone="kdebase ksysguard">
            <primary sortas="b-ksysguard">ksysguard</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kwrite">
        <term><command>kwrite</command></term>
        <listitem>
          <para>is a text editor for <application>KDE</application>.</para>
          <indexterm zone="kdebase kwrite">
            <primary sortas="b-kwrite">kwrite</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kxkb">
        <term><command>kxkb</command></term>
        <listitem>
          <para>is a keyboard layout switching utility based on the X11 xkb 
          extension.</para>
          <indexterm zone="kdebase kxkb">
            <primary sortas="b-kxkb">kxkb</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>