add phpdoc headers to a couple of functions
remove stray comma