X-Git-Url: http://wamblee.org/gitweb/?a=blobdiff_plain;f=support%2Finject%2Fsrc%2Fmain%2Fjava%2Forg%2Fwamblee%2Finject%2Fpackage-info.java;h=dd90c5525938d18351830eec6b80462423bb8a65;hb=6c7d44bbf01b838718c0111af3368c3023ebba19;hp=db9b16d41fad6ffc4501819bc40366e472794b21;hpb=0375d1effda9d7d58d294299849c01bdafdfcdf8;p=utils

diff --git a/support/inject/src/main/java/org/wamblee/inject/package-info.java b/support/inject/src/main/java/org/wamblee/inject/package-info.java
index db9b16d4..dd90c552 100644
--- a/support/inject/src/main/java/org/wamblee/inject/package-info.java
+++ b/support/inject/src/main/java/org/wamblee/inject/package-info.java
@@ -14,26 +14,45 @@
  * limitations under the License.
  */
 /**
- * This package provides a simple general framework for dependency injection. 
+ * This package provides a mini-framework for interfacing to existing dependency injection 
+ * mechanisms. This package does not provide dependency injection, but implementations are expected to 
+ * implement it, usually by delegating to an existing dependency injection framework. The interfaces in this
+ * package provide independence on the actual framework chosen and also allow for better testability. 
+ * 
+ * <h2>Users of the package</h2>
+ * 
+ * <p>Users of this package will typically use: </p>
  * <ul>
- *   <li> <code>Injector</code>: The main interface is the {@link Injector}, by which injection is done.</li>
- *   <li> <code>InjectorFactory</code>: Injectors are created by an implementation of the {@link InjectorFactory} which 
- * creates injectors based on the class.</li>
- *   <li> <code>InjectorFactoryBuilder</code>: To obtain an <code>InjectorFactory</code>, 
- * either create one explicitly, or use {@link InjectorFactoryBuilder} to obtain 
- * one automatically (preferred). The last method uses {@link java.util.ServiceLoader}
- * to find the injectorfactory to use. 
+ *   <li> <code>Injector</code>: This is the interface used to perform injection of dependencies into 
+ *        a given object. </li>
+ *   <li> <code>Injectable</code>: By subclassing this class, the classes automatically get their 
+ *        dependencies injected at construction. </li>
+ *   <li> <code>InjectorBuilder</code>: To get an instance of the  <code>Injector</code>.
  *   </li>
  * </ul>
  * 
- * Note that this package does not contain implementations of the injectors. For that, a separate 
- * package must be used (e.g. for Contexts and Dependency Injection). 
+ * <p>For example, to inject into a given object, use:</p>
+ * <pre>
+ *   Injector injector = InjectorBuilder.getInjector();
+ *   MyPojo pojo = new MyPojo();
+ *   injector.inject(pojo);
+ * </pre>
  * 
- * Implementations of this package must provide an implementation of the {@link InjectorFactory} and
- * must make this implementation discoverable through the {@link java.util.ServiceLoader} mechanism. 
+ * <h2>Implementors of the package</h2>
  * 
+ * <p>Of interest to implementations of this package integrating with dependency injection frameworks are: </p>
+ * <ul>
+ *   <li> <code>Injector</code>: The main interface to be implemented is the {@link Injector}, by which injection is done.</li>
+ *   <li> <code>InjectorFactory</code>: Injectors are created by an implementation of the {@link InjectorFactory} which 
+ * creates injectors based on the class.</li>
+ *   <li> <code>InjectorBuilder</code>: Implementations must make their <code>InjectorFactory</code>
+ *       available through the <code>ServiceLoader</code> mechanism. 
+ *   </li>
+ * </ul>
+ * 
+ * <p>Class overview</p>
+ * <img src="doc-files/Class_Diagram__overview.png"/>
  *
  */
 package org.wamblee.inject;
 
-