glfs/xsoft/other/ekiga.xml

<?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>

    &lfs7a_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"/>,
      <ulink url="&gnome-download-http;/evolution-data-server/">
      Evolution Data Server</ulink>,
      <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>
      <parameter>--disable-eds</parameter>: This switch disables support for the
      <application>Evolution Data Server</application>. Remove if you have
      installed <application>Evolution Data Server</application>.
    </para>

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

    <para>
      <parameter>--disable-ldap</parameter>: 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>

     <varlistentry id="ekiga-config-tool">
        <term><command>ekiga-config-tool</command></term>
        <listitem>
          <para>
            fixes problems with the Ekiga settings.
          </para>
          <indexterm zone="ekiga ekiga-config-tool">
            <primary sortas="b-ekiga-config-tool">ekiga-config-tool</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>
  </sect2>

</sect1>