RE: [PEAR-DEV] Re: http://aspn.activestate.com/ASPN/Mail/Message/pear-dev/1800030

Hello Zeev, > Can you explain how it is incompatible? I know that @desc is not in the > PHPDoc standard, but how does this break compatibility? A PHPDoc parser > should still be able to figure it out, and ignore @desc. That said - I > think it would be a good idea to add @desc to the standard, for short one > line descriptions. That's why we added it in the first place. Yes - but if @desc is totally ignored one will have to add the short description twice. In a big project this is a pain. Why don't you add some kind of XML template a user can adopt to his needs? So other comment types could be inserted too. That would solve all problems. > By the way - we've received maybe two requests about this issue (the fact > that the ZDE doesn't read the entire comment, but looks for > @desc). Given > that, saying it was often requested is a bit of an overstatement... I saw this threads: http://www.zend.com/phorum/search.php?num=7&search=phpdoc The userbase comment: The phpdoc requests in the forum never got a reply from Zend. I don't want to broaden that here cause it's OT. But maybe it would be a good idea to add things like a todo, a changelog,... to the ZDE. So people don't get the impression nobody listens to them ;) greetings Daniel Khan