glfs/kde/add/kdegraphics.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;

    <!-- Inserted as a reminder to do this. The mention of a test suite
         is usually right before the root user installation commands. Please
         delete these 12 (including one blank) lines after you are done.-->

    <!-- Use one of the two mentions below about a test suite,
         delete the line that is not applicable. Of course, if the
         test suite uses syntax other than "make check", revise the
         line to reflect the actual syntax to run the test suite -->

    <!-- <para>This package does not come with a test suite.</para> -->
    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->

  <!ENTITY kdegraphics-download-http "&kde-download-http;/kdegraphics-&kde-version;.tar.bz2">
  <!ENTITY kdegraphics-download-ftp  "&kde-download-ftp;/kdegraphics-&kde-version;.tar.bz2">
  <!ENTITY kdegraphics-md5sum        "8e1816a2191ea85b889930159a5d1e46">
  <!ENTITY kdegraphics-size          "7.0 MB">
  <!ENTITY kdegraphics-buildsize     "148 MB (additional 51 MB for API documentation)">
  <!ENTITY kdegraphics-time          "9.3 SBU (additional 0.2 SBU for API documentation)">
]>

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

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
    <keywordset>
      <keyword role="package">kdegraphics-&kde-version;.tar</keyword>
      <keyword role="ftpdir">kde</keyword>
    </keywordset>
  </sect1info>

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

  <indexterm zone="kdegraphics">
    <primary sortas="a-kdegraphics">Kdegraphics</primary>
  </indexterm>

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

    <para><application>Kdegraphics</application> provides
    <application>KDE</application> programs to manage the video display and
    graphical output.  Applications include PDF, DVI, and Postscript viewers,
    an application to adjust monitor gamma correction, a 3D modeling
    application to generate POV-Ray scenes, and a scanner application.</para>

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

<!--
    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Required Patch: <ulink
        url="ftp://ftp.kde.org/pub/kde/security_patches/post-&kde-version;-kdegraphics-CAN-2005-3193.diff"/></para>
      </listitem>
    </itemizedlist>
-->

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="kdebase"/></para>

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

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="libtiff"/>,
    <xref linkend="imlib"/>,
    <xref linkend="lcms"/>,
    <xref linkend="poppler"/>
    (<filename class='libraryfile'>libpoppler-qt.so</filename> must have
    been built),
    <xref linkend="sane"/>,
    <!-- There is an internal copy of Xpdf and there are *no* hooks to any
         outside version. Commenting this out for now
    <xref linkend="xpdf"/>, -->
    <xref linkend="tex"/>,
    <xref linkend="fribidi"/>,
    <ulink url="http://www.gphoto.org/">libgphoto2</ulink>,
    <ulink url="http://gd.tuwien.ac.at/visual/ibiblio/libs/graphics/t1lib-5.1.0.tar.gz">t1lib</ulink>,
    <ulink url="http://www.openexr.com/">OpenEXR</ulink>,
    <ulink url="http://packages.debian.org/unstable/source/libpaper">libpaper</ulink>,
    <ulink url="http://www.rerecognition.com/">KADMOS</ulink> (a commercial
    OCR engine),
    <xref linkend="graphviz"/>, and
    <xref linkend="doxygen"/></para>

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

  </sect2>

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

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

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

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../../xincludes/kde-apidocs.xml"/>

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

