Improve PHPDoc - missing @params, variable types, inconsistencies, typos etc.
Fix private property name and visibility
Fix minor phpdoc typos
Replace java-like types defintion with PHPDoc format
Merge pull request #187 from OndraM/phpdoc-improve

Improve PHPDoc - missing @params, variable types, inconsistencies, typos etc.