From dccc560e9bbbde409fbd9aed70d129078e863fa0 Mon Sep 17 00:00:00 2001
From: Oliver Gierke <info@olivergierke.de>
Date: Tue, 20 Jan 2009 20:38:25 +0000
Subject: [PATCH] Fixed #52.

git-svn-id: svn+ssh://svn.synyx.de/var/svn/synyx/opensource/hera/trunk@4078 5a64d73e-33d6-4ccc-9058-23f8668ecac9
---
 hera-core/src/doc/core.xml | 33 ++++++++++++++++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)

diff --git a/hera-core/src/doc/core.xml b/hera-core/src/doc/core.xml
index 025bc7d..9f7ceca 100644
--- a/hera-core/src/doc/core.xml
+++ b/hera-core/src/doc/core.xml
@@ -154,6 +154,37 @@ public class HostImpl implements Host {
       installed Spring IDE, you should get code completion on filling the
       class attribute.</para>
     </simplesect>
+
+    <simplesect>
+      <title>Using inner beans</title>
+
+      <note>
+        <para>This feature is only available for version 0.3 and above!</para>
+      </note>
+
+      <para>The listing above features an indirection for the
+      <code>plugin</code> bean definition. Defining the plugin list as top
+      level bean can have advantages: you easily could place all plugin lists
+      in a dedicated configuration file, presenting all application extension
+      points in one single place. Nevertheless you also might choose to define
+      the list directly in the property declaration:</para>
+
+      <example>
+        <title>Using internal bean definition</title>
+
+        <programlisting language="xml">&lt;import resource="classpath*:com/acme/**/plugins.xml" /&gt;
+
+&lt;bean id="host" class="com.acme.HostImpl"&gt;
+  &lt;property name="plugins"&gt;
+    &lt;plugin:list class="org.acme.MyPluginInterface" /&gt;
+  &lt;/property&gt;
+&lt;/bean&gt;</programlisting>
+      </example>
+
+      <para>This way you have a more compact configuration, paying the prica
+      of tangling all extention points though possibly various config
+      files.</para>
+    </simplesect>
   </section>
 
   <section>
@@ -253,4 +284,4 @@ registry.getPluginsFor(ProductType.HARDWARE, new MyException("Damn!");</programl
       </example>
     </simplesect>
   </section>
-</chapter>
+</chapter>
\ No newline at end of file