WL-2820 Add javadoc to explain parameters