Improve the javadoc of Client and its "extension"