donaldp 2002/11/11 23:07:49
Added: info/src/xdocs attributes.xml
Removed: info/src/xdocs tags.xml
Log:
tags.xml --> attributes.xml
Revision Changes Path
1.1 jakarta-avalon-excalibur/info/src/xdocs/attributes.xml
Index: attributes.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<title>Attribute Definitions</title>
<author email="peter at apache.org">Peter Donald</author>
</properties>
<body>
<section name="Introduction">
<p>This document aims to describe the attributes that define
functionality common to multiple containers. These Info attributes
are usually generated from source files that have been decorated
with <a href="doclet.html">Javadoc</a> tags.</p>
</section>
<section name="Tags">
<p>The list of standard metadata attributes includes;</p>
<ul>
<li><a href="#doc">doc</a>: documentation attribute</li>
<li><a href="#feature">feature</a>: attribute for specifying
which container extensions are required or supported.</li>
</ul>
<subsection name="doc">
<table>
<tr><th>Target</th><td>All</td></tr>
<tr><th>Allow Multiple</th><td>false</td></tr>
<tr><th>Inherit</th><td>true</td></tr>
<tr>
<th>Description</th>
<td>The "doc" attribute is used to document artefacts
in the
system. The documentation can either be read from
ResourceBundles or loaded directly from the
Parameters.
Loading descriptions from ResourceBundles is supported
to enable internationalization of descriptions and
display strings.</td>
</tr>
</table>
<h4>Parameters:</h4>
<table>
<tr>
<th>Name</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
<tr>
<td>display-string</td>
<td></td>
<td>false</td>
<td>This specifies string to display on the
User Interface when labeling artefact.</td>
</tr>
<tr>
<td>description</td>
<td></td>
<td>false</td>
<td>This specifies a human readable description of
artefact.</td>
</tr>
<tr>
<td>i18n-bundle</td>
<td>Component Name + "Info"</td>
<td>false</td>
<td>This specifies the location of ResourceBundle to
use when
looking up display string and the description via
keys.</td>
</tr>
<tr>
<td>display-string-key</td>
<td></td>
<td>false</td>
<td>This is an alternative to display-string
parameter. It
defines a key to use when loading display-string from
the
ResourceBundle.</td>
</tr>
<tr>
<td>description-key</td>
<td></td>
<td>false</td>
<td>This is an alternative to description parameter.
It
defines a key to use when loading description from the
ResourceBundle.</td>
</tr>
</table>
<p>The following is an example info fragment that defines a
display string and description by directly storing data in
descriptor.</p>
<source>
<![CDATA[
<attribute name="doc">
<param name="display-name" value="My Magic Component"/>
<param name="description"
value="My Magic Component does Magic."/>
</attribute>
]]></source>
<p>The following is an example info fragment that loads the
display string and description from a resource bundle.</p>
<source>
<![CDATA[
<attribute name="doc">
<param name="display-name-key" value="component.display-name"/>
<param name="description-key" value="component.description"/>
</attribute>
]]></source>
</subsection>
<subsection name="feature">
<table>
<tr><th>Target</th><td>Component,Service</td></tr>
<tr><th>Allow Multiple</th><td>false</td></tr>
<tr><th>Inherit</th><td>true</td></tr>
<tr>
<th>Description</th>
<td>The "feature" attribute is used to define which
container extensions that the component requires
or will use if present. See the <a
href="features.html">
features</a> document for details about container
extensions.</td>
</tr>
</table>
<h4>Parameters:</h4>
<table>
<tr>
<th>Name</th>
<th>Default</th>
<th>Required</th>
<th>Description</th>
</tr>
<tr>
<td>required</td>
<td></td>
<td>false</td>
<td>This whitespace seprated list of features
that this component requires.</td>
</tr>
<tr>
<td>optional</td>
<td></td>
<td>false</td>
<td>This whitespace seprated list of features
that this component will use if present.</td>
</tr>
</table>
<p>The following is an example of a component declaring
that it requires extension sec, tx and will use mx if
present.</p>
<source>
<![CDATA[
<attribute name="feature">
<param name="required" value="sec tx"/>
<param name="optional" value="mx"/>
</attribute>
]]></source>
</subsection>
</section>
</body>
</document>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
