TBH, I whould expect any decent IDE / documentation generator to understand both formats, now or in a near future ([mine](http://www.jetbrains.com/phpstorm/) does already), so I agree that we should not base the standard on this reason alone. But anyway, I'm just following what I've been told earlier, and we should keep this discussion for the standard proposal!