Clean the slate for the next round of changes.
All known 3rd party backends have been accounted for (ews/mapi/kolab),
so this should cause no disruption.
}
/**
- * e_book_backend_sync_set_backend_property:
- * @backend: an #EBookBackendSync
- * @book: an #EDataBook
- * @cancellable: a #GCancellable for the operation
- * @prop_name: Property name to set.
- * @prop_value: New value of the @prop_name.
- * @error: #GError to set, when something fails
- *
- * Calls the set_backend_property_sync method on the given backend.
- *
- * Returns whether processed this property. Returning FALSE means to pass
- * the call to the EBookBackend parent class, thus neither @error should be
- * set in this case.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: This function always returns %FALSE and sets an
- * %E_DATA_BOOK_STATUS_NOT_SUPPORTED error.
- **/
-gboolean
-e_book_backend_sync_set_backend_property (EBookBackendSync *backend,
- EDataBook *book,
- GCancellable *cancellable,
- const gchar *prop_name,
- const gchar *prop_value,
- GError **error)
-{
- g_set_error_literal (
- error, E_DATA_BOOK_ERROR,
- E_DATA_BOOK_STATUS_NOT_SUPPORTED,
- _("Clients cannot set backend properties"));
-
- return FALSE;
-}
-
-/**
* e_book_backend_sync_remove_contacts:
* @backend: an #EBookBackendSync
* @book: an #EDataBook
GSList **contacts_uids,
GError **error);
-#ifndef EDS_DISABLE_DEPRECATED
-gboolean e_book_backend_sync_set_backend_property
- (EBookBackendSync *backend,
- EDataBook *book,
- GCancellable *cancellable,
- const gchar *prop_name,
- const gchar *prop_value,
- GError **error);
-#endif /* EDS_DISABLE_DEPRECATED */
-
G_END_DECLS
#endif /* E_BOOK_BACKEND_SYNC_H */
}
/**
- * e_book_backend_add_client:
- * @backend: An addressbook backend.
- * @book: the corba object representing the client connection.
- *
- * Adds a client to an addressbook backend.
- *
- * Returns: TRUE on success, FALSE on failure to add the client.
- *
- * Deprecated: 3.10: This function no longer does anything.
- */
-gboolean
-e_book_backend_add_client (EBookBackend *backend,
- EDataBook *book)
-{
- return TRUE;
-}
-
-/**
- * e_book_backend_remove_client:
- * @backend: an #EBookBackend
- * @book: an #EDataBook to remove
- *
- * Removes @book from the list of @backend's clients.
- *
- * Deprecated: 3.10: This function no longer does anything.
- **/
-void
-e_book_backend_remove_client (EBookBackend *backend,
- EDataBook *book)
-{
-}
-
-/**
* e_book_backend_list_views:
* @backend: an #EBookBackend
*
}
/**
- * e_book_backend_foreach_view:
- * @backend: an #EBookBackend
- * @callback: callback to call
- * @user_data: user_data passed into the @callback
- *
- * Calls @callback for each known book view of this @backend.
- * @callback returns %FALSE to stop further processing.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: Use e_book_backend_list_views() instead.
- **/
-void
-e_book_backend_foreach_view (EBookBackend *backend,
- gboolean (*callback) (EDataBookView *view,
- gpointer user_data),
- gpointer user_data)
-{
- GList *list, *link;
-
- g_return_if_fail (E_IS_BOOK_BACKEND (backend));
- g_return_if_fail (callback != NULL);
-
- list = e_book_backend_list_views (backend);
-
- for (link = list; link != NULL; link = g_list_next (link)) {
- if (!callback (E_DATA_BOOK_VIEW (link->data), user_data))
- break;
- }
-
- g_list_free_full (list, (GDestroyNotify) g_object_unref);
-}
-
-/**
* e_book_backend_get_book_backend_property:
* @backend: an #EBookBackend
* @book: an #EDataBook
}
/**
- * e_book_backend_set_backend_property:
- * @backend: an #EBookBackend
- * @book: an #EDataBook
- * @opid: the ID to use for this operation
- * @cancellable: a #GCancellable for the operation
- * @prop_name: property name to change; cannot be NULL
- * @prop_value: value to set to @prop_name; cannot be NULL
- *
- * Calls the set_backend_property method on the given backend.
- * This might be finished with e_data_book_respond_set_backend_property().
- * Default implementation simply returns an 'unsupported' error.
- * The subclass may always call this default implementation for properties
- * which fetching it doesn't overwrite.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: This function no longer does anything.
- **/
-void
-e_book_backend_set_backend_property (EBookBackend *backend,
- EDataBook *book,
- guint32 opid,
- GCancellable *cancellable,
- const gchar *prop_name,
- const gchar *prop_value)
-{
- /* Do nothing. */
-}
-
-/**
* e_book_backend_is_opened:
* @backend: an #EBookBackend
*
}
/**
- * e_book_backend_is_opening:
- * @backend: an #EBookBackend
- *
- * Checks if @backend is processing its opening phase, which
- * includes everything since the e_book_backend_open() call,
- * through authentication, up to e_book_backend_notify_opened().
- * This property is managed automatically and the backend deny
- * every operation except of cancel and authenticate_user while
- * it is being opening.
- *
- * Returns: %FALSE always
- *
- * Deprecated: 3.8: This function is no longer relevant,
- * and always returns %FALSE.
- *
- * Since: 3.2
- **/
-gboolean
-e_book_backend_is_opening (EBookBackend *backend)
-{
- g_return_val_if_fail (E_IS_BOOK_BACKEND (backend), FALSE);
-
- return FALSE;
-}
-
-/**
* e_book_backend_is_readonly:
* @backend: an #EBookBackend
*
}
/**
- * e_book_backend_notify_readonly:
- * @backend: an #EBookBackend
- * @is_readonly: flag indicating readonly status
- *
- * Notifies all backend's clients about the current readonly state.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: Use e_book_backend_set_writable() instead.
- **/
-void
-e_book_backend_notify_readonly (EBookBackend *backend,
- gboolean is_readonly)
-{
- g_return_if_fail (E_IS_BOOK_BACKEND (backend));
-
- e_book_backend_set_writable (backend, !is_readonly);
-}
-
-/**
- * e_book_backend_notify_online:
- * @backend: an #EBookBackend
- * @is_online: flag indicating whether @backend is connected and online
- *
- * Notifies clients of @backend's connection status indicated by @is_online.
- * Meant to be used by backend implementations.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: Use e_backend_set_online() instead.
- **/
-void
-e_book_backend_notify_online (EBookBackend *backend,
- gboolean is_online)
-{
- g_return_if_fail (E_IS_BOOK_BACKEND (backend));
-
- e_backend_set_online (E_BACKEND (backend), is_online);
-}
-
-/**
- * e_book_backend_notify_opened:
- * @backend: an #EBookBackend
- * @error: a #GError corresponding to the error encountered during
- * the opening phase. Use %NULL for success. The @error is freed
- * automatically if not %NULL.
- *
- * Notifies clients that @backend finished its opening phase.
- * See e_book_backend_open() for more information how the opening
- * phase works. Calling this function changes 'opening' property,
- * same as 'opened'. 'opening' is set to %FALSE and the backend
- * is considered 'opened' only if the @error is %NULL.
- *
- * See also: e_book_backend_respond_opened()
- *
- * Note: The @error is freed automatically if not %NULL.
- *
- * Meant to be used by backend implementations.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: Use e_data_book_respond_open() instead.
- **/
-void
-e_book_backend_notify_opened (EBookBackend *backend,
- GError *error)
-{
-}
-
-/**
* e_book_backend_notify_property_changed:
* @backend: an #EBookBackend
* @prop_name: property name, which changed
}
}
-/**
- * e_book_backend_respond_opened:
- * @backend: an #EBookBackend
- * @book: an #EDataBook
- * @opid: an operation ID
- * @error: result error; can be %NULL, if it isn't then it's automatically freed
- *
- * This is a replacement for e_data_book_respond_open() for cases where
- * the finish of 'open' method call also finishes backend opening phase.
- * This function covers calling of both e_book_backend_notify_opened()
- * and e_data_book_respond_open() with the same @error.
- *
- * See e_book_backend_open() for more details how the opening phase works.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: Use e_data_book_respond_open() instead.
- **/
-void
-e_book_backend_respond_opened (EBookBackend *backend,
- EDataBook *book,
- guint32 opid,
- GError *error)
-{
- g_return_if_fail (backend != NULL);
- g_return_if_fail (E_IS_BOOK_BACKEND (backend));
- g_return_if_fail (book != NULL);
- g_return_if_fail (opid != 0);
-
- e_data_book_respond_open (book, opid, error);
-}
void e_book_backend_set_is_removed (EBookBackend *backend,
gboolean is_removed);
-#ifndef EDS_DISABLE_DEPRECATED
-/**
- * CLIENT_BACKEND_PROPERTY_OPENED:
- *
- * FIXME: Document me.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: Clients don't need to care if they're fully opened
- * anymore. This property will always return %TRUE.
- **/
-#define CLIENT_BACKEND_PROPERTY_OPENED "opened"
-
-/**
- * CLIENT_BACKEND_PROPERTY_OPENING:
- *
- * FIXME: Document me.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: Clients don't need to care if they're fully opened
- * anymore. This property will always return %FALSE.
- **/
-#define CLIENT_BACKEND_PROPERTY_OPENING "opening"
-
-/**
- * BOOK_BACKEND_PROPERTY_SUPPORTED_AUTH_METHODS:
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: The property is no longer supported.
- **/
-#define BOOK_BACKEND_PROPERTY_SUPPORTED_AUTH_METHODS "supported-auth-methods"
-
-gboolean e_book_backend_add_client (EBookBackend *backend,
- EDataBook *book);
-void e_book_backend_remove_client (EBookBackend *backend,
- EDataBook *book);
-gboolean e_book_backend_is_opening (EBookBackend *backend);
-void e_book_backend_set_backend_property
- (EBookBackend *backend,
- EDataBook *book,
- guint32 opid,
- GCancellable *cancellable,
- const gchar *prop_name,
- const gchar *prop_value);
-void e_book_backend_foreach_view (EBookBackend *backend,
- gboolean (*callback) (EDataBookView *view,
- gpointer user_data),
- gpointer user_data);
-void e_book_backend_notify_opened (EBookBackend *backend,
- GError *error);
-void e_book_backend_notify_readonly (EBookBackend *backend,
- gboolean is_readonly);
-void e_book_backend_notify_online (EBookBackend *backend,
- gboolean is_online);
-void e_book_backend_respond_opened (EBookBackend *backend,
- EDataBook *book,
- guint32 opid,
- GError *error);
-#endif /* EDS_DISABLE_DEPRECATED */
-
G_END_DECLS
#endif /* E_BOOK_BACKEND_H */
op_unref (data);
}
-/**
- * e_data_book_respond_set_backend_property:
- *
- * FIXME: Document me.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: This function no longer does anything.
- **/
-void
-e_data_book_respond_set_backend_property (EDataBook *book,
- guint32 opid,
- GError *error)
-{
- /* Do nothing. */
-}
-
void
e_data_book_respond_get_contact (EDataBook *book,
guint32 opid,
}
/**
- * e_data_book_report_readonly:
- *
- * FIXME: Document me.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: Use e_book_backend_set_writable() instead.
- **/
-void
-e_data_book_report_readonly (EDataBook *book,
- gboolean readonly)
-{
- EBookBackend *backend;
-
- g_return_if_fail (E_IS_DATA_BOOK (book));
-
- backend = e_data_book_ref_backend (book);
-
- if (backend != NULL) {
- e_book_backend_set_writable (backend, !readonly);
- g_object_unref (backend);
- }
-}
-
-/**
- * e_data_book_report_online:
- *
- * FIXME: Document me.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: Use e_backend_set_online() instead.
- **/
-void
-e_data_book_report_online (EDataBook *book,
- gboolean is_online)
-{
- EBookBackend *backend;
-
- g_return_if_fail (E_IS_DATA_BOOK (book));
-
- backend = e_data_book_ref_backend (book);
-
- if (backend != NULL) {
- e_backend_set_online (E_BACKEND (backend), is_online);
- g_object_unref (backend);
- }
-}
-
-/**
- * e_data_book_report_opened:
- *
- * Reports to associated client that opening phase of the book is finished.
- * error being NULL means successfully, otherwise reports an error which
- * happened during opening phase. By opening phase is meant a process
- * including successfull authentication to the server/storage.
- *
- * Since: 3.2
- *
- * Deprecated: 3.8: This function no longer does anything.
- **/
-void
-e_data_book_report_opened (EDataBook *book,
- const GError *error)
-{
- /* Do nothing. */
-}
-
-/**
* e_data_book_report_backend_property_changed:
*
* FIXME: Document me.
}
/**
- * e_data_book_get_backend:
- * @book: an #EDataBook
- *
- * Returns the #EBookBackend to which incoming remote method invocations
- * are being forwarded.
- *
- * Returns: the #EBookBackend
- *
- * Deprecated: 3.10: Use e_data_book_ref_backend() instead.
- **/
-EBookBackend *
-e_data_book_get_backend (EDataBook *book)
-{
- EBookBackend *backend;
-
- g_return_val_if_fail (E_IS_DATA_BOOK (book), NULL);
-
- backend = e_data_book_ref_backend (book);
-
- /* XXX Drop the EBookBackend reference for backward-compatibility.
- * This is risky. Without a reference, the EBookBackend could
- * be finalized while the caller is still using it. */
- if (backend != NULL)
- g_object_unref (backend);
-
- return backend;
-}
-
-/**
* e_data_book_get_connection:
* @book: an #EDataBook
*
GCancellable *cancellable,
GError **error);
-#ifndef EDS_DISABLE_DEPRECATED
-struct _EBookBackend *
- e_data_book_get_backend (EDataBook *book);
-void e_data_book_respond_set_backend_property
- (EDataBook *book,
- guint32 opid,
- GError *error);
-void e_data_book_report_opened (EDataBook *book,
- const GError *error);
-void e_data_book_report_readonly (EDataBook *book,
- gboolean readonly);
-void e_data_book_report_online (EDataBook *book,
- gboolean is_online);
-#endif /* EDS_DISABLE_DEPRECATED */
-
G_END_DECLS
#endif /* E_DATA_BOOK_H */
LIBEDATACAL_REVISION=0
LIBEDATACAL_AGE=0
-LIBEDATABOOK_CURRENT=17
+LIBEDATABOOK_CURRENT=18
LIBEDATABOOK_REVISION=0
LIBEDATABOOK_AGE=0
e_book_backend_set_is_removed
e_book_backend_get_direct_book
e_book_backend_configure_direct
-<SUBSECTION Deprecated>
-CLIENT_BACKEND_PROPERTY_OPENED
-CLIENT_BACKEND_PROPERTY_OPENING
-BOOK_BACKEND_PROPERTY_SUPPORTED_AUTH_METHODS
-e_book_backend_add_client
-e_book_backend_remove_client
-e_book_backend_is_opening
-e_book_backend_set_backend_property
-e_book_backend_foreach_view
-e_book_backend_notify_opened
-e_book_backend_notify_readonly
-e_book_backend_notify_online
-e_book_backend_respond_opened
<SUBSECTION Standard>
E_BOOK_BACKEND
E_IS_BOOK_BACKEND
e_book_backend_sync_get_contact
e_book_backend_sync_get_contact_list
e_book_backend_sync_get_contact_list_uids
-<SUBSECTION Deprecated>
-e_book_backend_sync_set_backend_property
<SUBSECTION Standard>
E_BOOK_BACKEND_SYNC
E_IS_BOOK_BACKEND_SYNC
e_data_book_get_contacts_uids
e_data_book_get_contacts_uids_finish
e_data_book_get_contacts_uids_sync
-<SUBSECTION Deprecated>
-e_data_book_get_backend
-e_data_book_respond_set_backend_property
-e_data_book_report_opened
-e_data_book_report_readonly
-e_data_book_report_online
<SUBSECTION Standard>
E_DATA_BOOK
E_IS_DATA_BOOK