cleanup documentation. Strip out docs for deprecated methods and leave
only the link-through to the correct methods to use.