Please check out our list guidelines though -- every list item should end with a . :http://drupal.org/node/1354#lists
You might also verify that none of those lines exceeds 80 characters, just in case.

Also, we need a blank line between @param and @return.

Thanks for catching and fixing the indentation on the param/returns too!