Updated/Added/Fixed PHPDoc Blocks.

- Fixed typo(s)
- Fixed blocks having wrong format
- Fixed comment blocks
- Added missing types
- Added missing doc blocks (with explaination)
- Added missing @params
- Added reference to other methods (Referenced using @see wherever
required)
- Formated doc blocks (grouping, line breaks, missing vars)
- Removed additional space(s)
Aded line breaks and aligned comments

Updated as per request.
Merge pull request #120 from irazasyed/master

Updated/Added/Fixed PHPDoc Blocks.