diff --git a/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/JavadocMethodCheck.java b/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/JavadocMethodCheck.java index 53d529c76..6f088ba81 100644 --- a/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/JavadocMethodCheck.java +++ b/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/JavadocMethodCheck.java @@ -36,7 +36,32 @@ import java.util.Set; import org.apache.regexp.RE; /** + *

* Checks the Javadoc of a method or constructor. + * By default, does not check for unused throws. + * To check for unused throws, set property checkUnusedThrows to true. + * The scope to verify is specified using the {@link Scope} class and + * defaults to {@link Scope#PRIVATE}. To verify another scope, + * set property scope to one of the {@link Scope#} constants. + *

+ *

+ * An example of how to configure the check is: + *

+ * TODO: re-visit after configuration format settled. + *
+ * <check
+ *    classname="com.puppycrawl.tools.checkstyle.checks.JavadocMethodCheck"/>
+ * 
+ *

An example of how to configure the check to check for unused imports + * and for the {@link Scope#PUBLIC} scope is: + *

+ *
+ * <check
+ *    classname="com.puppycrawl.tools.checkstyle.checks.JavadocMethodCheck">
+ *    <property name="scope" value="public"/>
+ *    <property name="checkUnusedThrows" value="true"/>
+ * </check>
+ * 
* * @author Oliver Burn * @author Rick Giles