<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d &kde-dir;/man/man1 &amp;&amp;
install -v -m644 debian/man/* &kde-dir;/man/man1</userinput></screen>

    <para>The <command>kooka</command> utility is a scanning and OCR program.
    In order for <command>kooka</command> to utilize the OCR capabilities, you
    must install an OCR engine. <command>kooka</command> provides full OCR
    support using the <ulink url="http://www.rerecognition.com/">KADMOS</ulink>
    and <ulink url="http://sourceforge.net/projects/jocr">GOCR</ulink> engines
    and partial support using the <ulink
    url="https://savannah.gnu.org/projects/ocrad/">Ocrad</ulink> engine.</para>

  </sect2>

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

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

      <seglistitem>
        <seg>kcolorchooser, kcoloredit, kdvi, kfax, kfaxview, kghostview,
        kiconedit, kolourpaint, kooka, kpdf, kpovmodeler, kruler, ksnapshot,
        kuickshow, kview, kviewshell, mrmlsearch, printnodetest, svgdisplay,
        and xf86gammacfg</seg>
        <seg>kio_kamera and several other kdegraphics specific libraries and
        support modules</seg>
        <seg>The following subdirectories in &kde-dir;: include/{svg,
        kviewshell, libtext2path-0.1}, share/applnk/Graphics, share/apps/{too
        many to list}, and share/config/magic</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="kcolorchooser">
        <term><command>kcolorchooser</command></term>
        <listitem>
          <para>is a color chooser for a given pallette.</para>
          <indexterm zone="kdegraphics kcolorchooser">
            <primary sortas="b-kcolorchooser">kcolorchooser</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kcoloredit">
        <term><command>kcoloredit</command></term>
        <listitem>
          <para>is a color pallette editor.</para>
          <indexterm zone="kdegraphics kcoloredit">
            <primary sortas="b-kcoloredit">kcoloredit</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kdvi">
        <term><command>kdvi</command></term>
        <listitem>
          <para>is a DVI viewer.</para>
          <indexterm zone="kdegraphics kdvi">
            <primary sortas="b-kdvi">kdvi</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kfax">
        <term><command>kfax</command></term>
        <listitem>
          <para>is a FAX viewer.</para>
          <indexterm zone="kdegraphics kfax">
            <primary sortas="b-kfax">kfax</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kfaxview">
        <term><command>kfaxview</command></term>
        <listitem>
          <para>is a FAX previewer used with
          <command>kviewshell</command>.</para>
          <indexterm zone="kdegraphics kfaxview">
            <primary sortas="b-kfaxview">kfaxview</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kghostview">
        <term><command>kghostview</command></term>
        <listitem>
          <para>is a PS/PDF viewer.</para>
          <indexterm zone="kdegraphics kghostview">
            <primary sortas="b-kghostview">kghostview</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kiconedit">
        <term><command>kiconedit</command></term>
        <listitem>
          <para>is an icon editor.</para>
          <indexterm zone="kdegraphics kiconedit">
            <primary sortas="b-kiconedit">kiconedit</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kolourpaint">
        <term><command>kolourpaint</command></term>
        <listitem>
          <para>is a paint program.</para>
          <indexterm zone="kdegraphics kolourpaint">
            <primary sortas="b-kolourpaint">kolourpaint</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kooka">
        <term><command>kooka</command></term>
        <listitem>
          <para>is a raster image scan program.</para>
          <indexterm zone="kdegraphics kooka">
            <primary sortas="b-kooka">kooka</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kpdf">
        <term><command>kpdf</command></term>
        <listitem>
          <para>is a PDF viewer.</para>
          <indexterm zone="kdegraphics kpdf">
            <primary sortas="b-kpdf">kpdf</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kpovmodeler">
        <term><command>kpovmodeler</command></term>
        <listitem>
          <para>is a graphical 3D modeler, which can generate scenes for
          <ulink url="http://www.povray.org/">POV-Ray</ulink>.</para>
          <indexterm zone="kdegraphics kpovmodeler">
            <primary sortas="b-kpovmodeler">kpovmodeler</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kruler">
        <term><command>kruler</command></term>
        <listitem>
          <para>is a screen ruler.</para>
          <indexterm zone="kdegraphics kruler">
            <primary sortas="b-kruler">kruler</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="ksnapshot">
        <term><command>ksnapshot</command></term>
        <listitem>
          <para> is a screen capture program.</para>
          <indexterm zone="kdegraphics ksnapshot">
            <primary sortas="b-ksnapshot">ksnapshot</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kuickshow">
        <term><command>kuickshow</command></term>
        <listitem>
          <para>is an image viewer.</para>
          <indexterm zone="kdegraphics kuickshow">
            <primary sortas="b-kuickshow">kuickshow</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kview">
        <term><command>kview</command></term>
        <listitem>
          <para>is another image viewer.</para>
          <indexterm zone="kdegraphics kview">
            <primary sortas="b-kview">kview</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kviewshell">
        <term><command>kviewshell</command></term>
        <listitem>
          <para>is a generic framework for the KDE viewer
          applications.</para>
          <indexterm zone="kdegraphics kviewshell">
            <primary sortas="b-kviewshell">kviewshell</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xf86gammacfg">
        <term><command>xf86gammacfg</command></term>
        <listitem>
          <para>is a simple tool for monitor gamma correction.</para>
          <indexterm zone="kdegraphics xf86gammacfg">
            <primary sortas="b-xf86gammacfg">xf86gammacfg</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kio_kamera">
        <term><command>kio_kamera</command></term>
        <listitem>
          <para>is an ioslave that allows you to view and download images from a
          digital camera using the <userinput>kamera:/</userinput> URL in
          <command>konqueror</command>.</para>
          <indexterm zone="kdegraphics kio_kamera">
            <primary sortas="c-kio_kamera">kio_kamera</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>