You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by le...@apache.org on 2004/07/12 22:59:22 UTC
cvs commit: jakarta-commons/attributes/site/xdocs index.xml changelog.xml
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 {@link 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: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org