From 906f93a130d8d670c4b5213c2c2bf03c47c02337 Mon Sep 17 00:00:00 2001
From: Matthew Barnes <mbarnes@redhat.com>
Date: Sun, 21 Mar 2010 22:22:57 -0400
Subject: Demonstrate extending the EExtension API.

Introduce e_extensible_list_extensions(), which provides extensible
objects access to their own extensions, or a subset of them.

Convert EShellBackend to an abstract EExtension subtype.  EShell will
load its extensions with e_extensible_load_extensions(), and then obtain
a list of EShellBackend extensions as follows:

    shell_backends = e_extensible_list_extensions (
            E_EXTENSIBLE (shell), E_TYPE_SHELL_BACKEND);

Because EShellBackend is abstract, its GType is skipped while traversing
the GType hierarchy to find EShell extensions.
---
 doc/reference/shell/eshell-sections.txt       |  1 +
 doc/reference/shell/tmpl/e-extensible.sgml    | 10 ++++++++++
 doc/reference/shell/tmpl/e-shell-backend.sgml |  5 -----
 doc/reference/shell/tmpl/eshell-unused.sgml   |  6 ++++++
 4 files changed, 17 insertions(+), 5 deletions(-)

(limited to 'doc')

diff --git a/doc/reference/shell/eshell-sections.txt b/doc/reference/shell/eshell-sections.txt
index 776d08d13f..f25d7c7ff3 100644
--- a/doc/reference/shell/eshell-sections.txt
+++ b/doc/reference/shell/eshell-sections.txt
@@ -445,6 +445,7 @@ e_dialog_combo_box_get
 <TITLE>Extensible</TITLE>
 EExtensible
 e_extensible_load_extensions
+e_extensible_list_extensions
 <SUBSECTION Standard>
 E_EXTENSIBLE
 E_IS_EXTENSIBLE
diff --git a/doc/reference/shell/tmpl/e-extensible.sgml b/doc/reference/shell/tmpl/e-extensible.sgml
index de8e8e140c..80bf8f0da4 100644
--- a/doc/reference/shell/tmpl/e-extensible.sgml
+++ b/doc/reference/shell/tmpl/e-extensible.sgml
@@ -31,3 +31,13 @@ Extensible
 @extensible: 
 
 
+<!-- ##### FUNCTION e_extensible_list_extensions ##### -->
+<para>
+
+</para>
+
+@extensible: 
+@extension_type: 
+@Returns: 
+
+
diff --git a/doc/reference/shell/tmpl/e-shell-backend.sgml b/doc/reference/shell/tmpl/e-shell-backend.sgml
index 79456dcfea..76bf06c58e 100644
--- a/doc/reference/shell/tmpl/e-shell-backend.sgml
+++ b/doc/reference/shell/tmpl/e-shell-backend.sgml
@@ -31,11 +31,6 @@ EShellBackend
 @eshellbackend: the object which received the signal.
 @arg1: 
 
-<!-- ##### ARG EShellBackend:shell ##### -->
-<para>
-
-</para>
-
 <!-- ##### FUNCTION e_shell_backend_compare ##### -->
 <para>
 
diff --git a/doc/reference/shell/tmpl/eshell-unused.sgml b/doc/reference/shell/tmpl/eshell-unused.sgml
index 8769407347..ef0cb974c4 100644
--- a/doc/reference/shell/tmpl/eshell-unused.sgml
+++ b/doc/reference/shell/tmpl/eshell-unused.sgml
@@ -509,6 +509,12 @@ intelligent
 </para>
 
 
+<!-- ##### ARG EShellBackend:shell ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ARG EShellContent:filter-action ##### -->
 <para>
 
-- 
cgit