CDK-717. Fix javadoc warnings, and add missing @since tags.

Deprecate some methods that leak FieldPartitioner, which has since moved
to the SPI.