WL-2798 Fill out the JavaDoc on the API.