diff --git a/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/JavadocVariableCheck.java b/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/JavadocVariableCheck.java
index c0bc5c20c..c9d4e8dda 100644
--- a/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/JavadocVariableCheck.java
+++ b/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/JavadocVariableCheck.java
@@ -26,8 +26,23 @@ import com.puppycrawl.tools.checkstyle.api.ScopeUtils;
 import com.puppycrawl.tools.checkstyle.api.TokenTypes;
 
 /**
- * Checks that a variable has Javadoc comment
- *
+ * Checks that a variable has Javadoc comment.
+ * 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:
+ * </p>
+ * <pre>
+ * &lt;config name="JavadocVariableCheck"/&gt;
+ * </pre>
+ * <p> An example of how to configure the check for the 
+ * {@link Scope#PUBLIC} scope is:
+ *</p>
+ * <pre>
+ * &lt;config name="JavadocVariableCheck"&gt;
+ *    &lt;property name="scope" value="public"/&gt;
+ * &lt;/config&gt;
+ * </pre>
  * @author <a href="mailto:checkstyle@puppycrawl.com">Oliver Burn</a>
  * @version 1.0
  */
diff --git a/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/LineLengthCheck.java b/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/LineLengthCheck.java
index efed7e862..318c58ea6 100644
--- a/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/LineLengthCheck.java
+++ b/src/checkstyle/com/puppycrawl/tools/checkstyle/checks/LineLengthCheck.java
@@ -39,7 +39,37 @@ import org.apache.commons.beanutils.ConversionException;
  * has been dropped as it is a special case of regexp: The user can set
  * the ignorePattern to "^import" and achieve the same effect.
  * </p>
- *
+ * <p>
+ * The default maximum allowable line length is 80 characters. To change the
+ * maximum, set property max.
+ * </p>
+ * <p>
+ * To ignore lines in the check, set property ignorePattern to a regular
+ * expression for the lines to ignore.
+ * </p> 
+ * <p>
+ * An example of how to configure the check is:
+ * </p>
+ * <pre>
+ * &lt;config name="LineLengthCheck"/&gt;
+ * </pre>
+ * <p> An example of how to configure the check to accept lines up to 120
+ * characters long is:
+ *</p>
+ * <pre>
+ * &lt;config name="LineLengthCheck"&gt;
+ *    &lt;property name="max" value="120"/&gt;
+ * &lt;/config&gt;
+ * </pre>
+ * <p> An example of how to configure the check to ignore lines that begin with
+ * &quot; * &quot;, such as within a Javadoc comment, is:
+ * </p>
+ * <pre>
+ * &lt;config name="LineLengthCheck"&gt;
+ *    &lt;property name="ignorePattern" value="^ *\* *[^ ]+$"/&gt;
+ * &lt;/config&gt;
+ * </pre>
+ * 
  * @author Lars Kühne
  */
 public class LineLengthCheck extends Check