commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From leosu...@apache.org
Subject cvs commit: jakarta-commons/attributes/site/xdocs index.xml changelog.xml
Date Mon, 12 Jul 2004 20:59:22 GMT
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


Mime
View raw message