ant: doc

pmd-ant/src/main/java/net/sourceforge/pmd/ant/CPDTask.java

@@ -37,7 +37,8 @@ import net.sourceforge.pmd.cpd.renderer.CPDRendererAdapter;
 import net.sourceforge.pmd.cpd.renderer.CPDReportRenderer;
 
 /**
- * CPDTask
+ * CPD Ant task. Setters of this class are interpreted by Ant as properties
+ * settable in the XML. This is therefore published API.
  *
  * <p>Runs the CPD utility via ant. The ant task looks like this:</p>
  *

pmd-ant/src/main/java/net/sourceforge/pmd/ant/PMDTask.java

@@ -1,4 +1,4 @@
-/**
+/*
  * BSD-style license; for more info see http://pmd.sourceforge.net/license.html
  */
 
@@ -18,6 +18,10 @@ import org.apache.tools.ant.types.Reference;
 import net.sourceforge.pmd.RulePriority;
 import net.sourceforge.pmd.ant.internal.PMDTaskImpl;
 
+/**
+ * PMD Ant task. Setters of this class are interpreted by Ant as properties
+ * settable in the XML. This is therefore published API.
+ */
 public class PMDTask extends Task {
 
     private Path classpath;

pmd-ant/src/main/java/net/sourceforge/pmd/ant/package-info.java

@@ -0,0 +1,8 @@
+/*
+ * BSD-style license; for more info see http://pmd.sourceforge.net/license.html
+ */
+
+/**
+ * PMD and CPD integration for the Apache Ant build system.
+ */
+package net.sourceforge.pmd.ant;