<chapter>
<title>Evolution-Data-Server Manual: Address Book Client (libebook)</title>
<xi:include href="xml/e-book.xml"/>
- <xi:include href="xml/e-book-listener.xml"/>
<xi:include href="xml/e-book-query.xml"/>
<xi:include href="xml/e-book-types.xml"/>
<xi:include href="xml/e-book-view.xml"/>
- <xi:include href="xml/e-book-view-listener.xml"/>
<xi:include href="xml/e-vcard.xml"/>
<xi:include href="xml/e-contact.xml"/>
<xi:include href="xml/e-destination.xml"/>
<SECTION>
-<FILE>e-book-listener</FILE>
-<TITLE>EBookListener</TITLE>
-EBookListener
-EBookListenerResponse
-EBookListenerOperation
-e_book_listener_new
-e_book_listener_stop
-<SUBSECTION Standard>
-EBookListenerClass
-E_BOOK_LISTENER
-E_IS_BOOK_LISTENER
-E_TYPE_BOOK_LISTENER
-e_book_listener_get_type
-E_BOOK_LISTENER_CLASS
-E_IS_BOOK_LISTENER_CLASS
-E_BOOK_LISTENER_GET_CLASS
-<SUBSECTION Private>
-EBookListenerPrivate
-</SECTION>
-
-<SECTION>
-<FILE>e-book-view-listener</FILE>
-<TITLE>EBookViewListener</TITLE>
-EBookViewListener
-EBookViewListenerResponse
-EBookViewListenerOperation
-e_book_view_listener_new
-e_book_view_listener_start
-e_book_view_listener_stop
-<SUBSECTION Standard>
-EBookViewListenerClass
-E_BOOK_VIEW_LISTENER
-E_IS_BOOK_VIEW_LISTENER
-E_TYPE_BOOK_VIEW_LISTENER
-e_book_view_listener_get_type
-E_BOOK_VIEW_LISTENER_CLASS
-E_IS_BOOK_VIEW_LISTENER_CLASS
-E_BOOK_VIEW_LISTENER_GET_CLASS
-<SUBSECTION Private>
-EBookViewListenerPrivate
-</SECTION>
-
-<SECTION>
<FILE>e-book-view</FILE>
<TITLE>EBookView</TITLE>
EBookView
#include <libebook/e-book.h>
-#include <libebook/e-book-listener.h>
#include <libebook/e-book-view.h>
-#include <libebook/e-book-view-listener.h>
#include <libebook/e-contact.h>
#include <libebook/e-destination.h>
#include <libebook/e-vcard.h>
e_book_get_type
-e_book_listener_get_type
e_book_view_get_type
-e_book_view_listener_get_type
e_contact_get_type
e_destination_get_type
e_vcard_get_type
+++ /dev/null
-<!-- ##### SECTION Title ##### -->
-EBookListener
-
-<!-- ##### SECTION Short_Description ##### -->
-Listens for call responses and event notifications from EBook objects.
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-Exposes the Evolution:BookListener interface. Contrast with EBookViewListener.
-
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT EBookListener ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SIGNAL EBookListener::response ##### -->
-<para>
-
-</para>
-
-@ebooklistener: the object which received the signal.
-@arg1:
-
-<!-- ##### STRUCT EBookListenerResponse ##### -->
-<para>
-
-</para>
-
-@op:
-@opid:
-@status:
-@book_view:
-@list:
-@msg:
-@connected:
-@writable:
-@id:
-@vcard:
-
-<!-- ##### ENUM EBookListenerOperation ##### -->
-<para>
-
-</para>
-
-@OpenBookResponse:
-@RemoveBookResponse:
-@CreateContactResponse:
-@RemoveContactResponse:
-@ModifyContactResponse:
-@GetContactResponse:
-@GetContactListResponse:
-@GetBookViewResponse:
-@GetChangesResponse:
-@AuthenticationResponse:
-@GetSupportedFieldsResponse:
-@GetRequiredFieldsResponse:
-@GetSupportedAuthMethodsResponse:
-@LinkStatusEvent:
-@WritableStatusEvent:
-@AuthRequiredEvent:
-@ProgressEvent:
-
-<!-- ##### FUNCTION e_book_listener_new ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-
-<!-- ##### FUNCTION e_book_listener_stop ##### -->
-<para>
-
-</para>
-
-@listener:
-
-
+++ /dev/null
-<!-- ##### SECTION Title ##### -->
-EBookViewListener
-
-<!-- ##### SECTION Short_Description ##### -->
-Listens for call responses and event notifications from EBookView objects.
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-Exposes the Evolution:BookViewListener interface. Contrast with the EBookListener.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-EBookListener
-EBookTypes
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT EBookViewListener ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SIGNAL EBookViewListener::response ##### -->
-<para>
-
-</para>
-
-@ebookviewlistener: the object which received the signal.
-@arg1:
-
-<!-- ##### STRUCT EBookViewListenerResponse ##### -->
-<para>
-Data sent back to the e-book object.
-</para>
-
-@op:
-@status:
-@ids:
-@contacts:
-@message:
-
-<!-- ##### ENUM EBookViewListenerOperation ##### -->
-<para>
-Asynchronous events that are listened for.
-</para>
-
-@ContactsAddedEvent:
-@ContactsRemovedEvent:
-@ContactsModifiedEvent:
-@SequenceCompleteEvent:
-@StatusMessageEvent:
-
-<!-- ##### FUNCTION e_book_view_listener_new ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-
-<!-- ##### FUNCTION e_book_view_listener_start ##### -->
-<para>
-
-</para>
-
-@listener:
-
-
-<!-- ##### FUNCTION e_book_view_listener_stop ##### -->
-<para>
-
-</para>
-
-@listener:
-
-
@ebookview: the object which received the signal.
@arg1: a const char* message
-<!-- ##### FUNCTION e_book_view_new ##### -->
-<para>
-
-</para>
-
-@corba_book_view:
-@listener:
-@Returns:
-
-
<!-- ##### FUNCTION e_book_view_start ##### -->
<para>
@book_view:
-<!-- ##### FUNCTION e_book_view_set_book ##### -->
-<para>
-
-</para>
-
-@book_view:
-@book:
-
-
<!-- ##### FUNCTION e_book_view_get_book ##### -->
<para>
@fields:
@closure:
+<!-- ##### STRUCT EBookListener ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL EBookListener::response ##### -->
+<para>
+
+</para>
+
+@ebooklistener: the object which received the signal.
+@arg1:
+
+<!-- ##### ENUM EBookListenerOperation ##### -->
+<para>
+
+</para>
+
+@OpenBookResponse:
+@RemoveBookResponse:
+@CreateContactResponse:
+@RemoveContactResponse:
+@ModifyContactResponse:
+@GetContactResponse:
+@GetContactListResponse:
+@GetBookViewResponse:
+@GetChangesResponse:
+@AuthenticationResponse:
+@GetSupportedFieldsResponse:
+@GetRequiredFieldsResponse:
+@GetSupportedAuthMethodsResponse:
+@LinkStatusEvent:
+@WritableStatusEvent:
+@AuthRequiredEvent:
+@ProgressEvent:
+
<!-- ##### STRUCT EBookListenerPrivate ##### -->
<para>
</para>
+<!-- ##### STRUCT EBookListenerResponse ##### -->
+<para>
+
+</para>
+
+@op:
+@opid:
+@status:
+@book_view:
+@list:
+@msg:
+@connected:
+@writable:
+@id:
+@vcard:
+
<!-- ##### STRUCT EBookPrivate ##### -->
<para>
</para>
+<!-- ##### STRUCT EBookViewListener ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL EBookViewListener::response ##### -->
+<para>
+
+</para>
+
+@ebookviewlistener: the object which received the signal.
+@arg1:
+
+<!-- ##### ENUM EBookViewListenerOperation ##### -->
+<para>
+Asynchronous events that are listened for.
+</para>
+
+@ContactsAddedEvent:
+@ContactsRemovedEvent:
+@ContactsModifiedEvent:
+@SequenceCompleteEvent:
+@StatusMessageEvent:
+
<!-- ##### STRUCT EBookViewListenerPrivate ##### -->
<para>
</para>
+<!-- ##### STRUCT EBookViewListenerResponse ##### -->
+<para>
+Data sent back to the e-book object.
+</para>
+
+@op:
+@status:
+@ids:
+@contacts:
+@message:
+
<!-- ##### STRUCT EBookViewPrivate ##### -->
<para>
@error:
@Returns:
+<!-- ##### FUNCTION e_book_listener_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION e_book_listener_stop ##### -->
+<para>
+
+</para>
+
+@listener:
+
<!-- ##### FUNCTION e_book_load_local_addressbook ##### -->
<para>
@error:
@Returns:
+<!-- ##### FUNCTION e_book_view_listener_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION e_book_view_listener_start ##### -->
+<para>
+
+</para>
+
+@listener:
+
+<!-- ##### FUNCTION e_book_view_listener_stop ##### -->
+<para>
+
+</para>
+
+@listener:
+
+<!-- ##### FUNCTION e_book_view_new ##### -->
+<para>
+
+</para>
+
+@corba_book_view:
+@listener:
+@Returns:
+
+<!-- ##### FUNCTION e_book_view_set_book ##### -->
+<para>
+
+</para>
+
+@book_view:
+@book:
+
<!-- ##### FUNCTION e_contact_cert_get_type ##### -->
<para>
</para>
-@parent_object:
+@parent:
@priv:
-<!-- ##### FUNCTION e_data_book_factory_new ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-
-<!-- ##### FUNCTION e_data_book_factory_register_backend ##### -->
-<para>
-
-</para>
-
-@factory:
-@backend_factory:
-
-
-<!-- ##### FUNCTION e_data_book_factory_get_n_backends ##### -->
-<para>
-
-</para>
-
-@factory:
-@Returns:
-
-
-<!-- ##### FUNCTION e_data_book_factory_register_backends ##### -->
-<para>
-
-</para>
-
-@factory:
-
-
-<!-- ##### FUNCTION e_data_book_factory_dump_active_backends ##### -->
-<para>
-
-</para>
-
-@factory:
-
-
-<!-- ##### FUNCTION e_data_book_factory_activate ##### -->
-<para>
-
-</para>
-
-@factory:
-@iid:
-@Returns:
-
-
<!-- ##### FUNCTION e_data_book_factory_set_backend_mode ##### -->
<para>
</para>
-<!-- ##### FUNCTION e_data_book_view_new ##### -->
+<!-- ##### SIGNAL EDataBookView::complete ##### -->
<para>
</para>
-@backend:
-@listener:
-@card_query:
-@card_sexp:
-@max_results:
-@Returns:
+@edatabookview: the object which received the signal.
+@arg1:
+<!-- ##### SIGNAL EDataBookView::contacts-added ##### -->
+<para>
-<!-- ##### FUNCTION e_data_book_view_set_thresholds ##### -->
+</para>
+
+@edatabookview: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EDataBookView::contacts-changed ##### -->
<para>
</para>
-@book_view:
-@minimum_grouping_threshold:
-@maximum_grouping_threshold:
+@edatabookview: the object which received the signal.
+@arg1:
+<!-- ##### SIGNAL EDataBookView::contacts-removed ##### -->
+<para>
-<!-- ##### FUNCTION e_data_book_view_get_card_query ##### -->
+</para>
+
+@edatabookview: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EDataBookView::status-message ##### -->
<para>
</para>
-@book_view:
+@edatabookview: the object which received the signal.
+@arg1:
+
+<!-- ##### FUNCTION e_data_book_view_new ##### -->
+<para>
+
+</para>
+
+@book:
+@path:
+@card_query:
+@card_sexp:
+@max_results:
@Returns:
-<!-- ##### FUNCTION e_data_book_view_get_card_sexp ##### -->
+<!-- ##### FUNCTION e_data_book_view_set_thresholds ##### -->
<para>
</para>
@book_view:
-@Returns:
+@minimum_grouping_threshold:
+@maximum_grouping_threshold:
-<!-- ##### FUNCTION e_data_book_view_get_max_results ##### -->
+<!-- ##### FUNCTION e_data_book_view_get_card_query ##### -->
<para>
</para>
@Returns:
-<!-- ##### FUNCTION e_data_book_view_get_backend ##### -->
+<!-- ##### FUNCTION e_data_book_view_get_card_sexp ##### -->
<para>
</para>
@Returns:
-<!-- ##### FUNCTION e_data_book_view_get_listener ##### -->
+<!-- ##### FUNCTION e_data_book_view_get_max_results ##### -->
<para>
</para>
@Returns:
-<!-- ##### FUNCTION e_data_book_view_get_mutex ##### -->
+<!-- ##### FUNCTION e_data_book_view_get_backend ##### -->
<para>
</para>
</para>
@book_view:
-@Param2:
+@status:
<!-- ##### FUNCTION e_data_book_view_notify_status_message ##### -->
</para>
-<!-- ##### FUNCTION e_data_book_new ##### -->
+<!-- ##### SIGNAL EDataBook::auth-required ##### -->
<para>
</para>
-@backend:
-@source:
-@listener:
-@Returns:
+@edatabook: the object which received the signal.
+<!-- ##### SIGNAL EDataBook::connection ##### -->
+<para>
+
+</para>
-<!-- ##### FUNCTION e_data_book_get_listener ##### -->
+@edatabook: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EDataBook::writable ##### -->
<para>
</para>
-@book:
+@edatabook: the object which received the signal.
+@arg1:
+
+<!-- ##### FUNCTION e_data_book_new ##### -->
+<para>
+
+</para>
+
+@backend:
+@source:
+@closed_cb:
@Returns:
@fields:
-<!-- ##### FUNCTION e_data_book_respond_get_book_view ##### -->
-<para>
-
-</para>
-
-@book:
-@opid:
-@status:
-@book_view:
-
-
<!-- ##### FUNCTION e_data_book_respond_get_contact ##### -->
<para>
</para>
+<!-- ##### FUNCTION e_data_book_factory_activate ##### -->
+<para>
+
+</para>
+
+@factory:
+@iid:
+@Returns:
+
+<!-- ##### FUNCTION e_data_book_factory_dump_active_backends ##### -->
+<para>
+
+</para>
+
+@factory:
+
+<!-- ##### FUNCTION e_data_book_factory_get_n_backends ##### -->
+<para>
+
+</para>
+
+@factory:
+@Returns:
+
+<!-- ##### FUNCTION e_data_book_factory_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION e_data_book_factory_register_backend ##### -->
+<para>
+
+</para>
+
+@factory:
+@backend_factory:
+
+<!-- ##### FUNCTION e_data_book_factory_register_backends ##### -->
+<para>
+
+</para>
+
+@factory:
+
+<!-- ##### FUNCTION e_data_book_get_listener ##### -->
+<para>
+
+</para>
+
+@book:
+@Returns:
+
<!-- ##### MACRO e_data_book_marshal_NONE__NONE ##### -->
<para>
</para>
+<!-- ##### FUNCTION e_data_book_respond_get_book_view ##### -->
+<para>
+
+</para>
+
+@book:
+@opid:
+@status:
+@book_view:
+
+<!-- ##### FUNCTION e_data_book_view_get_listener ##### -->
+<para>
+
+</para>
+
+@book_view:
+@Returns:
+
+<!-- ##### FUNCTION e_data_book_view_get_mutex ##### -->
+<para>
+
+</para>
+
+@book_view:
+@Returns:
+