Cleanup JavaDoc for services.

The API doc and function signatures describe what the functions do,
let's describe what they do differently from what is described in the
API instead of stating the obvious.