fix Eclipse warnings (JavaDoc, returns)