diff --git a/pmd-ant/src/main/java/net/sourceforge/pmd/ant/CPDTask.java b/pmd-ant/src/main/java/net/sourceforge/pmd/ant/CPDTask.java
index fd4de35934..e6a27bbd8a 100644
--- a/pmd-ant/src/main/java/net/sourceforge/pmd/ant/CPDTask.java
+++ b/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>
  *
diff --git a/pmd-ant/src/main/java/net/sourceforge/pmd/ant/PMDTask.java b/pmd-ant/src/main/java/net/sourceforge/pmd/ant/PMDTask.java
index 192a714f6e..f504a858fc 100644
--- a/pmd-ant/src/main/java/net/sourceforge/pmd/ant/PMDTask.java
+++ b/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;
diff --git a/pmd-ant/src/main/java/net/sourceforge/pmd/ant/package-info.java b/pmd-ant/src/main/java/net/sourceforge/pmd/ant/package-info.java
new file mode 100644
index 0000000000..c1aa7288ca
--- /dev/null
+++ b/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;