rest-doclet: javadoc and code cleanup