JavaDocs regarding adding scopes are weak
-----------------------------------------

                 Key: CDI-76
                 URL: https://issues.jboss.org/browse/CDI-76
             Project: CDI Specification Issues
          Issue Type: Feature Request
          Components: Javadoc and API
    Affects Versions: 1.1
            Reporter: Lincoln Baxter III


JavaDocs for adding scopes via the eventing API are a bit weak.


   public void addScope(@Observes final BeforeBeanDiscovery event)
   {
      event.addScope(ProjectScoped.class, true, false);
   }

Currently it is not clear that using this method is only required when not 
using the @NormalScoped annotation, and that it will in fact override the 
annotation if present. Additional docs should probably be placed on both sides 
of this relationship, to that affect.

-- 
This message is automatically generated by JIRA.
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        
_______________________________________________
weld-issues mailing list
[email protected]
https://lists.jboss.org/mailman/listinfo/weld-issues

Reply via email to