Improved Javadoc (use @param, @return, etc).

Review: https://reviews.apache.org/r/19859