[weld-issues] [JBoss JIRA] Created: (CDI-76) JavaDocs regarding adding scopes are weak

[Lincoln Baxter III (JIRA)]

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