Improved ClientService javadoc