CDK-594. Document durability guarantees.
CDK-710: An embedded column mapping should override a copied one.

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

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