jstrachan 2002/11/19 08:40:08
Modified: attributes/xdocs navigation.xml index.xml usecases.xml
Log:
Added more links to the JSR175 and XRAI and tidied the documentation some
Revision Changes Path
1.3 +3 -2 jakarta-commons-sandbox/attributes/xdocs/navigation.xml
Index: navigation.xml
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/attributes/xdocs/navigation.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- navigation.xml 19 Nov 2002 16:04:29 -0000 1.2
+++ navigation.xml 19 Nov 2002 16:40:07 -0000 1.3
@@ -5,10 +5,11 @@
<body>
<links>
- <item name="XDoclet" href="http://xdoclet.sourceforge.net/"/>
<item name="Nanning" href="http://nanning.sourceforge.net/"/>
- <item name="Maven" href="http://jakarta.apache.org/turbine/maven/"/>
<item name="QDox" href="http://qdox.sourceforge.net/"/>
+ <item name="XDoclet" href="http://xdoclet.sourceforge.net/"/>
+ <item name="JSR 175" href="http://www.jcp.org/en/jsr/detail?id=175"/>
+ <item name="Maven" href="http://jakarta.apache.org/turbine/maven/"/>
</links>
<menu name="Commons Attributes">
<item name="Usage" href="/usage.html"/>
1.2 +8 -4 jakarta-commons-sandbox/attributes/xdocs/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/attributes/xdocs/index.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- index.xml 14 Nov 2002 08:10:01 -0000 1.1
+++ index.xml 19 Nov 2002 16:40:07 -0000 1.2
@@ -10,16 +10,20 @@
<section name="Commons Attributes">
<p>
- Jakarta Commons Attributes compiles and accesses runtime metadata
attributes.
- Metadata attributes are typically created via doclet tags embedded inside
Java source code.
+ Jakarta Commons Attributes provides an API to runtime metadata attributes.
+ Metadata attributes are typically created via doclet tags embedded inside
Java source code
+ though other mechanisms could be provided such as properties files, XML
descriptors etc.
</p>
<p>
Commons Attributes provides a plugin architecture allowing a variety of
different implementations
to be used at runtime.
</p>
<p>
- The code for this project was originally developed in the
- <a href="http://nanning.sourceforge.net/";>Nanning
Aspects</a>-project.
+ The code for this project is based on code and ideas from the
+ <a href="http://nanning.sourceforge.net/";>Nanning
Aspects</a> and
+ XRAI (from <a
href="http://xdoclet.sourceforge.net/";>XDoclet</a>)
+ projects as well as being influenced by
+ <a href="http://www.jcp.org/en/jsr/detail?id=175";>JSR
175</a> and C# attributes.
</p>
</section>
1.2 +12 -8 jakarta-commons-sandbox/attributes/xdocs/usecases.xml
Index: usecases.xml
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/attributes/xdocs/usecases.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- usecases.xml 19 Nov 2002 16:04:29 -0000 1.1
+++ usecases.xml 19 Nov 2002 16:40:07 -0000 1.2
@@ -3,7 +3,7 @@
<properties>
<author email="[EMAIL PROTECTED]">Jon Tirsen</author>
- <title>Nanning Aspects</title>
+ <title>Jakarta Commons Attributes</title>
</properties>
<body>
@@ -12,24 +12,28 @@
<p>
Some examples on how to use runtime-attributes.
</p>
+ <subsection name="Interceptors in AOP">
+ <p>
+ On what methods should an interceptor run and what an
interceptor should do.
+ Having access to runtime attributes can be extremely useful to
any kind of AOP
+ framework.
+ </p>
+ </subsection>
<subsection name="Object-relational mapper">
<p>
- For example in OJB.
+ For example in OJB, doclet tags in the source code could be used
+ to indicate primary key fields or persistent types.
</p>
</subsection>
<subsection name="Serializing objects into XML">
<p>
- For example in Betwixt.
+ For example in Betwixt, we could use runtime attributes to
customize the
+ behaviour of the Betwixt introspector.
</p>
</subsection>
<subsection name="SOAP encoding">
<p>
For example in Axis.
- </p>
- </subsection>
- <subsection name="Interceptors in AOP">
- <p>
- On what methods should an interceptor run and what an
interceptor should do.
</p>
</subsection>
<subsection name="In a remote-invocation framework">
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
