Huge PHPDoc update.
Merge pull request #748 from Tithugues/phpdoc

Huge PHPDoc update