better javadoc description, better example