Tidy up comments for phpdoc manual