As we discussed in the maillist, we need to mark the DOC API's as "deprecated" in our initial release,
and point to the replacements in the Simple API in the JavaDoc. That will give users the opportunity to migrate, but we
don't break their code immediately. Then we can remove the DOC API in a future release.