Improvements to phpdoc.

- removed html markup
- removed tabs in comments
- misc improvements

Signed-off-by: Ivan Habunek <ivan.habunek@gmail.com>