PHPDoc normalization

Documentation of core classes are now normalized according to the
standards defined in PHPDoc. More information at http://phpdoc.org/.