Also document correctly - these methods are now public and will fall under the deprecation policy from now on.
