adapted phpdoc to @jexp suggestions

Only the comparison table has been left currently