cross-referencing other specs in 299

[asookazian]

JSR 299 utilizes the Dependency Injection for Java (JSR 330) specification as its foundational API, primarily by using JSR 330 annotations such as @Inject, @Qualifier and @ScopeType.

http://www.theserverside.com/tt/articles/article.tss?l=DependencyInjectioninJavaEE6

There is no reference to JSR 330 in JSR 299.  I did not know that @Inject is part of JSR 330, not JSR 299 and was searching for it here: http://docs.jboss.org/cdi/api/1.0/index.html?overview-summary.html (yes, b/c I live under a rock ;)).

It seems like the spec should cross-reference other EE 6 specs as applicable, no?

It would be helpful to have a glossary and references section in the specs...  or perhaps that's out of scope as defined by the JCP/EG...

[gavin.king]

There is no reference to JSR 330 in JSR 299.

From the final draft of JSR-299, just submitted to the JCP ;-)

1.2.4. Relationship to Dependency Injection for Java
The Dependency Injection for Java specification defines a set of annotations for the declaring injected fields, methods and constructors of a bean. The dependency injection service makes use of these annotations.

I think that makes the relationship clear.

It seems like the spec should cross-reference other EE 6 specs as applicable, no?

The spec says:

An injected field may be declared by annotating the field @javax.inject.Inject.

The package name is your hint as to what spec it belongs to.

It would be helpful to have a glossary and references section in the specs

The spec is a spec. It is not a reference guide.