<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!--ARC : LSARC 2003/298 Evolution 1.4-->
<!ENTITY cmd "libebook-1.2">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved.">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="libebook-1.2-3">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>3</manvolnum>
<refmiscinfo class="date">11 Oct 2006</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<indexterm><primary>&cmd;</primary></indexterm><indexterm><primary>addressbook library</primary></indexterm><indexterm><primary>libedata-book-1.2</primary></indexterm><indexterm><primary>backend library for Evolution addressbook</primary></indexterm>
<refnamediv id="libebook-1.2-3-name"><refname>&cmd;</refname><refname>libedata-book-1.2</refname>
<refpurpose>addressbook library, backend library for Evolution addressbook</refpurpose></refnamediv>
<refsect1 id="libebook-1.2-3-desc"><title>&desc-tt;</title>
<para><literal>&cmd;</literal> provides classes for client interactions. It relies on the classes in libedata-book which runs in an instance of Evolution Data Server to provide the data.  
</para>
<para><literal>libedata-book-1.2</literal> provides classes for backend implementation. Writing an address book backend for the Evolution Data Server involves extending the EBookBackend class and implementing its virtual methods. Backends that require network communication generally extend the EBookBackend class. This class makes sure the backend return the results of its operations asynchronously. Other backends, including the file and vcf ones, extend EBookBackendSync, which is derived from EBookBackend and provides wrappers around its virtual functions to facilitate backend implementation when network performance is not of concern.
</para>
</refsect1>
<refsect1 id="libebook-1.2-3-attr"><title>&attr-tt;</title>
<para>See <olink targetdocent="REFMAN5" localinfo="attributes-3"><citerefentry>
<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
for descriptions of the following attributes:</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
<colspec colname="COLSPEC1" colwidth="1*">
<thead>
<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
valign="middle">ATTRIBUTE VALUE</entry></row>
</thead>
<tbody>
<row><entry><para>Availability</para></entry><entry><para>mail/evolution
</para></entry></row>
<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
colname="COLSPEC1"><para>Private</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="libebook-1.2-3-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para>
<citerefentry><refentrytitle>evolution</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libecal</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libedataserver</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>gnome-interfaces</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>
<refsect1 id="libebook-1.2-3-note"><title>&note-tt;</title>
<para>Sun does not guarantee the stability of these interfaces and does not recommend their use.  API documentation for these interfaces is provided by the Evolution free software community for those who wish to develop using these interfaces. However, you can visit the following URL for more information: 
</para>
<para>
<literal>http://www.gnome.org/projects/evolution/developer\-doc/libebook/EBook.html</literal> 
</para>
<para>Written by Nancy Cai, Sun Microsystems Inc., 2006.</para>
</refsect1>
</refentry>
