Tiny comment: AFAIK javadoc return and param documentations should not end in a full stop.