leosutic 2004/07/12 13:59:22
Modified: attributes/api/src/java/org/apache/commons/attributes
Indexed.java
attributes/site/xdocs index.xml changelog.xml
Log:
Improved docs.
Revision Changes Path
1.2 +1 -1
jakarta-commons/attributes/api/src/java/org/apache/commons/attributes/Indexed.java
Index: Indexed.java
===================================================================
RCS file:
/home/cvs/jakarta-commons/attributes/api/src/java/org/apache/commons/attributes/Indexed.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- Indexed.java 6 Jul 2004 20:41:46 -0000 1.1
+++ Indexed.java 12 Jul 2004 20:59:22 -0000 1.2
@@ -24,7 +24,7 @@
*
* <p><b>Note:</b> Indexed attributes that are inherited will not be found
* via an [EMAIL PROTECTED] AttributeIndex}. You will only find the
class/method/field where
- * the attribute is declared via the index.
+ * the attribute is actually declared via the index.
*/
public class Indexed {
}
1.3 +10 -1 jakarta-commons/attributes/site/xdocs/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/attributes/site/xdocs/index.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- index.xml 6 Jul 2004 21:31:52 -0000 1.2
+++ index.xml 12 Jul 2004 20:59:22 -0000 1.3
@@ -30,9 +30,18 @@
Commons Attributes enables Java programmers to use C#/.Net-style
attributes in their code.
- Please see the tutorial and reference thorough explanation of the
features
+ Please see the <a href="tutorial.html">tutorial</a> and <a
href="reference.html">reference</a> for a thorough explanation of the features
and how the project integrates into the development process.
</p>
+ </section>
+
+ <section name="News">
+ <p>Please see the <a href="changelog.html">change log</a> for summaries
of code changes.</p>
+
+ <p><b>2004-07-12</b></p>
+ <ul>
+ <li><p>Attributes promoted out of sandbox to Commons
proper.</p></li>
+ </ul>
</section>
<section name="Download and Installation">
1.3 +35 -3 jakarta-commons/attributes/site/xdocs/changelog.xml
Index: changelog.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/attributes/site/xdocs/changelog.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- changelog.xml 6 Jul 2004 21:31:51 -0000 1.2
+++ changelog.xml 12 Jul 2004 20:59:22 -0000 1.3
@@ -28,14 +28,46 @@
<ul>
<li>
<p>
- Fixed bug in compiler that made it impossible to add
+ Fixed bug in the compiler that made it impossible to add
attributes to a method that took a parameter whose type
- was an inner class.
+ was an inner class. The bug would manifest itself thus:
</p>
+
+ <source><![CDATA[public class Outer {
+ public static class Inner {}
+
+ /**
+ * @@SomeAttribute()
+ */
+ public void method (Inner inner) {}
+}
+
+...
+
+Method method =
+ Outer.class.getMethod(
+ "method",
+ new Class[]{ Outer.Inner.class });
+
+Collection methodAttributes =
+ Attributes.getAttributes (method);
+
+// Prints 0, not 1
+System.out.println (methodAttributes.size ()); ]]></source>
+
+ <p>The bug is fixed in current CVS.</p>
</li>
<li>
<p>
- Bumped version number to 2.1.
+ Bumped version number to 2.1. The rationale for this is as
follows: Many people had told me that
+ a 2.0 release was required in order for them to get on with
their own releases
+ that could only depend on released versions of libraries.
Since I could not move Attributes
+ through the promotion and release process fast enough, and
since the existing code appeared to
+ work for people, I recommended that the jars simply be
renamed from -2.0alpha to -2.0. After all,
+ it was my intent to release the current CVS unchanged as
2.0.
+ Then the bug above popped up and something had to be done.
If I release the fixed version
+ as 2.0, we have two "versions" of 2.0 - the one with the
bug and the one without - clearly
+ an undesirable state. Therefore the version number went
from 2.0alpha to 2.1alpha.
</p>
</li>
</ul>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
