updated javadocs for client