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/Trait.java

@@ -16,9 +16,19 @@
  * 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;
 
+/**
+ * Markup interface.<br>
+ * Subinterfaces represent distiguishing features of {@link Extensible} objects
+ * that are meant to be extended and exposed to the extending code.<br>
+ * Ideally they would be the only means of interaction between extensions and
+ * the extended modules.
+ *
+ * @author Bogdan Horje
+ */
 public interface Trait
 {
-    
+
 }