[cdi-dev] [JBoss JIRA] Closed: (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 closed CDI-76.
------------------------

         Assignee: Pete Muir
    Fix Version/s: 1.1 (Confirmed)
                       (was: 1.1 (Proposed))
       Resolution: Done


> JavaDocs regarding adding scopes are weak
> -----------------------------------------
>
>                 Key: CDI-76
>                 URL: https://issues.jboss.org/browse/CDI-76
>             Project: CDI Specification Issues
>          Issue Type: Clarification
>          Components: Javadoc and API, Portable Extensions
>    Affects Versions: 1.0
>            Reporter: Lincoln Baxter III
>            Assignee: Pete Muir
>             Fix For: 1.1 (Confirmed)
>
>
> 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