[dev] Running phpdoc.php is now deprecated (should use phpdoc only)

[ci skip]
Update README to reflect changes in 06b5da1
[dev] Use sprintf for string concatenations
[dev] Update API docblocks

... mostly to remove PHPDocumentor's reported errors