ACE-4744 javadoc and cleanup

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@119697 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/traitextender/ExtensionFactory.java

@@ -16,11 +16,27 @@
  * You should have received a copy of the GNU Lesser General Public License
  * along with Alfresco. If not, see http://www.gnu.org/licenses/.
  */
+
 package org.alfresco.traitextender;
 
+/**
+ * Creates extension instances for given {@link Trait}s and
+ * {@link ExtensionPoint}s.
+ *
+ * @author Bogdan Horje
+ */
 public interface ExtensionFactory<E>
 {
     <T extends Trait> E createExtension(T trait);
-    
+
+    /**
+     * @param point
+     * @return <code>true</code> if the given extensio-point API elements are
+     *         compatible with the returned extension (i.e. the given extension
+     *         API is assignable form the type of the extension created by this
+     *         factory and the {@link Trait} accepted as aparameter in
+     *         {@link #createExtension(Trait)} is assignable from the type of
+     *         the given trait API).
+     */
     boolean canCreateExtensionFor(ExtensionPoint<?, ?> point);
 }