Merged HEAD (5.1) to 5.1.N (5.1.1)

119697 bhorje: ACE-4744 javadoc and cleanup


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/BRANCHES/DEV/5.1.N/root@120076 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/traitextender/ExtensionBundle.java

@@ -16,14 +16,31 @@
  * 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;
 
-
+/**
+ * Implementors are sets of extension implementations that are registered on
+ * specific {@link ExtensionPoint} for given {@link Extender}s.
+ *
+ * @author Bogdan Horje
+ */
 public interface ExtensionBundle
 {
+    /**
+     * Sets up an registers extension factories with the give {@link Extender}
+     * for all extensions defined by this bundle.
+     * 
+     * @param extender
+     */
     void start(Extender extender);
-    
+
+    /**
+     * Unregisters all defined extensions from the given {@link Extender} .
+     * 
+     * @param extender
+     */
     void stop(Extender extender);
-    
+
     String getId();
 }