Java doc was extended for Docklets to explain their role in project

src/main/java/com/puppycrawl/tools/checkstyle/doclets/CheckDocsDoclet.java

@@ -32,6 +32,10 @@ import com.sun.javadoc.Tag;
  * Doclet which is used to extract Anakia input files from the
  * Javadoc of Check implementations, so the Check's docs are
  * autogenerated.
+ * 
+ * Attention: this is incomplete autogenerator of Check's documentation
+ * from the Check's javadoc. It is not used now, and should be removed from 
+ * master branch till completed. 
  *
  * @author lkuehne
  */

src/main/java/com/puppycrawl/tools/checkstyle/doclets/TokenTypesDoclet.java

@@ -30,6 +30,11 @@ import com.sun.javadoc.RootDoc;
 /**
  * Doclet which is used to write property file with short descriptions
  * (first sentences) of TokenTypes' constants.
+ * 
+ * Request: 724871
+ * For ide plugins (like the eclipse plugin) it would be useful to have 
+ * programmatic access to the first sentence of the TokenType constants, 
+ * so they can use them in their configuration gui.
  *
  * @author o_sukhodolsky
  */