The javadoc for the above two packages is incomplete. Please provide javadoc for them, addressing in particular the problems outlined in the above post.
Oops, seems that Bugzilla lost the link to the post: http://post-office.corp.redhat.com/archives/ccm-engineering-list/2003-December/msg00034.html