SOAP-989: some javadoc