Add @throws fo dock block function signature
@return string was removed by error
Merge pull request #2769 from semalead/throws

Add @throws docblocks to many functions