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]

Reply via email to