[880359] JavaDoc used for Remote API is inconsistent with API
I made another pass at the remote API jdoc, ensuring that all methods have at
least minimal jdoc with the correct @param, @return, @throws, @deprecated and
@since (starting with RHQ 4.5) annotations.