Improvements to DataPoints/FromDatapoints annotation javadoc

Author: pimterry

Diff for: src/main/java/org/junit/experimental/theories/DataPoints.java

@@ -5,9 +5,9 @@
 
 /**
  * <p>
- * Annotating an array-typed field or method with &#064;DataPoints will cause the
- * values in the array (or returned array) to be used as potential parameters
- * for theories in that class, when run with the
+ * Annotating an array-typed field or method with &#064;DataPoints will cause
+ * the values in the array (or returned array) to be used as potential
+ * parameters for theories in that class, when run with the
  * {@link org.junit.experimental.theories.Theories Theories} runner.
  * </p>
  * <p>
@@ -20,6 +20,13 @@
  * {@link org.junit.experimental.theories.FromDataPoints &#064;FromDataPoints}
  * annotation.
  * </p>
+ * <p>
+ * Parameters with no specified source (i.e. without &#064;FromDataPoints or
+ * other {@link org.junit.experimental.theories.ParametersSuppliedBy
+ * &#064;ParameterSuppliedBy} annotations) will use all DataPoints that are
+ * assignable to the parameter type as potential values, including named sets of
+ * DataPoints.
+ * </p>
  * 
  * <pre>
  * &#064;DataPoints

Diff for: src/main/java/org/junit/experimental/theories/FromDataPoints.java

@@ -12,8 +12,13 @@
  * Annotating a parameter of a {@link org.junit.experimental.theories.Theory
  * &#064Theory} method with <code>&#064;FromDataPoints</code> will limit the
  * datapoints considered as potential values for that parameter to just the
- * {@link org.junit.experimental.theories.DataPoints DataPoints} with the 
- * given name. For example:
+ * {@link org.junit.experimental.theories.DataPoints DataPoints} with the given
+ * name. DataPoint names can be given as the value parameter of the
+ * &#064DataPoints annotation.
+ * </p>
+ * <p>
+ * DataPoints without names will not be considered as values for any parameters
+ * annotated with &#064FromDataPoints.
  * </p>
  * 
  * <pre>
@@ -38,7 +43,8 @@
  *     // This will be called with only the values in 'regexStrings' as 
  *     // regex, only the values in 'testStrings' as value, and none 
  *     // of the values in 'unnamed'.
- * }</pre>
+ * }
+ * </pre>
  * 
  * @see org.junit.experimental.theories.Theory
  * @see org.junit.experimental.theories.DataPoint