Could you update all the javadoc in this class on rest methods, bearing in mind that in theory it will end up on http://candlepinproject.org/apidoc/ some day.