Fix inconsistencies in javadocs.

These changes were made with consistency with the rest of the project, and with Oracle's Java code conventions in mind:
 - <p> tags are now on their own new line, separating paragraphs, and without empty new lines above and/or below them.
 - Remove unnecessary new lines separating lists and <pre> tags.
 - Remove unnecessary <p> tags for leading paragraphs.
 - Add missing <p> tags.
 - Remove white space immediately following <p> tags.
 - Remove all unnecesary closing </p> tags.

Souyrce for Oracle's Javadoc conventions:
http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html
Merge remote-tracking branch 'upstream/master'

Conflicts:
	src/main/java/org/junit/runner/notification/RunListener.java
Fix more inconsistencies in javadocs.

These changes were made with consistency with the rest of the project, and with Oracle's Java code conventions in mind:
 - <p> tags are now on their own new line, separating paragraphs, and without empty new lines above and/or below them.
Merge pull request #648 from dlam/master

Fix inconsistencies in javadocs.
Changed AllMembersSupplier to call single-valued methods at parameter assignment time, not parameter use time.
Parameters are now matched on value, not defined type, for array and single-valued methods and fields.
Single-datapoint methods are now only called if the return types could be relevant, and theory parameter signatures are compared with types via a prebuilt map rather than reflection.
Further theory optimisation to avoid calling datapoint methods for multi-valued datapoints
Moved instance initialisation for type conversion map into static method
Minor tweak to improve symmetric set up of convertable types in ParameterSignature
Changed single-valued datapoints back to deferred execution
Fixes #449, stopping AllMembersSupplier hiding DataPoint method exceptions

Also includes a rewrite of the Theory nullsAccepted code, since that relied on the previous behaviour of this.
Added javadoc to the DataPoint annotation
Added parameter to annotation to mark exceptions in datapoint methods as ignorable.
DataPoints are now autogenerated for boolean and enum parameters, if no sources are otherwise specified
Failing single-datapoint methods keep their original stack trace
Tiny whitespace fix
Merge pull request #651 from pimterry/datapoint-result-reuse-#638

Fixes for #637, making theory parameters assignment more consistent across sources
Merge pull request #654 from pimterry/autodatapoints-#109

Autogenerated datapoints for boolean and enum parameters
Tweaked DataPoint javadoc to depluralise references to datapoints where
possible

This should add some clarity, since do have both DataPoint and
DataPoints annotations.