minor update to phpdoc comments

in order to make the style consistent across all functions in the file