bloritsch 01/10/30 05:59:34
Modified: src/documentation/xdocs/developing framework.xml
Log:
make clarifications
Revision Changes Path
1.3 +12 -5
jakarta-avalon/src/documentation/xdocs/developing/framework.xml
Index: framework.xml
===================================================================
RCS file:
/home/cvs/jakarta-avalon/src/documentation/xdocs/developing/framework.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- framework.xml 2001/10/30 13:55:31 1.2
+++ framework.xml 2001/10/30 13:59:34 1.3
@@ -35,7 +35,7 @@
<section>
<title>Creating the Role's Interface</title>
<para>
- Below you will find the example interface, followed by some best
+ Below you will find an example interface, followed by some best
practices along with their reasoning.
</para>
<programlisting>
@@ -62,9 +62,10 @@
</listitem>
<listitem>
<para>
- Don't extend any other interface. If you think that you should
- extend another interface, it should be another role's work
- interface.
+ Don't let your Role's interface extend any other interface.
If you
+ think that you should extend another interface, it should be
another
+ Role's interface. The only exception to this rule is when the
Role's
+ interface is a specialization of another Role.
</para>
</listitem>
<listitem>
@@ -101,7 +102,7 @@
Using this example, our theoretical Component's name would be
"org.apache.bizserver.docs.DocumentRepository". This is the
name that would be included in your interface's "ROLE"
- attribute.
+ property.
</para>
</listitem>
<listitem>
@@ -253,6 +254,12 @@
<para>
<function>reconfigure</function>
[<classname>Reconfigurable</classname>]
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <function>resume</function>
+ [<classname>Suspendable</classname>]
</para>
</listitem>
</orderedlist>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
