From cefa5edf7f86eacf8c2cdb168ef193f9a8d3a777 Mon Sep 17 00:00:00 2001
From: Matthew Barnes <mbarnes@redhat.com>
Date: Tue, 12 Feb 2013 10:57:19 -0500
Subject: Add EClientCache.

New class to help reduce code duplication and centralize some EClient
handling policies.

Benefits:

- EClient instances can be shared across the entire application.

- Centralized rebroadcasting of "backend-died" and "backend-error"
  signals emitted from cached EClient instances.

- Automatic cache invalidation when backends crash.  The EClient
  is discarded, and a new instance is created on the next request.
---
 doc/reference/libeutil/libeutil-docs.sgml    |  1 +
 doc/reference/libeutil/libeutil-sections.txt | 23 +++++++++++++++++++++++
 doc/reference/libeutil/libeutil.types        |  1 +
 3 files changed, 25 insertions(+)

(limited to 'doc')

diff --git a/doc/reference/libeutil/libeutil-docs.sgml b/doc/reference/libeutil/libeutil-docs.sgml
index 86eeac1b0f..1733a48eea 100644
--- a/doc/reference/libeutil/libeutil-docs.sgml
+++ b/doc/reference/libeutil/libeutil-docs.sgml
@@ -226,6 +226,7 @@
     <xi:include href="xml/e-calendar.xml"/>
     <xi:include href="xml/e-cell-renderer-color.xml"/>
     <xi:include href="xml/e-charset-combo-box.xml"/>
+    <xi:include href="xml/e-client-cache.xml"/>
     <xi:include href="xml/e-contact-store.xml"/>
     <xi:include href="xml/e-dateedit.xml"/>
     <xi:include href="xml/e-destination-store.xml"/>
diff --git a/doc/reference/libeutil/libeutil-sections.txt b/doc/reference/libeutil/libeutil-sections.txt
index 574db12958..6b5449224e 100644
--- a/doc/reference/libeutil/libeutil-sections.txt
+++ b/doc/reference/libeutil/libeutil-sections.txt
@@ -1250,6 +1250,29 @@ e_charset_combo_box_get_type
 ECharsetComboBoxPrivate
 </SECTION>
 
+<SECTION>
+<FILE>e-client-cache</FILE>
+<TITLE>EClientCache</TITLE>
+EClientCache
+e_client_cache_new
+e_client_cache_ref_registry
+e_client_cache_get_client_sync
+e_client_cache_get_client
+e_client_cache_get_client_finish
+e_client_cache_ref_cached_client
+<SUBSECTION Standard>
+E_CLIENT_CACHE
+E_IS_CLIENT_CACHE
+E_TYPE_CLIENT_CACHE
+E_CLIENT_CACHE_CLASS
+E_IS_CLIENT_CACHE_CLASS
+E_CLIENT_CACHE_GET_CLASS
+EClientCacheClass
+e_client_cache_get_type
+<SUBSECTION Private>
+EClientCachePrivate
+</SECTION>
+
 <SECTION>
 <FILE>e-config</FILE>
 <TITLE>EConfig</TITLE>
diff --git a/doc/reference/libeutil/libeutil.types b/doc/reference/libeutil/libeutil.types
index 83e2108bf1..181231561e 100644
--- a/doc/reference/libeutil/libeutil.types
+++ b/doc/reference/libeutil/libeutil.types
@@ -53,6 +53,7 @@ e_cell_toggle_get_type
 e_cell_tree_get_type
 e_cell_vbox_get_type
 e_charset_combo_box_get_type
+e_client_cache_get_type
 e_config_get_type
 e_config_hook_get_type
 e_contact_store_get_type
-- 
cgit