source: gnome/applications/gnome-contacts.xml@ 91d9178

<?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 gnome-contacts-download-http 
           "&gnome-download-http;/gnome-contacts/3.6/gnome-contacts-&gnome-contacts-version;.tar.xz">
  <!ENTITY gnome-contacts-download-ftp  
           "&gnome-download-ftp;/gnome-contacts/3.6/gnome-contacts-&gnome-contacts-version;.tar.xz">
  <!ENTITY gnome-contacts-md5sum        "6af361b582015287d57760d491dc6e34">
  <!ENTITY gnome-contacts-size          "596 KB">
  <!ENTITY gnome-contacts-buildsize     "25 MB">
  <!ENTITY gnome-contacts-time          "0.2 SBU">
]>

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

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

  <title>gnome-contacts-&gnome-contacts-version;</title>

  <indexterm zone="gnome-contacts">
    <primary sortas="a-gnome-contacts">gnome-contacts</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to GNOME Contacts</title>

    <para>
      <application>GNOME Contacts</application> is a simple contacts application
      that allows you to view your contacts as well as edit their details and create
      new contacts. Online integration is an important aspect of GNOME Contacts - it
      will seamlessly synchronise with the contacts stored in online accounts. If you
      have the same person in multiple online accounts, GNOME Contacts will
      automatically link them together into the same contact.
    </para>

    &lfs72_checked;

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

    <bridgehead renderas="sect3">GNOME Contacts Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="evolution-data-server"/>,
      <xref linkend="folks"/> (built with e-d-s support),
      <xref linkend="gnome-desktop"/>,
      <xref linkend="gnome-online-accounts"/> and
      <xref linkend="vala"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="cheese"/>
    </para>

    <bridgehead renderas="sect4">Additional Runtime Dependencies</bridgehead>
    <para role="required">
      <xref linkend="telepathy-mission-control"/>
    </para>

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

  <sect2 role="installation">
    <title>Installation of GNOME Contacts</title>

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

<screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib/gnome-contacts &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="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>
          gnome-contacts
        </seg>
        <seg>
          /usr/lib/gnome-contacts
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="gnome-contacts-prog">
        <term><command>gnome-contacts</command></term>
        <listitem>
          <para>
            is a program for accessing and storing information about contacts.
          </para>
          <indexterm zone="gnome-contacts gnome-contacts-prog">
            <primary sortas="b-gnome-contacts">gnome-contacts</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>