Documentation problem with hook_comment

in comment.module line 1184 the api documentation says "validate" can "even modify the comment"
but the $edit is passed by value and not by reference .
the declaration should be comment_validate(&$edit)
so that comment values could be changed in the validation stage before being saved

same issue : http://drupal.org/node/728300