add final parameters
update JavaDoc : add parameter descriptions
update JavaDoc : add return comment; improve comment; add final stop
remove useless parentheses