source: xsoft/other/ekiga.xml@ 0d61665

<?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 ekiga-download-http "&gnome-download-http;/ekiga/4.0/ekiga-&ekiga-version;.tar.xz">
  <!ENTITY ekiga-download-ftp  "&gnome-download-ftp;/ekiga/4.0/ekiga-&ekiga-version;.tar.xz">
  <!ENTITY ekiga-md5sum        "704ba532a8e3e0b5e3e2971dd2db39e4">
  <!ENTITY ekiga-size          "8.0 MB">
  <!ENTITY ekiga-buildsize     "315 MB">
  <!ENTITY ekiga-time          "3.5 SBU">
]>

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

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

  <title>Ekiga-&ekiga-version;</title>

  <indexterm zone="ekiga">
    <primary sortas="a-Ekiga">Ekiga</primary>
  </indexterm>

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

    <para>
      <application>Ekiga</application> is a VoIP, IP Telephony, and Video Conferencing
      application that allows you to make audio and video calls to remote users with
      SIP or H.323 compatible hardware and software.  It supports many audio and video
      codecs and all modern VoIP features for both SIP and H.323.
      <application>Ekiga</application> is the first Open Source application to support
      both H.323 and SIP, as well as audio and video.
    </para>

    &lfs75_checked;

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

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="boost"/>,
      <xref linkend="gnome-icon-theme"/>,
      <xref linkend="gtk2"/> and
      <xref linkend="opal"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="dbus-glib"/>,
      <xref linkend="GConf"/> and
      <xref linkend="libnotify"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="avahi"/>,
      <xref linkend="evolution-data-server"/>,
      <ulink url="&gnome-download-http;/gnome-doc-utils/">
      GNOME Doc Utils</ulink> and
      <xref linkend="openldap"/>
    </para>

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

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

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

<screen><userinput>./configure --prefix=/usr     \
            --sysconfdir=/etc \
            --disable-eds     \
            --disable-gdu     \
            --disable-ldap    \
            --disable-scrollkeeper &amp;&amp;
make</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

    <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>--disable-eds</option>: This switch disables support for the
      <application>Evolution Data Server</application>. Remove if you have
      installed <application>Evolution Data Server</application>.
    </para>

    <para>
      <option>--disable-gdu</option>: This switch disables documentation generation
      using <application>GNOME Doc Utils</application>. Remove if you have installed
      <application>GNOME Doc Utils</application>.
    </para>

    <para>
      <option>--disable-ldap</option>: This switch disables LDAP support in
      <application>Ekiga</application>. Remove if you have installed
      <application>OpenLDAP</application>.
    </para>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/without-scrollkeeper.xml"/>

    <para>
      <option>--disable-dbus</option>: This switch disables
      <application>D-Bus</application> support. Use if you have not installed
      <application>D-Bus</application>.
    </para>

    <para>
      <option>--enable-avahi</option>: This switch enables use of the
      <application>Avahi</application> with <application>Ekiga</application>.
      Use if you have installed <application>Avahi</application>.
    </para>

    <note>
      <para>
        If you have not installed recommended dependencies you will need additional
        switches passed to <command>configure</command>. Examine
        <command>./configure --help</command> output to see all available switches.
      </para>
    </note>

  </sect2>

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

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

      <seglistitem>
        <seg>
          ekiga, ekiga-config-tool and ekiga-helper
        </seg>
        <seg>
          None
        </seg>
        <seg>
          /usr/lib/ekiga,
          /usr/share/gnome/help/ekiga,
          /usr/share/omf/ekiga,
          /usr/share/pixmaps/ekiga and
          /usr/share/sounds/ekiga
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="ekiga-prog">
        <term><command>ekiga</command></term>
        <listitem>
          <para>
            is a SIP and H.323 VoIP, IP Telephony and Video Conferencing
            application which complies to the SIP and H.323 protocols.
          </para>
          <indexterm zone="ekiga ekiga-prog">
            <primary sortas="b-ekiga">ekiga</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>