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

[Pete Muir (JIRA)]

     [ https://issues.jboss.org/browse/CDI-76?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Pete Muir updated CDI-76:
-------------------------

    Component/s: Portable Extensions


> 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, Portable Extensions
>    Affects Versions: 1.0
>            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