Agreed to un-document and deprecate as of 5.1 and remove in 6.

Mailing list discussion: https://lists.jboss.org/pipermail/hibernate-dev/2015-January/012122.html