Added rule to spec requiring injectors to support injecting user-specified subtypes. Clarified and otherwise improved docs on Tck. Added a test case that mixes package private with overridding.

git-svn-id: https://atinject.googlecode.com/svn/trunk@44 3bc8319c-20ab-11de-9edc-3f40a397ab60

1 files changed, 6 insertions, 4 deletions

diff --git a/src/javax/inject/Inject.java b/src/javax/inject/Inject.java
index be85146..fe41467 100644
--- a/src/javax/inject/Inject.java
+++ b/src/javax/inject/Inject.java
@@ -31,9 +31,11 @@ import static java.lang.annotation.ElementType.FIELD;
  * injected first, followed by fields, and then methods. Fields and methods
  * in superclasses are injected before those in subclasses. Ordering of
  * injection among fields and among methods in the same class is not specified.
- * Which values are injected depends upon the injector implementation and its
- * configuration.
- * 
+ * For a given type T and optional qualifier, an injector must
+ * be able to inject a user-specified subclass of T that has an injectable
+ * constructor. Beyond that, which values are injected depend upon the
+ * injector implementation and its configuration.
+ *
  * <p>Injectable constructors are annotated with {@code @Inject} and accept
  * zero or more dependencies as arguments. {@code @Inject} can apply to at most
  * one constructor per class.
@@ -117,7 +119,7 @@ import static java.lang.annotation.ElementType.FIELD;
  *
  * <p>A {@linkplain Qualifier qualifier} may annotate an injectable field
  * or parameter and, combined with the type, identify the implementation to
- * inject. Qualifiers are optional, and when used with {@code @Inject} in 
+ * inject. Qualifiers are optional, and when used with {@code @Inject} in
  * injector-independent classes, no more than one qualifier should annotate a
  * single field or parameter. The qualifiers are bold in the following example:
  *