improved php doc
fixed typo
splitted lines
removed spaces before punct. and minimized cuttering
Merge pull request #48 from ikwattro/phpdoc

improved php doc